レッスン 4

よくある YAML の誤り

設定を壊すインデント、タブ、型、貼り付けエラー。

YAML の失敗は、よくある原因が分かれば謎ではなくなります。

タブ vs スペース

多くのスタイルガイドはインデントにタブを禁止します。タブとスペースの混在は一部エディタでは揃って見えますが、パーサーを壊します。YAML ではスペース挿入にエディタを設定してください。

キーを 1 スペース左に寄せると、親が変わります。Kubernetes では containers が spec の外に移ったように頭の中では見えても、パーサーにはそう見えません。

YAML は yes、no、on、off、12345 のような値を型ルールで解釈します。文字列のつもりなら引用してください。

version: "01.10"
enabled: "yes"

[ や { で始めて閉じ忘れると、ファイル深部でエラーになります。CI ジェネレータが半分有効なフロー YAML を出力することがあります—貼り付け後に validate してください。

--- で区切られたファイルは有効なマルチドキュメント YAML ですが、一部ツールは単一ドキュメントを期待します。ドキュメント境界を理解せず 2 つのマニフェストをマージすると混乱するエラーになります。

JSON → YAML → 手動編集 → JSON は、中間ツールが値を並べ替え正規化すると、重複キーや型変更を招くことがあります。各変換ステップ後に diff してください。