2026-05-19 · 読了目安 1 分
設定ファイル向け YAML と JSON
ランタイムが読む形式を選ぶ; 両側を制御できる場合のみ変換する。
YAMLJSON設定
重要ポイント
- YAML のコメントとアンカーは盲目的な JSON 往復を生き残れない。
- main にコミットする前に変換後の JSON を検証する。
形式の選択
コメント付き手編集設定には YAML; 厳密パーサーと生成成果物には JSON。
リポジトリ境界（人間 YAML → 機械 JSON）で変換し、毎回のローカル保存ではない。
安全な変換ワークフロー
YAML ⇄ JSON に貼り付け、diff を確認し、結果で JSON Validator を実行。
JSON が OpenAPI ドキュメントなら OpenAPI Validator を続ける。
よくある質問
変換で数値や真偽値は変わりますか？
はい — 引用符と型が重要。出力を diff し、CI でアプリのパーサーを実行。
Kubernetes は YAML — JSON を保存すべき？
人間向けに git で YAML を保持; 下流ツールが要求する場合のみ JSON を生成。