{"canonical_url":"https://engineer.company/fr/glossary/yaml/","content_markdown":"# YAML\n\n## Ce que c'est\n\nYAML est un format texte pour les données imbriquées qui indique la structure\npar l'indentation, les deux-points et les tirets plutôt que par des crochets\net des guillemets. C'est pourquoi il est courant pour les configurations que\nl'on écrit et relit à la main. Son nom est un acronyme récursif, « YAML Ain't\nMarkup Language ». Les fichiers se terminent par `.yaml` ou `.yml`, et la\nRFC 9512, publiée en février 2024, a enregistré le type de média\n`application/yaml` en désignant `.yaml` comme extension à privilégier.\n\nSous cette ponctuation légère se trouve un petit modèle de données. Il\ncomprend des tables d'association, qui relient des clés à des valeurs, des\nséquences, qui sont des listes ordonnées, et des scalaires : chaînes, nombres,\nbooléens et valeur nulle. Autour de ce modèle, le langage ajoute ce qu'attend\nune personne qui modifie un fichier : des commentaires commençant par `#`,\ndes scalaires en bloc qui conservent les sauts de ligne avec `|` ou les\nreplient avec `\u003e`, plusieurs documents dans un fichier séparés par `---`,\ndes ancres et des alias (`\u0026name` et `*name`) qui permettent de réutiliser une\nvaleur ailleurs, et des balises qui nomment directement un type.\n\nLe premier framework YAML était écrit en Perl, en 2001. La version 1.1 de la\nspécification a suivi en 2005, puis la version 1.2 en 2009, avec pour objectif\nprincipal de faire de YAML un sur-ensemble strict de JSON et en supprimant\nnombre d'anciennes règles de typage implicite. La révision 1.2.2, publiée en\noctobre 2021, a corrigé des erreurs et clarifié la rédaction sans modifier le\nlangage. Beaucoup de logiciels suivent pourtant encore les anciennes règles :\nla documentation d'Ansible indique que PyYAML et libyaml implémentent YAML 1.1.\n\nYAML se situe donc entre deux voisins. JSON en est un sous-ensemble strict,\nconcis et sans ambiguïté, conçu pour les échanges entre programmes. TOML est\nun format de configuration plus plat dans lequel toutes les chaînes sont\nentre guillemets, de sorte que le type d'une valeur n'est jamais deviné.\nYAML offre davantage que l'un ou l'autre, et cette liberté supplémentaire\nest précisément la source de ses difficultés.\n\n## Pourquoi c'est important\n\nLe vrai choix est le format à donner à un fichier qui sera entretenu pendant\ndes années : descriptions de déploiement, workflows de CI, configuration de\nserveurs. Les playbooks Ansible sont en YAML, comme les fichiers de\nconfiguration de nombreux autres outils d'infrastructure. Pour une grande\npartie de ce travail, le choix a donc déjà été fait en amont ; il reste à\ndécider avec quelle rigueur l'écrire.\n\nL'argument en faveur de YAML est la lisibilité. On peut en relire un diff\nsans compter les accolades, un commentaire peut expliquer la raison d'une\nvaleur, et un script multiligne ou un certificat tient dans un scalaire en\nbloc sans échappement. En contrepartie, les espaces portent du sens : une clé\nindentée de deux espaces de trop peut aboutir dans une autre table\nd'association alors que le fichier reste analysable. Les tabulations sont\nentièrement interdites pour l'indentation. Les valeurs sans guillemets sont\ntypées d'après leur écriture, et les règles diffèrent entre 1.1 et 1.2.\nLe recours à des gabarits ajoute une seconde syntaxe : dans Ansible, une valeur qui commence\npar `{{` doit être entre guillemets, sinon l'analyseur y voit une table\nd'association.\n\nCe qui fait pencher la décision est la manière dont le fichier sera vérifié.\nAvec un linter et l'habitude de mettre les chaînes entre guillemets, YAML est\nun format confortable pour une configuration modifiée en équipe. Sans l'un\nni l'autre, un fichier YAML valide peut dire autre chose que ce que son auteur\nvoulait exprimer. Pour les données échangées entre programmes, JSON est le\nchoix par défaut le plus sûr ; pour un petit fichier de paramètres avec peu\nde niveaux d'imbrication, TOML est plus simple.\n\n## À quoi cela ressemble en pratique\n\nLe dépôt d'infrastructure de l'entreprise couvre des services déployés accessibles au public\net la configuration d'autres composants, dont les rôles de base de données,\nde sauvegarde, de transport du courrier et de DNS. L'implémentation documentée\ncomptait\n[19 playbooks Ansible et 34 rôles, soit 12 065 lignes au total](/fr/portfolio/servers-you-can-rebuild-from-scratch/),\nun décompte historique et non la taille actuelle du dépôt. L'automatisation\ndes sauvegardes et du courrier comporte une étape d'activation opérationnelle\ndistincte de la configuration. La composition est exprimée par des données\nplutôt que par des options. Chaque hôte appartient à un groupe de niveau, dont\nles variables YAML listent les rôles à lui attribuer : une exécution de\nprovisionnement n'a donc besoin d'aucun argument pour amener chaque hôte dans\nl'état déclaré par son groupe. YAML sert ici de langage de l'état déclaré,\net la réussite se vérifie au lieu de se supposer, puisqu'un hôte ayant convergé\ndoit signaler zéro modification. YAML coûte du temps : chaque changement est\nplus lent qu'une modification directe d'un fichier sur le serveur. Comme une\nconvergence qui n'applique que la moitié des changements est pire qu'une qui\nrefuse de s'exécuter, un play de vérification préalable s'exécute désormais\nen amont.\n\nDouze mille lignes de YAML doivent être lues par une machine avant de l'être\npar une personne. Au stade d'implémentation d'août 2026 décrit dans la documentation,\n[YAML était l'un des langages vérifiés par un contrôle de commit à 22 linters](/fr/portfolio/built-a-22-linter-commit-gate/),\naux côtés de HTML, CSS, JavaScript, Python, Markdown et shell. Ce contrôle n'a\npas de niveau d'avertissement : chaque diagnostic bloque le commit, et les\nsuppressions dans le code sont formellement interdites. Dans le fichier, ni un commentaire demandant d'ignorer une règle ni une\ndirective de désactivation ne permettent de contourner le contrôle. C'est important pour YAML : la plupart des pièges ci-dessous\nsont parfaitement valides sur le plan syntaxique, et seule une règle qui les\nrefuse les intercepte avant qu'ils n'atteignent un hôte.\n\n## Où les problèmes surviennent\n\nLes pièges ci-dessous ont un point commun : le fichier s'analyse sans erreur,\nmais signifie autre chose.\n\n**Un code pays devient faux.** Selon les règles de YAML 1.1, `yes`, `no`,\n`on`, `off`, `y` et `n`, sans guillemets et sous plusieurs combinaisons de\nmajuscules et de minuscules, sont des booléens. Le schéma central de YAML 1.2\nne conserve que `true` et `false`, sous trois combinaisons de casse, et la\nRFC 9512 avertit qu'un analyseur suivant l'ancienne syntaxe peut lire\n`{insecure: n}` comme faux plutôt que comme la lettre n. Une liste de pays\nnordiques illustre le problème :\n\n```yaml\ncountries:\n    - DK\n    - SE\n    - NO # YAML 1.1 reads this as false\n```\n\nMettez entre guillemets toute chaîne qui pourrait être interprétée autrement,\nécrivez les booléens uniquement sous la forme `true` et `false`, et faites\nrespecter ces deux règles par un linter.\n\n**Un numéro de version perd un chiffre.** Les nombres sans guillemets sont\nconvertis : `version: 1.10` devient le nombre à virgule flottante 1,1, et selon\nles règles de 1.1 un zéro initial indique un nombre octal, si bien qu'un code\nécrit `010` devient 8. La documentation d'Ansible recommande de mettre une\nversion telle que `\"1.0\"` entre guillemets pour cette raison précise. Faites-le\npour les identifiants, les codes et les versions : ce sont des chaînes qui se\ntrouvent contenir des chiffres.\n\n**Une clé se retrouve sous le mauvais parent.** L'indentation détermine à\nquelle table d'association appartient une clé : décaler une ligne de deux\nespaces déplace un paramètre ailleurs sans provoquer d'erreur. La spécification\nexige aussi que chaque clé d'une table d'association soit unique. Une clé\nrépétée au fond d'un long bloc passe facilement inaperçue à la relecture :\nyamllint possède donc une règle pour chacune de ces deux erreurs. Exécutez-le\navant d'utiliser le fichier.\n\n**Charger un fichier exécute du code.** Les balises peuvent nommer des types\npropres à un langage, et un chargeur qui les respecte construit tout objet\nque le fichier demande. La documentation de PyYAML compare l'utilisation de\n`yaml.load` (avec un chargeur non sûr) à `pickle.load` : cet appel peut\nconstruire des objets et invoquer des fonctions Python. Le choix du chargeur\ncompte ; les versions actuelles exigent qu'il soit précisé explicitement.\n`yaml.safe_load` ne reconnaît que les balises YAML de base. La RFC 9512\ndemande que l'exécution de code dans les désérialiseurs soit désactivée par\ndéfaut. Utilisez le chargeur sûr pour les fichiers de configuration ordinaires.\n\n**Un petit fichier remplit la mémoire.** Les ancres et les alias font d'un\ndocument YAML un graphe plutôt qu'un arbre. Lorsque chaque ancre répète deux\nfois la précédente, chaque ligne ajoutée double la taille : trente lignes\ncourtes décrivent ainsi plus d'un milliard de chaînes dès qu'un programme\nparcourt le résultat comme un simple arbre. La RFC 9512 nomme cela une\nexpansion exponentielle des données, l'attaque billion laughs, et y répond\npar des processeurs qui limitent la profondeur de récursion des ancres.\nN'acceptez du YAML extérieur qu'au travers d'un tel processeur et testez la\nlimite avec l'analyseur réellement utilisé.\n\n## Pour aller plus loin\n\n- [YAML 1.2.2 specification](https://yaml.org/spec/1.2.2/) — le langage\n  lui-même, dont le schéma central qui détermine le typage des valeurs sans\n  guillemets.\n- [RFC 9512: YAML Media Type](https://www.rfc-editor.org/rfc/rfc9512) —\n  l'enregistrement d'`application/yaml`, avec des notes de sécurité sur les\n  booléens, l'exécution de code et le développement des alias.\n- [YAML specification changes](https://yaml.org/spec/1.2.2/ext/changes/) — les\n  changements de chaque révision, de 1.2.1 à 1.2.2.\n- [Ansible: YAML Syntax](https://docs.ansible.com/ansible/latest/reference_appendices/YAMLSyntax.html)\n  — le sous-ensemble utilisé par Ansible et ses pièges de mise entre guillemets.\n- [yamllint rules](https://yamllint.readthedocs.io/en/stable/rules.html) — les\n  contrôles des valeurs interprétées comme vraies ou fausses, des clés en\n  double, des nombres octaux et de l'indentation.\n- [PyYAML documentation](https://pyyaml.org/wiki/PyYAMLDocumentation) — la\n  différence entre `load` et `safe_load`, selon la propre documentation de la bibliothèque.\n\n\u003chttps://engineer.company/fr/glossary/yaml/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Ce qu'est YAML, quand le préférer à JSON ou TOML pour un fichier modifié à la main, et les pièges de booléens, d'indentation et de chargeurs non sûrs.","formats":{"gemtext":"https://engineer.company/fr/glossary/yaml/index.gmi","gopher":"https://engineer.company/fr/glossary/yaml/gophermap","html":"https://engineer.company/fr/glossary/yaml/","json":"https://engineer.company/fr/glossary/yaml/index.json","markdown":"https://engineer.company/fr/glossary/yaml/index.md","pdf":"https://engineer.company/fr/glossary/yaml/index.pdf"},"kind":"page","language":"fr","title":"Qu'est-ce que YAML ?","url":"https://engineer.company/fr/glossary/yaml/","version":1}