Wandle ein YAML-Dokument (yml) in JSON um, um die Struktur zu sehen, die die Einrückung verbirgt, und den Typ, als der jeder Wert tatsächlich geparst wurde. Anker und Aliase werden zu echten Werten aufgelöst, und mehrere durch --- getrennte Dokumente werden in einem Array gesammelt.
Besonders praktisch ist das, um klassische YAML-Fehler zu erwischen: einen Wert, der wegen eines einzigen fehlenden Leerzeichens am falschen Elternknoten hängt, oder version: 1.10, das stillschweigend zur Zahl 1.1 wird.
YAML ein oder ziehe die Datei darauf.Ergebnis ab, ob jeder Wert zu einem String, einer Zahl oder einem Boolean wurde, und kopiere es, wenn du es brauchst.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
}
}
}Der Key on: von GitHub Actions bleibt der String-Key "on", weil dieses Tool nach den Regeln von YAML 1.2 parst. Der mit dem Anker &node definierte Block wird anstelle von *node eingesetzt.
yes, on und off bleiben Strings, und nur true/True/false werden zu Booleans.~ und leere Werte werden zu null; hexadezimales 0x1F und oktales 0o17 werden zu Zahlen.&anchors und *aliases werden zu den referenzierten Werten aufgelöst.| und gefaltete Blöcke mit > werden unter Anwendung der YAML-Regeln für Zeilenumbrüche zu Strings.--- getrennte Dokumente werden zu einem JSON-Array; ein einzelnes Dokument wird als eigener Wert ausgegeben.Ist env unter containers eine Ebene zu flach eingerückt, hängt es sich stillschweigend an ein anderes Feld, und du merkst es erst beim Apply. Im JSON zeigen die Klammern genau, zu welchem Objekt es gehört.
Für ein Skript oder Frontend-Bundle, bei dem ein YAML-Parser übertrieben wäre, wandelst du die Konfiguration einmal um und verwendest sie als import config from './config.json'.
Ein in YAML geschriebenes OpenAPI-Dokument lässt sich nach der Umwandlung leichter mit JSONPath oder jq abfragen, etwa um das Schema unter einem bestimmten Pfad herauszuziehen.
<<: *defaults) werden angewendet: Die Keys des Mappings mit dem Anker werden hineinkopiert, und neben << geschriebene Keys überschreiben sie. Ein reiner YAML-1.2-Parser würde << als normalen Key behalten, die Ergebnisse können sich von solchen Tools also unterscheiden.2024-01-01 bleiben Strings, statt zu Date-Werten zu werden..inf und .nan haben keine JSON-Darstellung und werden zu null.on und yes als true, die Ergebnisse aus Python können also abweichen.on von GitHub Actions als "on" statt als true angezeigt?In YAML 1.2 sind die einzigen Booleans true und false, on ist also ein gewöhnlicher String, und genau so liest auch GitHub Actions den Key. PyYAML in Python folgt 1.1 und macht daraus einen Key True; Vorsicht also, wenn du Workflows aus Skripten parst.
version: 1.10 kommt als 1.1 heraus.Ein 1.10 ohne Anführungszeichen ist in YAML eine Zahl, und 1.10 ist gleich 1.1. Um einen Versions-String zu behalten, setze ihn im Quell-YAML in Anführungszeichen: "1.10".
Jedes durch --- getrennte Dokument wird der Reihe nach zu einem Array-Element; eine Datei mit mehreren Ressourcen, wie sie mit kubectl apply -f verwendet wird, ergibt also ein Array von Ressourcen.