JSON en YAML Kubernetes

Convertissez la sortie JSON de kubectl et les objets d'API en manifestes propres, à relire puis appliquer.

Options de sortie

JSONentrée

Vide

YAMLsortie

La sortie YAML s'affiche ici

Fonctionne entièrement dans votre navigateur: rien n'est envoyé. Des limites d'usage raisonnable s'appliquent (5 MB par entrée, nombre de conversions limité) pour éviter le spam et les robots.

Charger depuis une URL

Le fichier est récupéré directement par votre navigateur : le serveur doit donc autoriser les requêtes cross-origin.

Raccourcis clavier

Ctrl / ⌘ + Enter Convertir maintenant
Ctrl / ⌘ + S Télécharger la sortie
Alt + Shift + C Copier la sortie
Alt + Shift + F Réparer et formater le JSON d'entrée
Alt + Shift + S Inverser le sens
Alt + Shift + T Basculer entre les vues code, arbre et correspondance
Ctrl / ⌘ + Z Annuler, y compris Formater, Réparer et Effacer
Esc Quitter le plein écran
Taille du texte de l'éditeur

Du JSON de kubectl à un manifeste propre

Les objets exportés contiennent des champs d'état et de suivi que le cluster définit lui-même. Supprimez-les d'abord, puis convertissez : le résultat peut être appliqué n'importe où.

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

Collez web.json ci-dessus ou importez-le.

Les valeurs d'environnement restent des chaînes

Le serveur d'API rejette une valeur env qui n'est pas une chaîne. Les valeurs qui ressemblent à des booléens, des nombres ou des versions sont mises entre guillemets automatiquement.

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'

Désactivez Compatible YAML 1.1 pour voir quelles valeurs un analyseur YAML 1.1 lirait mal.

Un objet par document

Collez le tableau items d'une List kubectl et activez « Multi-document » pour obtenir un seul fichier avec --- entre les objets.

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

Autres outils

Convertisseurs, validateurs et guides pas à pas pour tous les endroits où JSON et YAML se croisent.

Questions fréquentes

Comment convertir du JSON Kubernetes en YAML ?

Collez l'objet JSON dans l'éditeur, par exemple la sortie de kubectl get deployment web -o json. Le manifeste YAML apparaît à droite. Supprimez les champs gérés par le cluster, comme status et metadata.managedFields, avant de l'appliquer à un autre cluster.

Comment transformer une List kubectl en manifestes séparés ?

kubectl get avec plusieurs objets renvoie {"kind": "List", "items": [...]}. Collez seulement le tableau items et activez « Multi-document » : chaque objet devient son propre document, séparé par ---, ce qui est la disposition habituelle d'un fichier de manifestes.

Pourquoi certaines valeurs de variables d'environnement sont-elles entre guillemets ?

Kubernetes exige que les valeurs env soient des chaînes. Sans guillemets, true, 8080 ou no seraient lus comme un booléen ou un nombre et le serveur d'API rejetterait le manifeste. Le convertisseur met entre guillemets toute chaîne qui pourrait être mal interprétée, pour que le YAML signifie exactement ce que signifiait le JSON.

kubectl peut-il appliquer du JSON directement ?

Oui, kubectl apply -f accepte le JSON comme le YAML. Les équipes convertissent quand même en YAML, car il est plus facile à relire dans les pull requests, accepte les commentaires et correspond à ce qu'attendent les charts Helm et les overlays Kustomize.

Le convertisseur vérifie-t-il mon manifeste avec l'API Kubernetes ?

Non, il ne convertit que la syntaxe. Exécutez kubectl apply --dry-run=server -f manifest.yaml pour que le serveur d'API valide les champs et les types sans rien modifier.