JSON zu Kubernetes-YAML

kubectl-JSON-Ausgabe und API-Objekte in saubere Manifeste umwandeln, die Sie prüfen und anwenden können.

Ausgabeoptionen

JSONEingabe

Leer

YAMLAusgabe

Die YAML-Ausgabe erscheint hier

Läuft vollständig in Ihrem Browser: nichts wird hochgeladen. Es gelten Fair-Use-Limits (5 MB pro Eingabe, begrenzte Anzahl an Konvertierungen), um Spam und Bots zu verhindern.

Von URL laden

Die Datei wird direkt von Ihrem Browser abgerufen, daher muss der Server Cross-Origin-Anfragen zulassen.

Tastenkürzel

Ctrl / ⌘ + Enter Jetzt konvertieren
Ctrl / ⌘ + S Ausgabe herunterladen
Alt + Shift + C Ausgabe kopieren
Alt + Shift + F JSON-Eingabe reparieren und formatieren
Alt + Shift + S Richtung umkehren
Alt + Shift + T Zwischen Code-, Baum- und Zuordnungsansicht wechseln
Ctrl / ⌘ + Z Rückgängig, auch nach Formatieren, Reparieren und Leeren
Esc Vollbild verlassen
Textgröße im Editor

Vom kubectl-JSON zum sauberen Manifest

Exportierte Objekte enthalten Status- und Verwaltungsfelder, die der Cluster selbst setzt. Entfernen Sie diese zuerst und konvertieren Sie dann, und das Ergebnis lässt sich überall anwenden.

bash
# Export a live object as JSON and strip the fields the cluster manages
kubectl get deployment web -o json \
  | jq 'del(.status, .metadata.uid, .metadata.resourceVersion,
            .metadata.creationTimestamp, .metadata.generation,
            .metadata.managedFields)' > web.json

Fügen Sie web.json oben ein oder laden Sie die Datei hoch.

Umgebungswerte bleiben Zeichenketten

Der API-Server lehnt einen env-Wert ab, der keine Zeichenkette ist. Werte, die wie Booleans, Zahlen oder Versionen aussehen, werden automatisch in Anführungszeichen gesetzt.

JSON
{
  "env": [
    {
      "name": "FEATURE_FLAG",
      "value": "true"
    },
    {
      "name": "PORT",
      "value": "8080"
    },
    {
      "name": "REGION",
      "value": "no"
    },
    {
      "name": "API_VERSION",
      "value": "1.20"
    }
  ]
}
YAML
env:
  - name: FEATURE_FLAG
    value: 'true'
  - name: PORT
    value: '8080'
  - name: REGION
    value: 'no'
  - name: API_VERSION
    value: '1.20'

Schalten Sie YAML 1.1-sicher aus, um zu sehen, welche Werte ein YAML 1.1-Parser falsch lesen würde.

Ein Objekt pro Dokument

Fügen Sie das items-Array einer kubectl-List ein und aktivieren Sie „Multi-Dokument“, um eine einzige Datei mit --- zwischen den Objekten zu erhalten.

items (JSON)
[
  {
    "apiVersion": "v1",
    "kind": "ConfigMap",
    "metadata": {
      "name": "web-config"
    },
    "data": {
      "LOG_LEVEL": "info"
    }
  },
  {
    "apiVersion": "v1",
    "kind": "Service",
    "metadata": {
      "name": "web"
    },
    "spec": {
      "selector": {
        "app": "web"
      },
      "ports": [
        {
          "port": 80
        }
      ]
    }
  }
]
manifests.yaml
---
apiVersion: v1
kind: ConfigMap
metadata:
  name: web-config
data:
  LOG_LEVEL: info
---
apiVersion: v1
kind: Service
metadata:
  name: web
spec:
  selector:
    app: web
  ports:
    - port: 80

Weitere Tools

Konverter, Validatoren und Schritt-für-Schritt-Anleitungen für alle Stellen, an denen JSON und YAML aufeinandertreffen.

Häufig gestellte Fragen

Wie konvertiere ich Kubernetes-JSON in YAML?

Fügen Sie das JSON-Objekt in den Editor ein, zum Beispiel die Ausgabe von kubectl get deployment web -o json. Das YAML-Manifest erscheint rechts. Entfernen Sie vom Cluster verwaltete Felder wie status und metadata.managedFields, bevor Sie es auf einen anderen Cluster anwenden.

Wie mache ich aus einer kubectl-List separate Manifeste?

kubectl get mit mehreren Objekten gibt {"kind": "List", "items": [...]} zurück. Fügen Sie nur das items-Array ein und aktivieren Sie „Multi-Dokument“: Jedes Objekt wird zu einem eigenen Dokument, getrennt durch ---, dem üblichen Aufbau einer Manifest-Datei.

Warum stehen manche Werte von Umgebungsvariablen in Anführungszeichen?

Kubernetes verlangt, dass env-Werte Zeichenketten sind. Ohne Anführungszeichen würden true, 8080 oder no als Boolean oder Zahl gelesen, und der API-Server würde das Manifest ablehnen. Der Konverter setzt jede Zeichenkette in Anführungszeichen, die missverstanden werden könnte, sodass das YAML genau das bedeutet, was das JSON bedeutete.

Kann kubectl JSON direkt anwenden?

Ja, kubectl apply -f akzeptiert JSON ebenso wie YAML. Teams konvertieren trotzdem in YAML, weil es sich in Pull Requests leichter prüfen lässt, Kommentare unterstützt und das Format ist, das Helm-Charts und Kustomize-Overlays erwarten.

Prüft der Konverter mein Manifest gegen die Kubernetes-API?

Nein, er konvertiert nur die Syntax. Führen Sie kubectl apply --dry-run=server -f manifest.yaml aus, damit der API-Server Felder und Typen validiert, ohne etwas zu ändern.