YAML à JSON : convertir des configs sans perdre la tête

Ce que fait réellement une conversion de YAML en JSON

YAML et JSON décrivent les mêmes formes — cartes, listes, chaînes, nombres, booléens et null — donc la conversion consiste principalement à re-sérialiser une syntaxe comme l'autre. Ce qui change, c'est la surface : l'indentation devient des accolades, les commentaires disparaissent, les ancres deviennent des copies et les chaînes multilignes se transforment en `\n` échappements. Chacune de ces transformations entraîne des pertes d'une manière qui compte, c'est pourquoi l'étape de conversion mérite d'être effectuée délibérément plutôt que de la traiter comme un formatage après coup.

La raison pratique de convertir est que JSON est ce que veut le prochain outil. Kubernetes accepte YAML, mais `kubectl`, les pipelines jq, les appels API et JavaScript parlent tous JSON plus confortablement. Une conversion unique, correctement, surpasse l'édition manuelle de deux formats en parallèle.

Multidocument YAML : le problème silencieux du premier document

Un fichier YAML peut contenir plusieurs documents séparés par `---`. La plupart des convertisseurs renvoient discrètement le premier et jettent le reste. Ainsi, un ensemble de manifestes avec un déploiement, un service et un ConfigMap devient un seul objet sans avertissement. Une conversion correcte émet un tableau de documents ou vous demande explicitement lequel vous voulez. Si un convertisseur n'offre pas un tel contrôle, il perd des données.

Les erreurs doivent pointer vers une ligne et une colonne

La tolérance de YAML pour les espaces est exactement la raison pour laquelle les petites erreurs sont difficiles à trouver. Les tabulations sont illégales pour l'indentation, un deux-points manquant transforme un mappage en chaîne et les clés en double sont acceptées par certains analyseurs et rejetées par d'autres. Lorsqu'une conversion échoue, le seul message utile nomme la ligne et la colonne et affiche l'extrait incriminé :

                spec:
  containers:
	- name: web      # tab used for indentation
error: line 3, column 0 — tabs cannot be used for indentation
              

Les clés en double constituent le cas dangereux : les analyseurs YAML conservent généralement la dernière valeur et ne disent rien. Si `replicas: 3` apparaît deux fois, le JSON que vous obtenez semble parfaitement valide — et le mauvais numéro.

Citer des règles qui survivent au voyage

JSON est plus strict sur les chaînes que YAML, donc les conversions ajoutent des guillemets autour des valeurs qui étaient nues. C'est normal, mais deux bizarreries de YAML provoquent de vrais bugs : `yes`, `no`, `on` et `off` sont des booléens dans YAML 1.1, mais les chaînes dans la sémantique JSON et les valeurs zéro non significatives telles que les codes postaux et les numéros de téléphone perdent leur zéro lorsqu'elles sont traitées comme des nombres. Si un champ doit rester une chaîne tout au long de la conversion, citez-le dans la source.

Exécutez-le localement, en particulier pour les configurations de cluster

Les manifestes Kubernetes contiennent régulièrement des informations d'identification dans les objets `Secret`, des chaînes de connexion dans ConfigMaps et des jetons dans les fichiers CI. Les coller dans un service Web les transmet à un serveur que vous ne contrôlez pas. Un convertisseur basé sur un navigateur effectue l'analyse et la sérialisation dans le même onglet que vous lisez, donc rien n'est transmis – et une page qui continue de fonctionner avec le réseau coupé en est une preuve plutôt qu'une promesse.

Un flux de travail judicieux

1. Validez d'abord le YAML et corrigez les éventuelles lignes, colonnes et extraits rapportés.
2. Choisissez comment les fichiers multi-documents doivent être gérés : un tableau ou un document spécifique.
3. Convertissez avec une indentation qui correspond à votre style de base de code (2 ou 4 espaces) et triez les clés si vous différez la sortie.
4. Gardez YAML comme source de vérité dans git et traitez le JSON comme un artefact généré ; les commentaires ne vivent que dans le YAML.