JSON から Kubernetes YAML へ

kubectl の JSON 出力や API オブジェクトを、レビューしてそのまま apply できる整ったマニフェストに変換します。

出力オプション

JSON入力

空

YAML出力

YAML の出力がここに表示されます

すべてブラウザ内で動作し、データはアップロードされません。スパムやボットを防ぐため、公正利用の制限(入力 1 件あたり 5 MB、変換回数のレート制限)があります。

URL から読み込む

ファイルはブラウザから直接取得されるため、サーバー側でクロスオリジンリクエストが許可されている必要があります。

キーボードショートカット

Ctrl / ⌘ + Enter 今すぐ変換
Ctrl / ⌘ + S 出力をダウンロード
Alt + Shift + C 出力をコピー
Alt + Shift + F 入力の JSON を修復して整形
Alt + Shift + S 変換方向を入れ替え
Alt + Shift + T コード、ツリー、マップ表示を切り替える
Ctrl / ⌘ + Z 元に戻す(整形、修復、クリアも対象)
Esc 全画面表示を終了
エディターの文字サイズ

kubectl の JSON から整ったマニフェストへ

エクスポートしたオブジェクトには、クラスターが自分で設定する status や管理用のフィールドが含まれています。先にそれらを取り除いてから変換すれば、結果はどこにでも apply できます。

bash
# Export a live object as JSON and strip the fields the cluster manages
kubectl get deployment web -o json \
  | jq 'del(.status, .metadata.uid, .metadata.resourceVersion,
            .metadata.creationTimestamp, .metadata.generation,
            .metadata.managedFields)' > web.json

上に web.json を貼り付けるか、アップロードしてください。

環境変数の値は文字列のまま

API サーバーは文字列でない env の値を拒否します。真偽値、数値、バージョンに見える値は自動的に引用符で囲まれます。

JSON
{
  "env": [
    {
      "name": "FEATURE_FLAG",
      "value": "true"
    },
    {
      "name": "PORT",
      "value": "8080"
    },
    {
      "name": "REGION",
      "value": "no"
    },
    {
      "name": "API_VERSION",
      "value": "1.20"
    }
  ]
}
YAML
env:
  - name: FEATURE_FLAG
    value: 'true'
  - name: PORT
    value: '8080'
  - name: REGION
    value: 'no'
  - name: API_VERSION
    value: '1.20'

YAML 1.1 対応をオフにすると、YAML 1.1 パーサーが誤読する値を確認できます。

1 ドキュメントに 1 オブジェクト

kubectl の List の items 配列を貼り付けて「マルチドキュメント」をオンにすると、オブジェクトの間に --- が入った 1 つのファイルになります。

items (JSON)
[
  {
    "apiVersion": "v1",
    "kind": "ConfigMap",
    "metadata": {
      "name": "web-config"
    },
    "data": {
      "LOG_LEVEL": "info"
    }
  },
  {
    "apiVersion": "v1",
    "kind": "Service",
    "metadata": {
      "name": "web"
    },
    "spec": {
      "selector": {
        "app": "web"
      },
      "ports": [
        {
          "port": 80
        }
      ]
    }
  }
]
manifests.yaml
---
apiVersion: v1
kind: ConfigMap
metadata:
  name: web-config
data:
  LOG_LEVEL: info
---
apiVersion: v1
kind: Service
metadata:
  name: web
spec:
  selector:
    app: web
  ports:
    - port: 80

その他のツール

JSON と YAML が出会うあらゆる場面のための変換ツール、検証ツール、手順ガイド。

よくある質問

Kubernetes の JSON を YAML に変換するには?

kubectl get deployment web -o json の出力などの JSON オブジェクトをエディターに貼り付けます。右側に YAML マニフェストが表示されます。別のクラスターに apply する前に、status や metadata.managedFields などのクラスター管理フィールドを削除してください。

kubectl の List を個別のマニフェストに分けるには?

複数のオブジェクトを指定した kubectl get は {"kind": "List", "items": [...]} を返します。items 配列だけを貼り付けて「マルチドキュメント」をオンにすると、各オブジェクトが --- で区切られた個別のドキュメントになります。これはマニフェストファイルの一般的な構成です。

一部の環境変数の値が引用符で囲まれるのはなぜですか?

Kubernetes では env の値は文字列でなければなりません。引用符がないと true、8080、no は真偽値や数値として読み取られ、API サーバーはマニフェストを拒否します。コンバーターは誤読されるおそれのある文字列をすべて引用符で囲むため、YAML は JSON とまったく同じ意味になります。

kubectl で JSON を直接 apply できますか?

はい、kubectl apply -f は YAML だけでなく JSON も受け付けます。それでも YAML に変換するのは、プルリクエストでレビューしやすく、コメントを書けて、Helm チャートや Kustomize のオーバーレイが YAML を前提としているからです。

コンバーターはマニフェストを Kubernetes API に照らしてチェックしますか?

いいえ、変換するのは構文だけです。kubectl apply --dry-run=server -f manifest.yaml を実行すれば、何も変更せずに API サーバーにフィールドと型を検証させられます。