JSON in YAML umwandeln!

Gib JSON ein, um es in gut lesbares YAML umzuwandeln! Unterstützt yml, Kubernetes, docker-compose, Spring application.yml.
JSON
Ergebnis
 

JSON in YAML umwandeln!

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.

So funktioniert es

  1. Füge JSON in das Feld JSON ein. Bei ungültiger Syntax erscheint im Ergebnis JSON parsing failed; lass es bei Bedarf zuerst durch den JSON-Validator laufen.
  2. Prüfe das YAML unter Ergebnis. Eingerückt wird mit zwei Leerzeichen.
  3. Kopiere es in deine .yml-Datei und passe die Einrückungstiefe an, wenn du es unter einem anderen Block verschachtelst.

Beispiel

Eingabe (JSON)
{
  "services": {
    "web": {
      "image": "nginx:1.27",
      "ports": ["8080:80"],
      "environment": { "FEATURE_FLAG": "on", "GREETING": "hello\nworld" }
    }
  }
}
Ausgabe (YAML)
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.

Unterstützte Funktionen

  • Das Quoting folgt YAML 1.1. Strings wie 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.
  • Auch Strings wie 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.
  • Mehrzeilige Strings werden zu |--Literal-Blöcken.
  • Lange Strings werden nie umbrochen (kein Limit für die Zeilenbreite).
  • Leere Arrays und Objekte bleiben [] und {}.

Anwendungsfälle

Von der JSON-Ausgabe von kubectl zum Manifest

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.

application.yml für Spring Boot schreiben

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.

Hinweise und Einschränkungen

  • Es werden keine Kommentare, Anker (&) oder Aliase (*) erzeugt; ein im JSON wiederholtes Objekt wird im YAML ebenfalls wiederholt.
  • Ganzzahlen über 9007199254740991 verlieren wegen des Zahlenlimits von JavaScript an Genauigkeit; behalte lange IDs im JSON als Strings.
  • Die Ausgabe ist ein einzelnes Dokument. Für eine Datei mit mehreren, durch --- getrennten Ressourcen wandelst du jede Ressource um und fügst sie selbst zusammen.

Häufige Fragen

Warum stehen manche Strings in Anführungszeichen und andere nicht?

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.

Kann ich die Ausgabe direkt auf Kubernetes anwenden?

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.

Kann ich auf vier Leerzeichen Einrückung umstellen?

Eine Option gibt es nicht; fest eingestellt sind zwei Leerzeichen, die Konvention in der gesamten Dokumentation von Kubernetes, docker-compose und GitHub Actions.