YAML(yml)ドキュメントを JSON に変換して、インデントに隠れた構造と、各値が実際にどの型として解析されたかを確認できます。アンカーとエイリアスは実際の値に展開され、--- で区切られた複数のドキュメントは配列にまとめられます。
スペースが1つ足りないせいで値が別の親にぶら下がる、version: 1.10 がいつの間にか数値の 1.1 になる、といった YAML の典型的なミスを見つけるのに特に便利です。
YAML 欄に docker-compose.yml、Kubernetes のマニフェスト、ワークフローのファイルを貼り付けるか、ファイルをドロップします。結果 の JSON を見て、各値が文字列・数値・真偽値のどれになったかを確かめ、必要ならコピーします。name: ci
on:
push:
branches: [main]
defaults: &node
runs-on: ubuntu-latest
timeout-minutes: 10
jobs:
test: *node
{
"name": "ci",
"on": {
"push": {
"branches": [
"main"
]
}
},
"defaults": {
"runs-on": "ubuntu-latest",
"timeout-minutes": 10
},
"jobs": {
"test": {
"runs-on": "ubuntu-latest",
"timeout-minutes": 10
}
}
}このツールは YAML 1.2 のルールで解析するので、GitHub Actions の on: キーは文字列のキー "on" のままです。&node アンカーで定義したブロックは、*node の位置に展開されています。
yes、on、off は文字列のままで、真偽値になるのは true/True/false だけです。~ と空の値は null に、16進数の 0x1F と8進数の 0o17 は数値になります。&anchors と *aliases は参照先の値に解決します。| と折り畳みの > のブロックスカラーは、YAML の改行ルールを適用した文字列になります。--- で区切った複数のドキュメントは JSON の配列になり、ドキュメントが1つならその値自体を出力します。containers の下の env のインデントが1段浅いと、黙って別のフィールドにくっつき、apply するまで気づけません。JSON なら、波括弧でどのオブジェクトに属しているかが正確にわかります。
YAML パーサーを追加するほどでもないスクリプトやフロントエンドのバンドルなら、設定を一度変換して import config from './config.json' として使えます。
YAML で書かれた OpenAPI ドキュメントも、変換すれば JSONPath や jq で問い合わせやすくなり、特定のパスのスキーマを取り出すといった作業が楽になります。
<<: *defaults)は適用されます。アンカーを付けたマッピングのキーがコピーされ、<< の隣に書いたキーがそれを上書きします。YAML 1.2 専用のパーサーは << を普通のキーとして残すので、そうしたツールとは結果が異なることがあります。2024-01-01 のような日付や時刻は、Date の値にはならず文字列のままです。.inf と .nan は JSON で表現できないので null になります。on や yes を true と読むので、Python での結果とは異なる場合があります。on が true ではなく "on" と表示されるのはなぜですか?YAML 1.2 で真偽値になるのは true と false だけなので、on は普通の文字列で、GitHub Actions もそのキーをそう読みます。Python の PyYAML は 1.1 に従って True のキーにしてしまうので、スクリプトからワークフローを解析するときは注意してください。
version: 1.10 が 1.1 になってしまいます。引用符のない 1.10 は YAML では数値で、1.10 は 1.1 と等しくなります。バージョンの文字列として残したい場合は、元の YAML で "1.10" と引用符で囲んでください。
--- で区切られた各ドキュメントが順に配列の要素になるので、kubectl apply -f で使う複数リソースのファイルからはリソースの配列が得られます。