YAML構文と検証：よくあるエラーと修正方法

YAMLはDocker、Kubernetes、CI/CDパイプラインなど多くのツールで使用される設定フォーマットです。人間に優しい構文にもかかわらず、間違いやすい部分があります。

YAMLの使用場所

• Docker Compose
• Kubernetesマニフェスト
• GitHub Actions / GitLab CI
• Ansible Playbook
• 設定ファイル

基本構文ルール

インデント

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は2つのブロックスカラースタイルを提供します：

# | (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 vs JSON vs TOML

ベストプラクティス

• CI/CDでYAMLリンターを使用
• エディタで空白文字を表示
• 2スペースインデントを使用
• 誤解される可能性のある文字列を引用
• スキーマバリデーションを使用
• ファイルを小さくモジュラーに

FAQ