Convertissez du JSON en YAML !

Saisissez du JSON pour le convertir en YAML lisible ! Compatible avec yml, Kubernetes, docker-compose, Spring application.yml.
JSON
Résultat
 

Convertissez du JSON en YAML !

Transforme du JSON en YAML basé sur l'indentation. Les accolades et la plupart des guillemets disparaissent, ce qui rend le résultat plus facile à maintenir à la main comme fichier de config, et l'ordre des clés reste exactement celui du JSON source.

Utile quand vous transférez dans un manifeste une ressource récupérée avec kubectl get -o json, ou que vous collez des réglages reçus d'une API dans docker-compose.yml, application.yml ou un workflow GitHub Actions.

Mode d'emploi

  1. Collez du JSON dans le champ JSON. Une syntaxe invalide affiche JSON parsing failed dans le résultat ; passez-le d'abord par le validateur JSON si besoin.
  2. Relisez le YAML sous Résultat. L'indentation est de deux espaces.
  3. Copiez-le dans votre fichier .yml, en ajustant la profondeur d'indentation si vous l'imbriquez sous un autre bloc.

Exemple

Entrée (JSON)
{
  "services": {
    "web": {
      "image": "nginx:1.27",
      "ports": ["8080:80"],
      "environment": { "FEATURE_FLAG": "on", "GREETING": "hello\nworld" }
    }
  }
}
Sortie (YAML)
services:
  web:
    image: nginx:1.27
    ports:
      - 8080:80
    environment:
      FEATURE_FLAG: "on"
      GREETING: |-
        hello
        world

La chaîne "on" garde ses guillemets : écrite telle quelle, on, un parseur YAML 1.1 la lirait comme le booléen true. GREETING contient un saut de ligne : elle est donc émise sous forme de bloc |- qui montre chaque ligne telle qu'écrite.

Fonctionnalités prises en charge

  • Les guillemets suivent YAML 1.1. Les chaînes comme yes, no, on, off, y, n, ~, null, et les sosies comme "0777", "1.0" ou "2024-01-01", sont mises entre guillemets pour que PyYAML (1.1) et les parseurs 1.2 modernes lisent la même valeur.
  • Les chaînes comme 22:22, que YAML 1.1 peut lire comme un nombre en base 60, sont aussi mises entre guillemets, ce qui évite un bug classique de mapping de ports docker-compose.
  • Les chaînes multilignes deviennent des blocs littéraux |-.
  • Les longues chaînes ne sont jamais repliées (pas de limite de largeur de ligne).
  • Les tableaux et objets vides restent [] et {}.

Cas d'utilisation

De la sortie JSON de kubectl à un manifeste

Convertissez un Deployment ou un ConfigMap extrait du cluster en JSON, supprimez des champs comme status et metadata.uid, et vous avez un manifeste prêt pour Git.

Écrire l'application.yml de Spring Boot

Un bloc de propriétés reçu en JSON d'un serveur de config ou d'une doc devient une hiérarchie YAML : plus besoin d'indenter à la main des clés comme spring.datasource.url.

Remarques et limites

  • Aucun commentaire, ancre (&) ni alias (*) n'est généré ; un objet répété dans le JSON est répété dans le YAML.
  • Les entiers supérieurs à 9007199254740991 perdent en précision à cause de la limite des nombres JavaScript ; gardez les longs identifiants en chaînes dans le JSON.
  • La sortie est un document unique. Pour un fichier multi-ressources séparé par ---, convertissez chaque ressource et assemblez-les vous-même.

FAQ

Pourquoi certaines chaînes sont-elles entre guillemets et d'autres non ?

Les guillemets ne sont ajoutés que là où une valeur nue serait lue comme un autre type. nginx:1.27 est une chaîne dans tous les cas, mais on, 010 et 22:22 deviennent des booléens ou des nombres dans certains parseurs : ils sont donc entre guillemets.

Puis-je appliquer la sortie directement à Kubernetes ?

La structure est valide telle quelle. La sortie de kubectl get -o json contient toutefois des champs remplis par le serveur comme status, resourceVersion et managedFields, qu'il vaut mieux supprimer avant d'appliquer.

Puis-je passer à une indentation de quatre espaces ?

Il n'y a pas d'option ; elle est fixée à deux espaces, la convention utilisée dans toute la documentation de Kubernetes, docker-compose et GitHub Actions.