YAML → JSON 変換ツール｜リアルタイム

YAMLのマッピング（key: value形式）はJSONのオブジェクト（{"key": "value"}）に対応します。YAMLのシーケンス（- 要素形式）はJSONの配列（["要素"]）に対応します。YAMLの文字列はクォートなしで書けますが、JSONでは必ずダブルクォートが必要です。YAMLのtrue/false/nullはJSONのtrue/false/nullに対応し、数値もそのままJSONの数値として変換されます。この対応関係を理解することで変換結果の予測が立てやすくなります。

YAMLからJSONへの変換が必要になる主な場面として、KubernetesのYAMLマニフェストをkubectl apply --dry-run後にJSON APIで処理する場合や、YAML設定ファイルの内容をREST APIのリクエストボディとして使用する場合、GitHub ActionsのワークフローYAMLをプログラムで解析・生成するためにJSONに変換する場合などがあります。インフラとアプリケーションのデータ連携でYAML→JSON変換は頻繁に発生します。

YAMLにはJSONにない高度な機能があります。アンカー（&）とエイリアス（*）は変換時にデータとして展開され、JSON内での参照は保持されません。複数ドキュメント（---区切り）が含まれるYAMLファイルは最初のドキュメントのみが変換される場合があります。型タグ（!!str・!!intなど）は変換時に型情報として使われますが、JSONには型タグの概念がないため出力には含まれません。

Kubernetesではkubectl get pod -o yaml（YAML出力）とkubectl get pod -o json（JSON出力）のどちらも使えますが、kubectl patchコマンドへの引数やKubernetes APIへの直接リクエストにはJSON形式が求められる場合があります。また、Kubernetes設定のプログラム処理・jqコマンドによる絞り込みではJSON形式が便利です。このツールでYAMLをJSONに変換してjqと組み合わせることで、複雑なKubernetes設定の解析が効率化されます。

GitHub ActionsのワークフローはYAML形式で定義しますが、ワークフローの設定を動的に生成・更新するスクリプトではJSON形式でデータを扱うことが多くあります。GitHub REST APIはJSON形式でやり取りするため、ワークフロー設定をYAMLからJSONに変換することでAPIとの連携が容易になります。CI/CDの設定をコード管理（IaC）する際も、YAML設定とJSON APIの橋渡しにこのツールが活用できます。

AnsibleのプレイブックはYAML形式で記述しますが、Ansible AWX（Tower）のREST APIはJSON形式でジョブテンプレート・インベントリーのデータを受け付けます。YAMLで書いたインベントリやvar設定をJSONに変換してAnsible AWX APIに渡す用途にこのツールが活用できます。また、TerraformのJSON設定形式（.tf.json）はHCL（.tf）のYAML的な構文をJSONで記述する形式で、HCLに慣れていないチームメンバーとの設定共有にも役立ちます。