Damit wird aus JSON einrückungsbasiertes YAML. Geschweifte Klammern und die meisten Anführungszeichen verschwinden, wodurch sich das Ergebnis als Konfigurationsdatei leichter von Hand pflegen lässt, und die Reihenfolge der Keys bleibt exakt wie im Quell-JSON.
Das hilft, wenn du eine mit kubectl get -o json abgerufene Ressource in ein Manifest überführst oder Einstellungen aus einer API in docker-compose.yml, application.yml oder einen GitHub-Actions-Workflow einfügst.
JSON ein. Bei ungültiger Syntax erscheint im Ergebnis JSON parsing failed; lass es bei Bedarf zuerst durch den JSON-Validator laufen.Ergebnis. Eingerückt wird mit zwei Leerzeichen.{
"services": {
"web": {
"image": "nginx:1.27",
"ports": ["8080:80"],
"environment": { "FEATURE_FLAG": "on", "GREETING": "hello\nworld" }
}
}
}services:
web:
image: nginx:1.27
ports:
- 8080:80
environment:
FEATURE_FLAG: "on"
GREETING: |-
hello
world
Der String "on" behält seine Anführungszeichen: Ohne sie als on geschrieben, würde ein YAML-1.1-Parser es als Boolean true lesen. GREETING enthält einen Zeilenumbruch und wird daher als |--Block ausgegeben, der jede Zeile so zeigt, wie sie geschrieben wurde.
yes, no, on, off, y, n, ~, null und Doppelgänger wie "0777", "1.0" oder "2024-01-01" werden in Anführungszeichen gesetzt, damit PyYAML (1.1) und moderne 1.2-Parser denselben Wert lesen.22:22, die YAML 1.1 als Zahl zur Basis 60 lesen kann, werden in Anführungszeichen gesetzt; so vermeidest du einen klassischen Bug bei Port-Mappings in docker-compose.|--Literal-Blöcken.[] und {}.Wandle ein Deployment oder eine ConfigMap um, die du als JSON aus dem Cluster geholt hast, lösche Felder wie status und metadata.uid, und du hast ein Manifest, das bereit für Git ist.
Ein Block von Properties, den du als JSON von einem Config-Server oder aus der Doku bekommen hast, wird zu einer YAML-Hierarchie, und du musst Keys wie spring.datasource.url nicht von Hand einrücken.
&) oder Aliase (*) erzeugt; ein im JSON wiederholtes Objekt wird im YAML ebenfalls wiederholt.--- getrennten Ressourcen wandelst du jede Ressource um und fügst sie selbst zusammen.Anführungszeichen werden nur dort ergänzt, wo ein nackter Wert als anderer Typ gelesen würde. nginx:1.27 ist so oder so ein String, aber on, 010 und 22:22 werden in manchen Parsern zu Booleans oder Zahlen und bekommen deshalb Anführungszeichen.
Die Struktur ist so gültig. Die Ausgabe von kubectl get -o json enthält allerdings vom Server befüllte Felder wie status, resourceVersion und managedFields, die du vor dem Anwenden besser entfernst.
Eine Option gibt es nicht; fest eingestellt sind zwei Leerzeichen, die Konvention in der gesamten Dokumentation von Kubernetes, docker-compose und GitHub Actions.