YAML デバッグワークフロー

kubectl、Actions、Compose がファイルを拒否したら、ランダム編集ではなく繰り返し可能なワークフローを使います。

ステップ 1: 正確なファイルバイトを取得

失敗ファイルを git からコピー—スクリーンショットではなく、スマートクォートが変わった Slack スニペットでもありません。不可視文字が誤った修正を招きます。

ステップ 2: 変更せず validate

まず validate のみモードを実行します。現在の テキストに対するパーサーフィードバックが欲しく、元のミスを隠す auto-format 版ではありません。

ステップ 3: 行と列へジャンプ

「line 18, column 3」のようなパーサーメッセージは特定のインデントやトークンに対応します。ファイル全体を reformat する前にその箇所を直します。

ステップ 4: format して diff を確認

構文が有効になったら、チームのインデント標準で format します。diff を読みます—format は意味を変えず、空白と必要ならキー順のみ変えるべきです。

ステップ 5: 行き詰まったら JSON 往復

YAML が JSON ツールから生成されている場合、YAML → JSON → YAML で構造の驚きを露わにします。JSON がおかしければ、インデント議論の前にデータモデルを直します。

ステップ 6: 元のツールを再実行

kubectl dry-run で apply、ワークフロー再実行、docker compose config—ドメイン validator はパーサーが見られない問題（未知フィールド、誤った API バージョン）を捕捉します。

セキュリティの注意

本番秘密を共有フォーマッタリンクに貼り付けないでください。協力時は redact したサンプルを使います。