YAML zu JSON Konverter

Was ist JSON?

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

const yamlString = `apiVersion: apps/v1
kind: Deployment`;

// parseAllDocuments handles multi-document YAML (--- separator)
// version: '1.2' ensures yes/no are strings, not booleans
// merge: true expands anchor/alias merge keys (<<: *anchor)
const docs = parseAllDocuments(yamlString, { version: '1.2', merge: true });

// Take the first document (skip additional --- blocks)
const json = JSON.stringify(docs[0].toJSON(), null, 2);

console.log(json);
// {
//   "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

replicaCount: 3
image:
  repository: my-app
  tag: 1.0.0
  pullPolicy: IfNotPresent
service:
  type: ClusterIP
  port: 80
ingress:
  enabled: true
  className: nginx
  hosts:
    - host: my-app.example.com
      paths:
        - path: /
          pathType: Prefix
resources:
  requests:
    memory: 64Mi
    cpu: 250m
  limits:
    memory: 128Mi
    cpu: 500m
autoscaling:
  enabled: false
  minReplicas: 1
  maxReplicas: 10
  targetCPUUtilizationPercentage: 80

- name: Configure web servers
  hosts: webservers
  become: true
  vars:
    http_port: 80
    max_clients: 200
  tasks:
    - name: Ensure nginx is installed
      ansible.builtin.package:
        name: nginx
        state: present
    - name: Start nginx service
      ansible.builtin.service:
        name: nginx
        state: started
        enabled: true
    - name: Copy nginx config
      ansible.builtin.template:
        src: nginx.conf.j2
        dest: /etc/nginx/nginx.conf
        owner: root
        group: root
        mode: '0644'
      notify:
        - Restart nginx
  handlers:
    - name: Restart nginx
      ansible.builtin.service:
        name: nginx
        state: restarted

Anleitung

1. 1

   YAML einfügen

   Geben Sie Ihre YAML-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 eine Helm-values.yaml auszuprobieren.

2. 2

   Live-JSON-Ausgabe anzeigen

   JSON erscheint sofort im Ausgabebereich. Passen Sie die Optionen an (Einrückung 2 oder 4 Leerzeichen), um die Anforderungen Ihres Zielwerkzeugs zu erfüllen.

3. 3

   Kopieren oder Herunterladen

   Klicken Sie auf Kopieren, um das JSON in Ihre Zwischenablage zu übernehmen, oder auf Herunterladen, um es als .json-Datei für jq, API-Aufrufe oder andere Downstream-Werkzeuge zu speichern.

Häufige YAML-Fehler

services:
	web:
		image: nginx:1.25-alpine

services:
  web:
    image: nginx:1.25-alpine

metadata:
  name: my-app
   namespace: production

metadata:
  name: my-app
  namespace: production

url: http://example.com:8080/api
tag: #latest

url: 'http://example.com:8080/api'
tag: '#latest'

# Circular anchor (rare but possible)
base: &base
  parent: *base

# Use explicit fields instead of circular references
base:
  parent: null

# Only the first document is converted
apiVersion: v1
kind: ConfigMap
---
apiVersion: v1
kind: Secret

# Convert each document separately
apiVersion: v1
kind: ConfigMap

# This comment will be lost
replicas: 3 # scale this up for production

replicas: 3
_comment: scale this up for production

Häufige Anwendungsfälle

Kubernetes-Manifest-Analyse

Konvertieren Sie Kubernetes-YAML-Manifeste nach JSON für Abfragen mit jq, das Senden an die Kubernetes-REST-API, die Verarbeitung in Terraform-Datenquellen oder das Einspeisen in CI/CD-Pipelines, die JSON erwarten.

Docker Compose zu JavaScript-Werkzeugen

Parsen Sie Docker-Compose-YAML nach JSON, um Service-Definitionen, Image-Namen, Port-Mappings und Umgebungsvariablen für Automatisierungsskripte, Abhängigkeitsgraphen oder Node.js-Werkzeuge zu extrahieren.

GitHub-Actions-API-Integration

Konvertieren Sie GitHub-Actions-Workflow-YAML nach JSON, um die Struktur programmatisch zu validieren, Job- und Schritt-Definitionen zu extrahieren oder mit CI/CD-APIs zu integrieren, die JSON-Workflow-Spezifikationen akzeptieren.

OpenAPI zu Client-Code-Generierung

Viele Code-Generatoren (openapi-generator, swagger-codegen, oazapfts) akzeptieren OpenAPI-Spezifikationen in beiden Formaten. Konvertieren Sie Ihre YAML-Spezifikation nach JSON, wenn ein Werkzeug speziell JSON-Eingabe erfordert oder wenn Sie es mit JSON-Schema-Validatoren überprüfen müssen.

Helm-Werte-Analyse

Konvertieren Sie Helm-Chart-values.yaml nach JSON, um Berichte zu erstellen, Werte über verschiedene Umgebungen zu vergleichen, in Richtlinien-Durchsetzungswerkzeuge einzuspeisen oder mit Automatisierung zu verarbeiten, die JSON-Konfiguration erwartet.

Konfigurationsmigration zu JSON-basierten Werkzeugen

Migrieren Sie Anwendungskonfigurationen von YAML (in Infrastrukturwerkzeugen verbreitet) nach JSON für die Verwendung in JavaScript-Umgebungen, REST-APIs, AWS AppConfig, Azure App Configuration oder einem beliebigen System, das Konfiguration als JSON speichert.

Technische Details

YAML-1.2-Spezifikation über parseAllDocuments mit merge:true

YAML wird mit der eemeli/yaml-Bibliothek (v2.8+, CVE-sicher) über parseAllDocuments mit { version: '1.2', merge: true } geparst. Das YAML-1.2-Schema stellt sicher, dass nackte Zeichenketten wie yes und no als Zeichenketten behandelt werden (nicht als boolesche Werte), was der aktuellen YAML-Spezifikation entspricht. Die merge: true-Option expandiert Anker/Alias-Merge-Schlüssel (<<: *Anker) vollständig, sodass die JSON-Ausgabe vollständige, dereferenzierte Daten enthält. Multi-Dokument-YAML (durch --- getrennt) gibt das erste Dokument zurück.

Anker- und Alias-Expansion über Bibliothek

Die eemeli/yaml-Bibliothek behandelt die Anker (&Name) und Alias (*Name) Expansion sicher, einschließlich Zirkelreferenz-Erkennung. Alle referenzierten Datenblöcke — einschließlich Merge-Schlüssel-Expansionen — werden vollständig in der JSON-Ausgabe inline eingebettet. Dies ist die korrekte Transformation, da JSON kein Referenz- oder Ankerkonzept hat.

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

YAML-1.2-kompatible Syntax für saubere Konvertierung verwenden

Verfassen Sie Ihr YAML mit YAML-1.2-Konventionen — setzen Sie yes, no, on, off, y und n als Zeichenkettenwerte explizit in Anführungszeichen (z. B. enabled: 'yes'), um Mehrdeutigkeiten zu vermeiden. Dieses Werkzeug parst mit dem YAML-1.2-Schema (also sind es Zeichenketten), aber ältere Werkzeuge in Ihrer Pipeline verwenden möglicherweise YAML 1.1 (bei dem sie boolesche Werte werden). Explizites Anführungszeichen im YAML-Quellcode ist die sicherste Praxis über alle Parser hinweg.

Große Zahlen in YAML anführen, um Präzision zu erhalten

JavaScript kann Ganzzahlen, die größer als 2^53 - 1 (9007199254740991) sind, nicht exakt darstellen. Kubernetes-Felder wie resourceVersion und uid sind auf dem Server int64 und können dieses Limit überschreiten. Setzen Sie diese Werte in Ihrer YAML-Quelle in Anführungszeichen (resourceVersion: '9007199254740993'), damit der Parser sie als Zeichenketten behandelt, die dann exakt in der JSON-Ausgabe als Zeichenkettenwerte erhalten bleiben.

JSON-Ausgabe vor der Verwendung in APIs validieren

Validieren Sie nach der Konvertierung von YAML nach JSON das Ergebnis, bevor Sie es an eine API senden, speichern oder programmatisch verarbeiten. Verwenden Sie unseren JSON-Formatierer, um zu bestätigen, dass die Struktur korrekt ist. Dies ist besonders wichtig für Kubernetes-API-Aufrufe, OpenAPI-Spezifikationen und JSON-Schema-validierte Payloads.

Multi-Dokument-YAML vor der Konvertierung trennen

Wenn Ihre YAML-Datei mehrere durch --- getrennte Dokumente enthält und Sie alle als JSON benötigen, teilen Sie die Datei zuerst bei --- und konvertieren Sie jedes Dokument einzeln. Dieses Werkzeug nimmt nur das erste Dokument. Ein einfacher Ansatz: Bei '\n---\n' in Ihrem Editor oder mit awk aufteilen und dann jeden Abschnitt separat einfügen.

jq für nachgelagerte JSON-Verarbeitung verwenden

Sobald Sie JSON aus Ihrem YAML haben, ist jq der schnellste Weg, es über die Befehlszeile abzufragen und zu transformieren. Kombinieren Sie dieses Werkzeug mit jq: Konvertieren Sie Ihr YAML online, fügen Sie das JSON ein, und verwenden Sie dann jq '.spec.replicas' oder jq '.services | keys', um genau das zu extrahieren, was Sie benötigen. Für die Stapelverarbeitung vieler Dateien verwenden Sie das yq-CLI mit dem -o-json-Flag direkt.

Häufig gestellte Fragen