YAMLをJSONに変換!

YAMLを入力するとJSONに変換します!yml, Kubernetes, docker-compose 対応。
YAML
結果
 

YAMLをJSONに変換!

YAML(yml)ドキュメントを JSON に変換して、インデントに隠れた構造と、各値が実際にどの型として解析されたかを確認できます。アンカーとエイリアスは実際の値に展開され、--- で区切られた複数のドキュメントは配列にまとめられます。

スペースが1つ足りないせいで値が別の親にぶら下がる、version: 1.10 がいつの間にか数値の 1.1 になる、といった YAML の典型的なミスを見つけるのに特に便利です。

使い方

  1. YAML 欄に docker-compose.yml、Kubernetes のマニフェスト、ワークフローのファイルを貼り付けるか、ファイルをドロップします。
  2. 構文エラーは行番号と列番号付きで結果に表示されます。まずその箇所のインデントを確認してください。
  3. 結果 の JSON を見て、各値が文字列・数値・真偽値のどれになったかを確かめ、必要ならコピーします。

例

入力 (YAML)
name: ci
on:
  push:
    branches: [main]
defaults: &node
  runs-on: ubuntu-latest
  timeout-minutes: 10
jobs:
  test: *node
出力 (JSON)
{
  "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 の位置に展開されています。

対応機能

  • YAML 1.2 の core スキーマで解析します。yes、on、off は文字列のままで、真偽値になるのは true/True/false だけです。
  • ~ と空の値は null に、16進数の 0x1F と8進数の 0o17 は数値になります。
  • &anchors と *aliases は参照先の値に解決します。
  • リテラルの | と折り畳みの > のブロックスカラーは、YAML の改行ルールを適用した文字列になります。
  • --- で区切った複数のドキュメントは JSON の配列になり、ドキュメントが1つならその値自体を出力します。
  • 同じマッピングに2回現れるキーはエラーとして報告します。

利用シーン

Kubernetes マニフェストのインデントを確認する

containers の下の env のインデントが1段浅いと、黙って別のフィールドにくっつき、apply するまで気づけません。JSON なら、波括弧でどのオブジェクトに属しているかが正確にわかります。

設定をコードから使う

YAML パーサーを追加するほどでもないスクリプトやフロントエンドのバンドルなら、設定を一度変換して import config from './config.json' として使えます。

OpenAPI 仕様を調べる

YAML で書かれた OpenAPI ドキュメントも、変換すれば JSONPath や jq で問い合わせやすくなり、特定のパスのスキーマを取り出すといった作業が楽になります。

注意点と制限

  • マージキー(<<: *defaults)は適用されます。アンカーを付けたマッピングのキーがコピーされ、<< の隣に書いたキーがそれを上書きします。YAML 1.2 専用のパーサーは << を普通のキーとして残すので、そうしたツールとは結果が異なることがあります。
  • 2024-01-01 のような日付や時刻は、Date の値にはならず文字列のままです。
  • .inf と .nan は JSON で表現できないので null になります。
  • コメントは JSON に持ち込めないため削除されます。
  • PyYAML(YAML 1.1)は on や yes を true と読むので、Python での結果とは異なる場合があります。

よくある質問

GitHub Actions の 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 で使う複数リソースのファイルからはリソースの配列が得られます。