개발자 데뷔!

[단축키][MarkDown] 마크다운(.mk) 파일의 정체와 사용법

물꼮이 — Wed, 3 Jun 2026 21:26:10 +0900

마크다운은 작성속도가 쉽고 빠르며, 다양한 플랫폼과 호환성이 좋은 문서작성 시스템 입니다.
특히 코드 삽입, 표 작성이 빨라 문서작성계의 코드 역할을 합니다.
숙달하면 생산성 향상에 가장 효과적이라고 생각됩니다.

“읽기 쉬운 일반 텍스트를 작성하면,
이를 HTML 등의 문서 형태로 변환해주는
경량 마크업 언어”

1. 마크다운(Markdown)이란?

확장자: .md / .markdown

실체: 그냥 텍스트 파일

즉:

메모장 가능
git diff 가능
용량 작음
UTF-8 저장 가능

핵심철학

사람이 읽기 쉬워야 함
작성 속도가 빨라야 함
복잡한 태그를 최소화
텍스트 기반이어야 함

변환 과정과 원리

Markdown 작성 -> Parser 해석 -> HTML 생성 -> 브라우저 렌더링

입력 문법(Syntax) + Parser + Renderer

Parser역할

텍스트 읽기 -> 규칙 매칭 -> 문서 구조 생성(AST) -> HTML 출력

EX_)

Markdown 작성 시,

# 제목

안녕하세요

- 사과
- 바나나

HTML 아래와 같이 변환됨

<h1>제목</h1>

<p>안녕하세요</p>

<ul>
<li>사과</li>
<li>바나나</li>
</ul>

2. 마크다운 특징

HTML작성은 너무 길고 작성 속도가 느리다.
플랫폼에 독립적이다.
텍스트라 가볍다
코드 관리 가능하고, Git 에서 변경 추적이 쉽다.
그렇다고 프로그래밍언어는 아니다.
플랫폼마다 플랫폼 Renderer가 달라 각자 지원 문법이 다르다.

장점

용량	매우 작음
가독성	높음
버전관리	좋음
호환성	높음

3. 마크다운 핵심 문법 정리

제목

# H1

## H2

### H3

굵게

**bold**

기울임

*italic*

리스트

- item

1. first

2. second

체크박스

- [ ] todo

- [x] done

인용문

> hello

코드

inline:

`printf`

block:

```cpp
int a=0;
```

표

|A|B|

|--|--|

|1|2|

4. 자주 쓰는 단축키

여느 단축키와 동일하다.

굵게	CMD+B
기울임	CMD+I
링크	CMD+K
실행취소	CMD+Z
복사	CMD+C
붙여넣기	CMD+V
찾기	CMD+F
전체선택	CMD+A

코드블럭 빨리 쓰기

``` + Enter

```cpp

여러 줄 동시에 수정 (멀티커서)

Option + Click

줄 이동

Option ↑↓

5. 블로그 작성용 실전 팁

제목 구조 먼저 짜기

# 제목

## 개념

## 원리

## 사용법

## 예제

## 정리

마크다운 사용처

기술 블로그 작성	Git/GitHub 문서	회사문서	노트정리	협업도구
티스토리 Velog Dev Blog 개인 기술 블로그	README.md 설치 문서 API 문서 사용법	설계 문서 Release Note API 정의 개발 명세	Obsidian Notion Logseq	이슈 작성 코드 리뷰 PR 설명 Wiki

[단축키][Tistory] 티스토리 블로그 글 작성시 유용한 단축키

물꼮이 — Sat, 30 May 2026 20:10:25 +0900

티스토리 블로그 작성 시, “손 안 떼고 글 쓰는 루틴”을 익히면 글 쓰는 속도가 정말 빨라집니다.
특히 맥에서 더욱 마우스 덜 쓰는 게 생산성 차이가 크기 때문에 많이 연습하시기 바랍니다.

티스토리 블로그 에디터 단축키는 기본적으로
Markdown + 웹 에디터 단축키 + 브라우저 단축키가 섞여 있습니다.

⌘ Command = window의 Ctrl

티스토리 글쓰기 에디터 3가지 모드

저도 이 글 쓰면서 처음 알았는데요.. 티스토리 글쓰기 에디터에 3가지 모드가 있어, 사용자 편의에 따라 모드를 변경해 사용할 수 있습니다.

'글쓰기' 클릭 시 진입하면 보이는 우측 상단의 '기본모드'를 클릭하면, 아래 그림과 같이 드롭다운으로 기본모드, 마크다운, HTML 세가지 모드가 표시됩니다.

티스토리 에디터 3가지 모드

마크다운이 익숙하신 분들은 => 마크다운 작성법에 대해 설명한 제 글을 참고하시고,

마크다운이 표 작성, 인용문 작성 등 익숙해지면 기본모드보다 훨 씬 빠르지만,
적응할 때까지 시간이 꽤 필요하기 때문에 익숙치 않은 분들을 위해

이 포스팅에서는 기본모드에 대해서 다루겠습니다!

✍️ 티스토리 글쓰기 필수 단축키 (Mac)

1. 텍스트 편집 단축키

이 텍스트 편집 단축키는 대부분 Notion및 여타 글쓰기 도구와 매우 유사합니다.

단축키가 잘 외워지지 않는다면,
상단 도구 모음에 각 효과와 매칭되는 단축키가 아래와 같이 알아보기 쉬운 아이콘으로 표시되어 있으니,

참고하면서 연습하시면 됩니다.

티스토리 에디터 상단의 글씨 편집 기능 아이콘

⌘ Command

굵게	⌘ + B
기울임	⌘ + I
밑줄	⌘ + U
취소선	Option + Shift + 5
링크 삽입	⌘ + K
복사	⌘ + C
붙여넣기	⌘ + V
잘라내기	⌘ + X
실행 취소	⌘ + Z
다시 실행	⌘ + Shift + Z
전체 선택	⌘ + A

2. 글 이동 / 선택

키보드에서 손 안 떼고 글 작성하는 데에 가장 중요한 단축키라고 생각됩니다.

기존 마우스 드래그를 통해 글을 선택하셨다면, 아래 단축키를 열심히 외우시기 바랍니다.

⌘ Command

한 글자 이동	← →
단어 단위 이동	Option + ←/→
줄 시작 이동	⌘ + ←
줄 끝 이동	⌘ + →
문서 시작	⌘ + ↑
문서 끝	⌘ + ↓
단어 선택	Option + Shift + ←/→
줄 선택	Shift + ⌘ + ←/→

3. 빠른 줄 편집

위 글 이동/선택과 매우 유사합니다.

이 규칙을 외우면 될 것 같습니다.

단어 관련 = Option 키 조합
줄 단위 = ⌘ Command 키 조합

⌘ Command

줄 끝으로 가서 엔터	⌘ + → → Enter
줄 삭제	⌘ + Backspace
단어 삭제	Option + Backspace
뒤 문자 삭제	fn + Delete
줄 아래 새 줄	Enter
줄바꿈만 (문단 안깨짐)	Shift + Enter

[단축키][Notion] 노션 기본 키보드 단축키

물꼮이 — Mon, 25 May 2026 16:55:04 +0900

노션은 메모, 문서 작성, 위키, 프로젝트 관리, 데이터베이스를 한 곳에서 할 수 있는 올인원 워크스페이스입니다!
온라인 자동저장 기능, 무한한 유연성, 다양한 템플릿 제공 기능 때문에
회의록, 면접준비, 개인 일정 관리 등의 모든 문서작업에 다양하게 쓰입니다.

단축키 표기(맥 기준)
Cmd(⌘),
Option(⌥),
Control(⌃),
Shift(⇧)

노션 주요 특징

블록(Block) 기반 편집
- 문단, 체크박스, 이미지, 표, 데이터베이스 같은 요소를 “블록” 단위로 추가하고 이동할 수 있습니다.
페이지와 링크 구조
- 페이지 안에 하위 페이지를 만들고, 서로 링크하며 지식 구조를 만들기 쉽습니다.
데이터베이스(표)로 확장
- 단순 표가 아니라 필터, 정렬, 뷰(보드, 캘린더 등)로 업무 흐름을 구성할 수 있습니다.
협업에 강함
- 댓글(Discussion), 멘션(@), 공유, 권한 설정으로 팀 협업에 적합합니다.

자주 쓰는 단축키 (macOS)

1) 기본 편집(문서 작성)

기능 단축키 (macOS) 메모

굵게	Cmd + B
기울임	Cmd + I
밑줄	Cmd + U
취소선	Cmd + Shift + S
링크 추가(선택 텍스트)	Cmd + K

2) 블록 생성/이동(노션 핵심)

기능 단축키 (macOS) 메모

새 블록 만들기	Enter
같은 블록에서 줄 바꿈	Shift + Enter
블록 위/아래로 이동	Cmd + Shift + ↑/↓
블록 복제(duplicate)	Cmd + D
블록 삭제	Delete 또는 비어있는 블록에서 Backspace

3) “/” 명령어를 단축키처럼 쓰기

노션에서 가장 빠른 입력은 단축키 + 슬래시(/) 메뉴 조합입니다.

체크박스(To-do)	/todo 또는 /체크박스
제목(Heading)	/h1, /h2, /h3
인용문	/quote
코드 블록	/code
표(또는 데이터베이스)	/table

4) 탐색/검색(페이지 이동)

빠른 검색(Quick Find)	Cmd + P
페이지 내 찾기	Cmd + F

5) 멘션/협업

기능 방법 메모

사람/페이지/날짜 멘션	@ 입력 후 선택
댓글(Discussion) 달기	선택 영역에서 코멘트 기능 사용

“실전 사용 예시”

- 회의록: /h2로 안건 만들기 → /todo로 액션 아이템 체크리스트 만들기
- 개인 지식관리: Cmd + K로 링크 정리 → Cmd + P로 빠르게 페이지 이동
- 프로젝트 관리: 블록 이동(Cmd + Shift + ↑/↓)으로 문서 구조 빠르게 재정렬

[AI][개발][Claude Code 클로드 코드] 클로드 코드 설치하기

물꼮이 — Sun, 24 May 2026 18:35:20 +0900

아래 내용은 Mac OS 환경 설정 기준으로 작성되었습니다.

클로드 코드 설치 전 필요한 항목

# Node.js #npm

Node.js 설치

https://nodejs.org/ko/download

위 링크로 접속해 macOS Installer.pkg 다운로드

Node.js 다운로드 화면

설치 확인

node --version			// 버전 출력 확인 시 성공
npm --version			// 버전 출력 확인 시 성공

클로드 코드 설치& 실행

npm install -g @anthropic-ai/claude-code
claude				// 클로드 코드 실행 명령어

[단축키][Mac] 맥북 Mac OS 기본 키보드 단축키

물꼮이 — Sun, 24 May 2026 18:12:29 +0900

Window 에서 Mac으로 넘어오면 기존에 잘 사용하던 단축키에서 첫번째 고비를 맞게된다.
익숙해질 때 까지 연습하자.

⌘ Command,
⌥ Option,
⌃ Control,
⇧ Shift

개발자가 가장 많이쓰는 단축키 모음

순위	단축키	기능	개발자 사용 예
---:	---	---	---
1	⌘ C / ⌘ V	복사 / 붙여넣기	코드/로그/명령어 복붙
2	⌘ Z / ⇧⌘ Z	실행 취소 / 다시 실행	코드 편집 되돌리기
3	⌘ S	저장	파일 저장(에디터/문서)
4	⌘ F	찾기	코드/에러 메시지 검색
5	⌘ Space	Spotlight	앱 실행(iTerm/VS Code), 파일/설정 찾기
6	⌘ Tab	앱 전환	IDE ↔ 터미널 ↔ 브라우저 빠른 전환
7	⌘ W	창/탭 닫기	브라우저 탭, 파일 탭 닫기
8	⌥⌘ Esc	강제 종료	앱 프리징(IDE/브라우저) 즉시 종료
9	⇧⌘ 4	영역 스크린샷	버그 제보/문서용 캡처
10	Space	Quick Look	빌드 산출물/이미지/텍스트 파일 빠르게 미리보기(Finder)

1) 편집 / 기본 동작

복사	⌘ C
붙여넣기	⌘ V
잘라내기	⌘ X
실행 취소(Undo)	⌘ Z
다시 실행(Redo)	⇧ ⌘ Z
모두 선택	⌘ A
찾기	⌘ F
다음 찾기	⌘ G
이전 찾기	⇧ ⌘ G
저장	⌘ S
다른 이름으로 저장(일부 앱)	⇧ ⌘ S
인쇄	⌘ P

2) 앱 / 창 관리

앱 종료	⌘ Q
현재 창 닫기	⌘ W
새 창(지원 앱)	⌘ N
새 탭(지원 앱)	⌘ T
앱 전환	⌘ Tab
앱 전환(역방향)	⇧ ⌘ Tab
강제 종료 창 열기	⌥ ⌘ Esc
현재 앱 숨기기	⌘ H
다른 앱 숨기기	⌥ ⌘ H
최소화	⌘ M
모든 창 최소화(지원 시)	⌥ ⌘ M
다음 창으로 이동(같은 앱)	⌘ `
이전 창으로 이동(같은 앱)	⇧ ⌘ `

3) 스크린샷 / 화면 녹화

전체 화면 캡처	⇧ ⌘ 3
영역 선택 캡처	⇧ ⌘ 4
창(윈도우) 캡처	⇧ ⌘ 4 후 Space
스크린샷/녹화 도구 열기(옵션/화면녹화 포함)	⇧ ⌘ 5
Touch Bar 캡처(있는 경우)	⇧ ⌘ 6

4) Spotlight / 시스템

Spotlight 검색	⌘ Space
이모지/기호 입력창	⌃ ⌘ Space
빠른 보기(Quick Look)	Space
강제 재시동(응답 없을 때)	⌃ ⌘ Power(또는 Touch ID)
화면 잠금	⌃ ⌘ Q

5) 브라우저 / 문서 탐색(일반적)

페이지 새로고침	⌘ R
강력 새로고침(캐시 무시, 브라우저에 따라)	⇧ ⌘ R
새 탭	⌘ T
탭 닫기	⌘ W
다음 탭	⌃ Tab (또는 ⌥ ⌘ → 앱/설정에 따라)
이전 탭	⇧ ⌃ Tab (또는 ⌥ ⌘ ←)
링크 새 탭에서 열기(대부분 브라우저)	⌘ 클릭
페이지 내 검색	⌘ F

6) Finder(파일 관리)

새 Finder 윈도우	⌘ N
새 폴더	⇧ ⌘ N
정보 가져오기	⌘ I
이름 변경	Return
휴지통으로 이동	⌘ Delete
휴지통 비우기	⇧ ⌘ Delete
숨김 파일 표시/숨김 토글	⇧ ⌘ .
검색(현재 Finder)	⌘ F

7) 텍스트 이동/선택(글 편집 시 매우 유용)

줄 시작으로 이동	⌘ ←
줄 끝으로 이동	⌘ →
문단(문서) 맨 위/맨 아래	⌘ ↑ / ⌘ ↓
한 단어씩 이동	⌥ ← / ⌥ →
줄 시작/끝까지 선택	⇧ ⌘ ← / ⇧ ⌘ →
단어 단위 선택 확장	⇧ ⌥ ← / ⇧ ⌥ →
앞으로 한 단어 삭제	⌥ Delete
앞으로 한 글자 삭제	Delete
뒤로 한 글자 삭제(Forward delete)	fn Delete

[Linux] 리눅스 커널 기본

물꼮이 — Sun, 5 May 2024 22:08:56 +0900

Linux의 중요한 세가지 개념

# 파일시스템
# 프로세스
# 스트림

운영체제 (OS : Operating System)

: HW, App을 총괄하는 소프트웨어

- 리눅스는 유닉스 계열 중 하나의 운영체제.

- 리눅스 배포판 : RedHat, CentOS, Ubuntu, SUSE, Gentoo 등이 있음

* 리눅스 배포판 : 리눅스 커널을 기반으로 한 소프트웨어 배포판

- 리눅스에 포함되는 소프트웨어 패키지는 다음과 같다.

소프트웨어 패키지	예시
셸	bash, ash, csh, tcsh, zsh, pdksh, ...
util-linux	init, getty, login, reset, fdisk, ...
procps	ps, pstree, top, ...
GNU coreutils	ls, cat, mkdir, rmdir, cut, chmod, ...
GNU grep, findutils, diffutils	grep, find, diff, ...
GNU libc	...
기본 라이브러리	ncurses, zlib, GDBM, ...
개발 환경	gcc, binutils, make, bison, flex, 헤더파일 ...
X Window System	...
GNOME or KDE	...

* util-linux : 리눅스 운영체제의 표준 패키지

* procps : 리눅스 시스템의 프로세스 관리 유틸리티 모음

* Gnome : GNU 프로젝트의 일환으로 개발된 데스크톱 환경 (= Linux GUI)

커널 (kernel)

: 하나의 프로그램으로 구성되어, 컴퓨터를 구성하는 모든 HW, SW 관리

- '리눅스' 단어 자체는 커널 만을 의미한다.

- 리눅스 루트경로 / 에는 vmlinuz, vmlinux, vmlinuz-X.X.X 파일 확인 가능 => 리눅스 커널의 본체

디바이스 드라이버 (Device Driver)

: 특정 HW 디바이스를 직접 조작하는 SW

디바이스 : CPU, 메모리, HDD, SSD, DVD-ROM, CD-ROM, 네트워크 어댑터, clock 등..

* HDD : Hard Disk Drive

* SSD : Solid State Drive

시스템 콜 (System call)

: 커널(system)에게 의뢰(call). 커널에 디바이스 조작을 의뢰하는 콜.

- 보통 '시스템콜 호출코드'는 '일반함수' 사용과 비슷하다.

- 리눅스에 포함되는 시스템 콜은 다음과 같다.

시스템콜 명령어

open

read

write

fork

exec

stat

unlink

라이브러리 함수(Library function)

- printf(), exit(), strlen(), strcpy() 등의 함수

- link 하여 사용

- 라이브러리 함수는 내부적으로 시스템 콜을 사용 할수도 / 안할수도 있다.

- 시스템콜을 -> 라이브러리 함수로 구현하거나, 그 역의 경우도 생기기 때문에 의식적으로 구분하지 않기도 함. (둘다 있는 경우도 多 )

- 하지만 '시스템콜' / '라이브러리 함수'의 차이를 알면 리눅스 이해하기 쉬움

ex_ printf() 라이브러리 함수는 내부에서 write() 시스템 콜 사용
ex_ strlen() 라이브러리 함수는 시스템콜 사용하지 않음

C표준 라이브러리 (libc : C standard library)

- c표준 라이브러리 libc 의 위치

ubuntu : /lib 디렉터리에 위치
CentOS : /lib64 디렉터리에 위치

- libc.so.6 : libc의 중심파일

심볼릭 링크 되어있음
아래 ls -l 명령어로 심볼링 링크 추적 가능
- ex_ libc-2.23.so 등의 파일과 연결되어 있는 것을 확인할 수 있다.

ls -l /lib/x86_64-linux-gnu/libc.so.6

* 심볼링 링크 (Symbolic Link) : 파일 시스템에 사용되는 특별한 유형의 링크. 다른 (파일or 디렉토리)를 가리키는 (파일or디렉토리)

API (Application Programming Interface)

: 인터페이스.

- 커널에서의 API 는 시스템 콜을 가리킴.

- 하지만 경우에 따라, 설정파일, 명령어 도 API 가 될 수 있음

- 시스템콜 뿐만 아니라 더 많은 것을 포괄하는 개념

Linux 빌드시스템

물꼮이 — Fri, 3 May 2024 14:14:21 +0900

컴파일러 설치

C언어 컴파일러 : gcc(GNU Compiler Collection)

gcc 설치 버전 확인

// gcc 컴파일러 설치/버전 확인
gcc -dumpversion

설치 시 )

[Linux] gcc 버전 확인 명령어

빌드 기본 패키지 설치

// 개발 패키지 설치 _ gcc, libc6-dev 등...
sudo apt-get install build-essential

소스코드 작성 & 빌드

아래와 같은 과정으로 소스코드 리눅스 시스템 내에서 빌드할 수 있다.

(vi) 코드작성 -> (gcc) 빌드 -> (./) 실행

// 소스코드 파일 생성&작성
vi hello.c
// .. 소스코드 내용 작성 후 저장(c파일) ...

// 소스코드 빌드 
gcc hello.c
// 생성된 실행파일명 확인
ls 
// 실행파일 실행
./a.out

위에서 실행되는 hello.c 소스코드는 아래와 같이 작성했다.

#include <stdio.h>

int main(int argc, char *argv[]){
        printf("Hello, World!\n");
        return 0;
}

[Linux] gcc 빌드결과

빌드 옵션

옵션	기능	사용	예시
-o	만들어질 실행파일 이름 지정	gcc -o {실행파일명} {소스코드파일명}	gcc -o hello hello.c
-Wall	(버그) 빌드 시 경고 옵션 전부 활성화 - 인자수 / 타입 오기입 경고	gcc -Wall {소스코드파일명}	gcc -Wall hello.c
-O1 -O2 -O3	(버그) 빌드 시 최적화(optimization) - 뒤에 붙은 숫자 클수록 강력한 최적화 - O3 는 컴파일러에 의한 버그 가능성 多 - O2 를 일반적으로 사용	gcc -O1 {소스코드파일명}	gcc -O1 hello.c

* 최적화 : 실행속도를 가능한 범위 내에서 향상시켜줌

* 실행파일 : .out 등 확장자 없이도 실행파일명으로 지정 가능

[Linux] gcc 옵션 -o

버그 & 디버거

: 리눅스에서 개발할 때 gdb(GNU Debugger) 가 많이 사용됨

세그멘테이션 폴트 (Segmentation fault)
- NULL 포인터를 참조하는 경우
- 배열의 범위를 넘어서 접근하는 경우
- 리눅스에서 해당에러가 발생하면 강제종료

실행인자

// echo 명령어 +  x y z는 실행 인자
echo x y z

...
int main(int argc, char *argv[]) {
...

argc : 실행인자의 개수
argv : 실행인자의 내용을 문자열 배열 형태로 담고 있는 것. (char 포인터 타입)

다음과 같이 실행명령어를 치면 아래와 같이 입력된다.

{실행명령어} {실행인자1} {실행인자2} ...

./hello x y z

argv[0] -> ./hello\0

argv[1] -> x\0

argv[2] -> y\0

argv[3] -> z\0

argv[0] 에는 프로그램 실행 시 입력한 명령어 자체가 들어간다.

그 이후 argv[1] ~ 에는 실행인자가 들어간다.

즉, argc 는 항상 1 이상이다.

아래와 같이 실행인자를 모두 출력하는 args.c 파일 작성 후 실행해보자.

#include <stdio.h>
#include <stdlib.h>

int main(int argc, char *argv[]){
        int i;
        printf("argc=%d\n", argc);
        for(int i=0; i<argc; i++){
                printf("argv[%d]=%s\n", i, argv[i]);
        }
        exit(0);
}

[Linux] 실행명령어와 실행인자

큰 따옴표(" ")로 묶으면 감싼 부분을 하나의 실행 인자로 묶어준다. => 셸(shell)의 기능

[Linux] 실행명령어와 실행인자 ""

와일드 카드(glob 패턴 -ex_ '*', '?')을 사용하면, 파일 이름의 집합을 표현 할 수 있다.
- 파일 이름의 집합은 셸(shell)이 개별인자로 바꾸어 준다.

[Linux] 실행명령어와 실행인자 와일드카드 사용

함수 정보 얻기

리눅스에서 c 프로그래밍을 할 때, 셸 명령어로 함수에 대한 정보를 간단히 얻을 수 있다.

크게 man 명령어, info 명령어가 있다.

man 명령어

: 특정 함수의 스펙을 조사할 때 쓰는 명령어

man {알아볼 함수명}
man {참고할 페이지 number} {알아볼 함수명}

사용예시)

man strlen
man printf
man 3 printf

man 페이지는 내용에 따라 여러 섹션으로 구분되어 있다.

- 섹션 1부터 차례로 조사해, 가장 먼저 발견한 섹션 페이지를 표시해준다.

- 여러 섹션에 동일한 이름의 페이지가 존재할 수도 있다.

섹션	분류
1	실행 가능한 프로그램&셸 명령어
2	시스템 콜
3	라이브러리 함수
4	특별한 파일(디바이스 파일) 등
5	파일 포맷
6	게임
7	규격 등
8	시스템 관리용 명령어

strlen()함수의 정보를 알아보면 아래와 같이 해당 함수에 대한 설명이 나온다

사용법 및, 포함된 헤더파일명, 타입도 상세히 나와 유용하게 쓸 수 있다.

strlen의 경우 페이지 섹션3 에서 찾아 STRLEN(3)과 같이 표시된다.

[Linux] man 명령어 사용결과

info 명령어

: GNU가 만든 문서시스템

GNU libc 는 man보다 info를 먼저 참조해야 한다.

Docker 로그분석 - (도커 체인)트러블슈팅: 갑자기 잘되던 docker 연결이 안된다!!

물꼮이 — Wed, 3 Apr 2024 07:00:20 +0900

아래 두 서비스를, 서버 ip상 docker 컨테이너로 올려 실행해야 한다.
* 데이터베이스 : MySQL
* 백엔드 : SpringBoot
위 두 백엔드-데이터베이스 포트를 연결하는데 문제가 많이 발생했다.
기존에 잘 연결되던 서비스가, 도커 컴포즈화 하는 과정을 거쳐 잘 안되기도 했다.
트러블 슈팅 목적으로 확인할 수 있는 것들을 정리해봤다.

도커 트러블 슈팅

도커 컨테이너 로그 확인

docker logs {컨테이너 이름}

포트 접근 권한 확인

sudo ufo status

방화벽 설정 규칙 확인

sudo iptables -L

아래처럼 DROP인 경우, 권한이 없어 요청을 DROP 한다. (에러의 원인이 될 수 있음)

방화벽 설정 규칙

도커 체인 확인 (환장한다…)

iptables -t nat -L -n

열려있는 포트 확인

netstat -tuln

Docker배포2 - (Docker-Compose.yml 작성)

물꼮이 — Tue, 2 Apr 2024 08:42:40 +0900

도커 컴포즈 파일은,
서버 상에서 필요한 모든 도커 컨테이너를 실행시키는 명령어를 묶어서
한번에 실행시킬 수 있도록 만든, 스크립트 파일의 역할을 한다.
터미널 명령어를 어떻게 Docker Compose 파일로 정리할지 알아보자.

실행시켜야 할 도커 컨테이너는 아래 두개이다.

데이터베이스 (MySQL)
백엔드 (SpringBoot)

위 두 컨테이너를 실행시키기 위해, 나는 서버 터미널에서 아래 두 명령어를 실행하고, 잘 동작함을 확인했었다.

# DataBase 컨테이너 실행
docker run -d --name {실행할 이미지이름}:{태그버전} -e MYSQL_ROOT_PASSWORD={DB접속 비밀번호} -e MYSQL_DATABASE={DB명} -p 3306:3306 {실행될 컨테이너이름}:{태그버전}

# Backend 컨테이너 실행
sudo docker container run --detach --publish 80:8080 {도커허브id}/{실행할 이미지이름}:{태그버전}

(Database 세팅 옵션의 db명이나, 비밀번호는, 기존 로컬 백엔드에서 db설정했던 부분 ex_ application.properties 참고하여 작성하면 된다.)

컨테이너의 포트 연결은, {외부에서 접속할 포트}:{컨테이너 내부의 포트} 라고 생각해주면 된다.

위 명령어 두개를 docker-compose.yml 로 작성하면 아래와 같다.

파일명은 반드시. docker-compose.yml 을 유지해야하고,

docker-compose.yml 파일은 서버에 원하는 디렉토리를 만들어 위치시키면 된다. (나의 경우: ~ )

기본 틀은 공식 제공하는 파일을 사용하자... (정신건강에 이롭다)

version: "3"

services:
  swipe-jeju-db:
    image: mysql:latest
    container_name: swipe-jeju-db
    networks:
      - {커스텀 네트워크 이름}
    environment:
      MYSQL_ROOT_HOST: "%"
      MYSQL_ROOT_PASSWORD: {db접속 비밀번호}
      MYSQL_DATABASE: {db명}
    ports:
      - "3306:3306"
    command: ["--character-set-server=utf8mb4","--collation-server=utf8mb4_unicode_ci"]

  swipe-jeju-back:
    image: {도커허브id}/{실행할 이미지이름}:{태그버전}
    container_name: swipe-jeju-back
    networks:
      - {커스텀 네트워크 이름}
    restart: on-failure
    ports:
      - "80:8080"
    environment:
      DB_HOST: {db 도커컨테이너명}
      DB_PORT: {db 도커컨테이너 실행포트}
      SPRING_DATASOURCE_URL: jdbc:mysql://{db 도커컨테이너명}:{db 도커컨테이너 실행포트}/{db명}?useSSL=false&allowPublicKeyRetrieval=true
      SPRING_DATASOURCE_USERNAME: "{db 유저명}"
      SPRING_DATASOURcE_PASSWORD: "{db접속 비밀번호}"
    depends_on:
      - {db 도커컨테이너명}

networks:
  {커스텀 네트워크 이름}:
      driver: bridge

networks
- 커스텀 네트워크를 설정해, 두 컨테이너가 지정한 커스텀 네트워크에서 동작하도록 한다.
- 위처럼 {커스텀 네트워크 이름}을 지정해도, 실제 실행될 때는, root-{커스텀 네트워크 이름}등으로, 도커 기본 규칙에 따라 prefix가 붙어 실행된다.
- 도커 network의. default 값은 bridge이다.
백엔드 컨테이너에, 백엔드의. application.properties 에서 지정한 내용을 다시 써준다.
- 위같이 할 경우, application.properties의 내용보다도 docker-compose.yml 에 작성된 내용의 우선순위가 더 높아 우선 적용되고, appllication.properties의 내용은 무시된다.
- 도커에서 백엔드-db 연결에 에러가 나는 경우가 많으므로 위처럼 대놓고 명시해주는게 마음이 편하다... (로컬에서 잘 연결되던 서비스 연결이 안되서 트러블 슈팅에 꽤 걸렸다)

옵션 상세설명은 향후 포스팅으로 이어서 하겠다..

Docker 배포1 (도커 이미지 생성 & 도커 허브 업로드)

물꼮이 — Tue, 2 Apr 2024 08:20:24 +0900

배포를 위해 아래 두 서비스를 도커 컨테이너로 올려야 한다.
* 백엔드 : SpringBoot
* DB : MySQL
배포를 위한 서버를 할당 받았다고 가정, (AWS ec2 등)
현재 ssh로 위 배포 서버에 접속한 상태다.

DataBase 도커 업로드

1. 도커 이미지를 올리기

도커 허브의 공식 mysql 이미지를 다운받는 방법이다.

(기존 로컬에서 잘 작동하던 mysql 을 그대로 쓰고 싶다면,

docker 파일을 통해 이미지화 하고, 이를 도커허브에 업로드해 서버로 다시 내려받는 방법도 있다. => 백엔드 설명)

docker pull mysql:{mysql버전}
#docker pull mysql:8.0.33

2. 필요 데이터 생성

나는 서비스에서 jpa 사용 + ddl-auto =update 설정으로, 첫실행 시 필요 데이터베이스와 테이블이 자동생성된다.

필요에 따라 서버의 mysql콘솔에 접속하거나 / workbench 를 통해 접속하는 방법으로 더미데이터를 입력해준다.

BackEnd 도커 업로드

아래 과정은 로컬에서 동작하는 spring boot(gradle)을 도커 이미지화 해, 서버ip로 이동시키기 위한 방법이다.

아래 과정은 로컬에서 진행해주면 된다

1. SNAPSHOT.jar 생성

처음에, 프로젝트의 어떤 경로에서도 snapshot.jar 파일을 찾을 수 없어서 헤맸다. 당연하다. 만든 적이 없다.

내가 snapshot을 만들겠다고 빌드를 해줘야 한다. 빌드 명령어는 빌드도구 (gradle, maven)에 따라 다를 수 있다.

프로젝트 경로 접속 후,
아래 명령어 실행

./gradlew build

{프로젝트root}/build/libs 경로에 아래와 같이 스냅샷 생성된 것을 확인 할 수 있다.
백엔드 코드의 변경 사항이 있을 때마다, 위 SNAPSHOT 빌드를 다시 해야 한다.

SNAPSHOT.jar 생성위치

2. 도커파일 작성

프로젝트의 루트디렉토리에 dockerfile을 위치시킨다
파일명은 Dockerfile 그대로 한다.
- 아래와 같이 작성했으니 참고
- JAR_FILE 에는 SNAPSHOT.jar 파일의 경로를 써준다.

Dockerfile 위치

# DOCKER FILE
FROM openjdk:17-jdk
LABEL maintainer="{관리자 이메일}"
ARG JAR_FILE=build/libs/SwipingJeju-0.0.1-SNAPSHOT.jar
ADD ${JAR_FILE} docker-springboot.jar
ENTRYPOINT ["java","-jar","/docker-springboot.jar"]

3. 도커 이미지 빌드

아래와 같이 빌드하면, 작성한 dockerfile 기준으로 도커이미지가 생성된다.

docker build -t {빌드할 도커이미지 이름} .

트러블 슈팅)

* 그러나 나의 경우, 로컬 / 서버 상 이미지 플랫폼 형식이 일치 하지 않아, 로컬에서 빌드한 이미지를 서버에서 사용하지 못하는 에러를 만났다.. 로컬 - MacOS 를 사용중인데, 찾아보니 맥 사용자에게 이같은 경우가 매우 많다고 한다.

로컬 (Image Platform) : linux/arm64/v8
서버 (Host Platform) : linux/amd64/v3

다행히 도커에서 위처럼 아키텍처가 다른 경우에 대응하기 위해 '멀티 아키텍처 빌드'를 간단한 명령어로 가능하게 했다. 이외에 다른 방법도 있지만 향후 다른 포스팅으로 따로 정리해 소개하겠다. 사용한 명령어는 아래와 같다. 아래 --push 옵션으로 도커허브에 업로드 까지 한번에 된다.

docker buildx build --platform linux/amd64 -t {도커허브id}/{빌드할 이미지 이름}:{버전태그} --push .

4. 도커 허브 업로드

Docker Desktop 앱을 다운로드 받아 로그인 되어있는 상태라면, 아래 명령어로 바로 로그인된다.

docker login

git 과 비슷한 아래 docker 명령어로 푸시한다. (이 때, 허브에 올라가는 이미지들은 항상 본인의 id/ 를 붙여야 한다)

docker push {도커허브id}/{도커이미지 이름}:{버전태그}

도커 허브에는 로컬에 있는 이미지와, 허브에 올라간 이미지 모두를 확인할 수 있는데,

아래와 같이 상단의 Hub 탭에서 방금 올린 이미지를 확인할 수 있다 . (마지막 올린 시간 표시)

도커 허브에 한 번 올린 이미지는 삭제할 수 없으니 주의하자.

도커 허브 이미지 목록

5. 도커 이미지 다운로드

이제 실제 서비스 배포될 '배포 서버 ip'로 접속해, 도커 허브에 올려둔 이미지를 다운로드 받으면 된다.

마찬가지로 명령어는 git 과 비슷하다.

docker pull {도커허브id}/{도커이미지 이름}:{버전태그}

docker images 명령어로 다운받아진 이미지를 확인할 수 있다.

위 과정을 끝내면, 백엔드 배포에 필요한 DB, Backend 두 도커 이미지가 서버에 준비됐다.