JSON zu YAML Konverter

Was ist YAML und warum aus JSON konvertieren?

// Convert JSON to YAML in Node.js using the eemeli/yaml library
import { Document } from 'yaml';

const data = JSON.parse('{"apiVersion":"apps/v1","kind":"Deployment"}');

// version: '1.1' ensures Norway-problem strings (yes/no/on/off/y/n)
// are automatically quoted in the output for YAML 1.1 parser safety
const doc = new Document(data, { version: '1.1' });

const yamlString = doc.toString({
  indent: 2,
  lineWidth: 0,         // disable line wrapping
  defaultStringType: 'PLAIN',   // Auto mode: only quote when needed
});

console.log(yamlString);
// apiVersion: apps/v1
// kind: Deployment

Hauptfunktionen

Beispiele

{"apiVersion":"apps/v1","kind":"Deployment","metadata":{"name":"my-app","namespace":"production","labels":{"app":"my-app","version":"1.0.0"}},"spec":{"replicas":3,"selector":{"matchLabels":{"app":"my-app"}},"template":{"metadata":{"labels":{"app":"my-app"}},"spec":{"containers":[{"name":"my-app","image":"my-app:1.0.0","ports":[{"containerPort":8080}],"resources":{"requests":{"memory":"64Mi","cpu":"250m"},"limits":{"memory":"128Mi","cpu":"500m"}}}]}}}}

{"version":"3.9","services":{"web":{"image":"nginx:1.25-alpine","ports":["80:80","443:443"],"environment":{"NGINX_HOST":"example.com","NGINX_PORT":"80"},"depends_on":["db"],"restart":"unless-stopped"},"db":{"image":"postgres:16-alpine","environment":{"POSTGRES_DB":"mydb","POSTGRES_USER":"admin","POSTGRES_PASSWORD":"secret"},"volumes":["pgdata:/var/lib/postgresql/data"]}},"volumes":{"pgdata":{}}}

{"name":"CI","on":{"push":{"branches":["main"]},"pull_request":{"branches":["main"]}},"jobs":{"build":{"runs-on":"ubuntu-latest","steps":[{"uses":"actions/checkout@v4"},{"name":"Set up Node.js","uses":"actions/setup-node@v4","with":{"node-version":"20","cache":"pnpm"}},{"name":"Install dependencies","run":"pnpm install --frozen-lockfile"},{"name":"Run tests","run":"pnpm test"}]}}}

{"openapi":"3.0.3","info":{"title":"User API","version":"1.0.0","description":"Manage application users"},"paths":{"/users":{"get":{"summary":"List users","operationId":"listUsers","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":20}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/User"}}}}}}}},"/users/{id}":{"get":{"summary":"Get user","operationId":"getUser","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success"}}}}},"components":{"schemas":{"User":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string","format":"email"}}}}}}

{"name":"my-app","version":"1.0.0","description":"A sample Node.js application","private":true,"scripts":{"dev":"vite","build":"tsc && vite build","preview":"vite preview","test":"vitest","lint":"eslint . --ext .ts,.tsx"},"dependencies":{"react":"^18.3.0","react-dom":"^18.3.0"},"devDependencies":{"typescript":"^5.4.0","vite":"^5.2.0","vitest":"^1.5.0","eslint":"^8.57.0","@types/react":"^18.3.0"},"engines":{"node":">=20.0.0","pnpm":">=9.0.0"}}

{"format_version":"1.0","terraform_version":"1.7.4","variables":{"region":{"value":"us-east-1"}},"planned_values":{"root_module":{"resources":[{"address":"aws_s3_bucket.main","mode":"managed","type":"aws_s3_bucket","name":"main","values":{"bucket":"my-app-assets","force_destroy":false,"tags":{"Environment":"production","ManagedBy":"terraform"}}}]}},"resource_changes":[{"address":"aws_s3_bucket.main","mode":"managed","type":"aws_s3_bucket","name":"main","change":{"actions":["create"],"before":null,"after":{"bucket":"my-app-assets","force_destroy":false}}}]}

Anleitung

1. 1

   JSON einfügen

   Geben Sie Ihre JSON-Daten in das Eingabefeld oben ein oder fügen Sie sie ein. Sie können auch auf „Beispiel laden“ klicken, um ein Beispiel wie ein Kubernetes-Deployment, eine Docker-Compose-Datei oder einen Terraform-Plan auszuprobieren.

2. 2

   Live-YAML-Ausgabe anzeigen

   YAML erscheint sofort im Ausgabebereich. Passen Sie die Optionen an (Einrückung 2/4, Anführungszeichen Auto/Doppelt/Einfach, Stil Block/Flow), um die Anforderungen Ihres Zielwerkzeugs zu erfüllen.

3. 3

   Kopieren oder Herunterladen

   Klicken Sie auf Kopieren, um das YAML in Ihre Zwischenablage zu übernehmen, oder auf Herunterladen, um es als .yaml-Datei zu speichern, die für kubectl apply, docker compose up oder ein anderes Werkzeug bereit ist.

Häufige Konvertierungsfehler

{"name": "Alice", "role": "admin",}

{"name": "Alice", "role": "admin"}

{'name': 'Alice', 'active': true}

{"name": "Alice", "active": true}

{name: "Alice", role: "admin"}

{"name": "Alice", "role": "admin"}

{"port": 8080 // HTTP port}

{"port": 8080}

# JSON input: {"country": "no", "enabled": "yes"}
# YAML without quoting (dangerous):
country: no
enabled: yes
# YAML 1.1 parser reads: country=false, enabled=true

# YAML with Auto quoting (safe):
country: 'no'
enabled: 'yes'
# YAML 1.1 parser reads: country="no", enabled="yes"

// JSON input (resourceVersion is int64 on K8s server)
{"resourceVersion": 9007199254740993}
// JavaScript reads it as: 9007199254740992 (precision lost)
// YAML output will contain the wrong number

// Store large integers as strings to preserve precision
{"resourceVersion": "9007199254740993"}
// YAML output: resourceVersion: '9007199254740993' (exact)

Häufige Anwendungsfälle

Kubernetes-Manifeste

Konvertieren Sie JSON-API-Antworten von kubectl get -o json oder der Kubernetes-API in YAML-Manifeste für GitOps-Workflows, Kustomize-Overlays und kubectl-apply-f-Deployments.

Docker-Compose-Dateien

Wandeln Sie docker inspect JSON-Ausgabe oder programmatisch generierte Service-Konfigurationen in docker-compose.yaml-Dateien um, die mit docker compose up und Docker-Stack-Deployments kompatibel sind.

Helm-Chart-Werte

Konvertieren Sie JSON-Konfigurationsexporte in YAML-Wertedateien für Helm-Chart-Deployments und ermöglichen Sie so eine versionskontrollierte Infrastrukturkonfiguration mit sauberer YAML-Syntax.

GitHub-Actions-Workflows

Erstellen Sie GitHub-Actions-Workflow-Definitionen programmatisch in JSON und konvertieren Sie sie in das von GitHub Actions Runner benötigte .github/workflows/*.yaml-Format.

OpenAPI-Spezifikationen

Konvertieren Sie OpenAPI/Swagger-Spezifikationen vom JSON-Format, das von vielen Frameworks zurückgegeben wird (FastAPI, SpringDoc), in das von Swagger UI, Redoc und API-Gateway-Werkzeugen bevorzugte YAML-Format.

Konfigurationsmigration

Migrieren Sie Anwendungskonfigurationen, die in JSON gespeichert sind (appsettings.json, config.json), in das YAML-Format für Werkzeuge, die YAML erfordern oder bevorzugen, und fügen Sie die Möglichkeit hinzu, Kommentare zur Dokumentation zu verwenden.

Technische Details

RFC-8259-konformes JSON-Parsing

JSON-Eingaben werden mit dem nativen JSON.parse() des Browsers geparst, der vollständig RFC-8259-konform ist. Dies liefert genaue Syntaxfehlermeldungen einschließlich Positionsinformationen und verarbeitet alle JSON-Datentypen: Zeichenketten, Zahlen, boolesche Werte, null, Arrays und Objekte.

YAML-1.2-Ausgabe über die eemeli/yaml-Document-API mit YAML-1.1-Schema

YAML wird mit der eemeli/yaml-Bibliothek (v2.8+, CVE-sicher) über ihre Document-API mit version: '1.1' generiert. Diese Kombination erzeugt YAML-1.2-konforme Ausgabe und wendet dabei YAML-1.1-Anführungsregeln an — das bedeutet, Norway-Problem-Zeichenketten (yes/no/on/off/y/n) werden in der Ausgabe automatisch in Anführungszeichen gesetzt, was sie sicher für YAML-1.1- und YAML-1.2-Parser macht. Zeilenumbruch ist deaktiviert (lineWidth: 0), um lange Zeichenketten intakt zu erhalten.

100 % browserbasiert — kein Upload, kein Server

Die gesamte Verarbeitung findet vollständig in der JavaScript-Engine Ihres Browsers statt. Es werden keine Daten über das Netzwerk übertragen. Eingaben größer als 200 KB wechseln automatisch vom Live-Modus in den manuellen Modus (erfordert einen expliziten Konvertieren-Klick), um den Browser reaktionsfähig zu halten und das Blockieren des Haupt-Threads bei umfangreicher Serialisierung zu verhindern.

Best Practices

Immer Auto-Anführungsmodus für DevOps-Konfigurationen verwenden

Verwenden Sie beim Konvertieren von JSON für Kubernetes, Helm, Ansible, Docker Compose oder GitHub Actions immer den Standard-Auto-(Norway-sicheren)-Anführungsmodus. YAML-1.1-Parser in diesen Werkzeugen interpretieren nackte yes, no, on, off, y und n stillschweigend als boolesche Werte — der Auto-Modus verhindert dies transparent.

2-Leerzeichen-Einrückung für Cloud-native Werkzeuge verwenden

Kubernetes, Docker Compose, GitHub Actions und Helm verwenden konventionell alle 2-Leerzeichen-Einrückung. Die Verwendung von 4-Leerzeichen-Einrückung in diesen Dateien ist gültiges YAML, führt aber zu Inkonsistenzen mit Community-Beispielen, automatisch generierten Konfigurationen und den vorhandenen Manifesten Ihres Teams.

Große Ganzzahlen vor der Konvertierung als Zeichenketten speichern

Kubernetes-resourceVersion, uid und andere int64-Felder vom API-Server können JavaScripts sicheren Ganzzahlbereich (2^53 - 1) überschreiten. Wenn Sie exakte numerische Präzision benötigen, speichern Sie diese Werte als JSON-Zeichenketten vor der Konvertierung. Dies ist besonders wichtig für kubectl-get-o-json-Ausgaben, die vom Server generierte Felder enthalten.

Zuerst JSON validieren

Wenn Ihre JSON-Quelle handgeschrieben ist oder von einem System stammt, das gelegentlich ungültige Ausgabe produziert (abschließende Kommas, Schlüssel ohne Anführungszeichen, Kommentare), validieren Sie es mit einem JSON-Formatierer vor der Konvertierung. Verwenden Sie unseren JSON-Formatierer, um Syntaxfehler zuerst zu erkennen und zu beheben, dann das saubere JSON nach YAML zu konvertieren.

Block-Stil für Dateien in der Versionskontrolle bevorzugen

Block-Stil-YAML erzeugt saubere, menschenlesbare Diffs in Git, weil jedes Feld in einer eigenen Zeile erscheint. Der Flow-Stil (kompakt, inline) macht Diffs schwieriger zu lesen und zu überprüfen. Reservieren Sie den Flow-Stil für kurze YAML-Ausschnitte in der Dokumentation oder für Werkzeuge, die kompakte Ausgabe erfordern.

Häufig gestellte Fragen