JSON から Kubernetes YAML へ
kubectl の JSON 出力や API オブジェクトを、レビューしてそのまま apply できる整ったマニフェストに変換します。
JSON入力
YAML出力
出力の各行を既定の書式で表示し、その行が持つ値のパスを横に示します。行をクリックするとパスをコピーできます。
すべてブラウザ内で動作し、データはアップロードされません。スパムやボットを防ぐため、公正利用の制限(入力 1 件あたり 5 MB、変換回数のレート制限)があります。
kubectl の JSON から整ったマニフェストへ
エクスポートしたオブジェクトには、クラスターが自分で設定する status や管理用のフィールドが含まれています。先にそれらを取り除いてから変換すれば、結果はどこにでも apply できます。
# 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 の値を拒否します。真偽値、数値、バージョンに見える値は自動的に引用符で囲まれます。
{
"env": [
{
"name": "FEATURE_FLAG",
"value": "true"
},
{
"name": "PORT",
"value": "8080"
},
{
"name": "REGION",
"value": "no"
},
{
"name": "API_VERSION",
"value": "1.20"
}
]
} 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 つのファイルになります。
[
{
"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
}
]
}
}
] ---
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 サーバーにフィールドと型を検証させられます。