Convertissez un document YAML (yml) en JSON pour voir la structure que l'indentation masque et le type réel sous lequel chaque valeur a été analysée. Les ancres et alias sont développés en valeurs réelles, et les documents multiples séparés par --- sont rassemblés dans un tableau.
C'est particulièrement pratique pour repérer les erreurs YAML classiques : une valeur rattachée au mauvais parent à cause d'un espace manquant, ou version: 1.10 qui devient silencieusement le nombre 1.1.
YAML, ou déposez-y le fichier.Résultat pour voir si chaque valeur est devenue une chaîne, un nombre ou un booléen, et copiez-le si besoin.name: ci
on:
push:
branches: [main]
defaults: &node
runs-on: ubuntu-latest
timeout-minutes: 10
jobs:
test: *node
{
"name": "ci",
"on": {
"push": {
"branches": [
"main"
]
}
},
"defaults": {
"runs-on": "ubuntu-latest",
"timeout-minutes": 10
},
"jobs": {
"test": {
"runs-on": "ubuntu-latest",
"timeout-minutes": 10
}
}
}La clé on: de GitHub Actions reste la clé chaîne "on", car cet outil analyse selon les règles de YAML 1.2. Le bloc défini avec l'ancre &node est développé à la place de *node.
yes, on et off restent des chaînes, et seuls true/True/false deviennent des booléens.~ et les valeurs vides deviennent null ; l'hexadécimal 0x1F et l'octal 0o17 deviennent des nombres.&anchors et alias *aliases sont résolus vers les valeurs référencées.| et repliés > sont transformés en chaînes en appliquant les règles de sauts de ligne de YAML.--- deviennent un tableau JSON ; un document unique est produit sous sa propre valeur.Si env sous containers est indenté d'un niveau de trop peu, il se rattache silencieusement à un autre champ et vous ne le découvrez qu'au moment de l'apply. En JSON, les accolades montrent exactement à quel objet il appartient.
Pour un script ou un bundle front-end où ajouter un parseur YAML serait excessif, convertissez la config une fois et utilisez-la via import config from './config.json'.
Un document OpenAPI écrit en YAML est plus facile à interroger avec JSONPath ou jq une fois converti, par exemple pour extraire le schéma d'un chemin précis.
<<: *defaults) sont appliquées : les clés du mapping ancré sont recopiées, et celles écrites à côté de << les remplacent. Un parseur strictement YAML 1.2 garderait << comme clé ordinaire : les résultats peuvent donc différer de ces outils.2024-01-01 restent des chaînes au lieu de devenir des valeurs Date..inf et .nan n'ont pas de représentation JSON et deviennent null.on et yes comme true : les résultats obtenus en Python peuvent donc différer.on de GitHub Actions apparaît-il comme "on" au lieu de true ?En YAML 1.2, les seuls booléens sont true et false : on est donc une chaîne ordinaire, et c'est aussi ainsi que GitHub Actions lit la clé. PyYAML en Python suit la 1.1 et en fait une clé True : attention quand vous analysez des workflows depuis des scripts.
version: 1.10 sort en 1.1.Sans guillemets, 1.10 est un nombre en YAML, et 1.10 est égal à 1.1. Pour garder une chaîne de version, mettez-la entre guillemets dans le YAML source : "1.10".
Chaque document séparé par --- devient un élément du tableau, dans l'ordre : un fichier multi-ressources utilisé avec kubectl apply -f donne donc un tableau de ressources.