YAML 문법 & 검증: 일반적인 오류와 해결 방법

YAML은 Docker, Kubernetes, CI/CD 파이프라인 등 수많은 도구의 설정 포맷입니다. 사람에게 친화적인 문법이지만 놀라울 정도로 실수하기 쉽습니다.

YAML 사용처

• Docker Compose
• Kubernetes 매니페스트
• GitHub Actions / GitLab CI
• Ansible 플레이북
• 설정 파일

기본 문법 규칙

들여쓰기

YAML은 공백(탭 불가)으로 들여쓰기합니다:

# ✅ Correct (2-space indentation)
server:
  host: localhost
  port: 8080
  database:
    name: myapp
    pool: 10

# ❌ Wrong (tab characters or inconsistent spaces)
server:
	host: localhost    # Tab character - INVALID!
   port: 8080        # 3 spaces - inconsistent!

키-값 쌍

콜론과 공백으로 구분합니다:

# ✅ Correct
name: John Doe
port: 8080

# ❌ Wrong - missing space after colon
name:John Doe

여러 줄 문자열

YAML은 두 가지 블록 스칼라 스타일을 제공합니다:

# | (literal block) - preserves newlines
description: |
  This is line one.
  This is line two.
  Each newline is preserved.

# > (folded block) - folds newlines to spaces
description: >
  This is a long paragraph
  that will be joined into
  a single line.

데이터 타입

"노르웨이 문제"

YAML 1.1에서 `NO`는 boolean `false`로 해석됩니다. 따옴표를 사용하세요:

# ❌ YAML 1.1 interprets these as booleans!
country: NO        # → false
answer: yes        # → true
switch: on         # → true

# ✅ Fix: quote the values
country: "NO"      # → string "NO"
answer: "yes"      # → string "yes"
switch: "on"       # → string "on"

컬렉션

# List (sequence)
fruits:
  - apple
  - banana
  - cherry

# Nested map
database:
  host: localhost
  port: 5432
  credentials:
    user: admin
    password: secret

# Inline / Flow style
fruits: [apple, banana, cherry]
point: {x: 10, y: 20}

흔한 10가지 YAML 오류

YAML vs JSON vs TOML

모범 사례

• CI/CD에서 YAML 린터 사용
• 편집기에서 공백 문자 표시
• 2칸 들여쓰기 사용
• 오해될 수 있는 문자열에 따옴표
• 스키마 검증 사용
• 파일을 작고 모듈화

FAQ