JSON をインデントベースの YAML に変換します。波括弧やほとんどの引用符が消えるので、設定ファイルとして手でメンテナンスしやすくなり、キーの順序は元の JSON とまったく同じに保たれます。
kubectl get -o json で取得したリソースをマニフェストに移すときや、API から受け取った設定を docker-compose.yml、application.yml、GitHub Actions のワークフローに貼り付けるときに役立ちます。
JSON 欄に JSON を貼り付けます。構文が正しくないと結果に JSON parsing failed と表示されるので、必要なら先に JSON バリデーターにかけてください。結果 で YAML を確認します。インデントはスペース2つです。{
"services": {
"web": {
"image": "nginx:1.27",
"ports": ["8080:80"],
"environment": { "FEATURE_FLAG": "on", "GREETING": "hello\nworld" }
}
}
}services:
web:
image: nginx:1.27
ports:
- 8080:80
environment:
FEATURE_FLAG: "on"
GREETING: |-
hello
world
文字列の "on" は引用符が残っています。裸の on と書くと、YAML 1.1 のパーサーは真偽値の true と読んでしまうからです。GREETING は改行を含むので、各行を書かれたとおりに見せる |- ブロックで出力されています。
yes、no、on、off、y、n、~、null のような文字列や、"0777"、"1.0"、"2024-01-01" のように別の型に見えるものには引用符を付け、PyYAML(1.1)でも最新の 1.2 のパーサーでも同じ値として読まれるようにします。22:22 のような文字列にも引用符を付け、docker-compose のポートマッピングでよく知られたバグを避けます。|- のリテラルブロックになります。[] と {} のまま残ります。クラスターから JSON で取り出した Deployment や ConfigMap を変換し、status や metadata.uid などのフィールドを削除すれば、Git に入れられるマニフェストになります。
設定サーバーやドキュメントから JSON で受け取ったプロパティのブロックが YAML の階層になるので、spring.datasource.url のようなキーを手でインデントする必要がありません。
&)、エイリアス(*)は生成しません。JSON で繰り返されるオブジェクトは YAML でも繰り返されます。--- で区切った複数リソースのファイルにするには、リソースごとに変換して自分でつなげてください。引用符を付けるのは、裸のままだと別の型として読まれてしまう値だけです。nginx:1.27 はどちらにしても文字列ですが、on、010、22:22 はパーサーによっては真偽値や数値になるので、引用符が付きます。
構造としてはそのまま有効です。ただし kubectl get -o json の出力には status、resourceVersion、managedFields のようなサーバーが埋めるフィールドが含まれているので、適用前に削除するのがよいでしょう。
オプションはなく、Kubernetes、docker-compose、GitHub Actions のドキュメント全体で使われている慣例どおり、スペース2つに固定されています。