Startseite › Entwickler-Tools › Kubernetes YAML Validator

Kubernetes YAML Validator

Füge ein oder mehrere Kubernetes-Manifeste ein und wähle deine Clusterversion. Jedes Dokument wird auf YAML-Syntax, entfernte oder veraltete apiVersions, unbekannte oder falsch geschriebene Felder, falsche Werttypen, Pflichtfelder und häufige Fehler geprüft, etwa einen Selector, der nicht zu den Pod-Labels passt. Jedes Problem zeigt seine Zeile und seinen Feldpfad.

Zuletzt aktualisiert:

Z. 1, Sp. 1

Die Prüfungen laufen in deinem Browser gegen ein eingebautes Schema der Kubernetes-Kernressourcen. Custom Resources (CRDs) werden aufgeführt, aber nicht geprüft.

Anzeige
Anzeige

Anleitung: Kubernetes YAML Validator

  1. Füge deine Manifeste ein oder öffne eine .yaml-Datei. Mehrere durch --- getrennte Dokumente sind kein Problem.
  2. Wähle deine Kubernetes-Version, damit entfernte und neue APIs richtig bewertet werden.
  3. Lies die Zusammenfassung: Jedes Dokument wird als gültig, mit Warnungen, mit Fehlern oder nicht geprüft (Custom Resources) angezeigt.
  4. Klicke auf ein Problem, um im Editor zu seiner Zeile zu springen. Fehlerzeilen sind auch in den Zeilennummern rot markiert.
  5. Korrigieren und erneut prüfen. Die Validierung läuft beim Tippen erneut; kopiere den Bericht, um ihn in einem Review zu teilen.

Häufige Fehler in Kubernetes-YAML

Du hast geschriebenWas passiertLösung
replicas: "3"Abgelehnt: replicas muss eine Ganzzahl seinreplicas: 3
value: 8080 unter envAbgelehnt: env-Werte sind Stringsvalue: "8080"
Label version: 1.10Wird als Zahl 1.1 gelesen und dann abgelehntversion: "1.10"
enabled: on in einer ConfigMapYAML 1.1 liest on als true, in data abgelehntenabled: "on"
memory: 512MBUngültige Mengenangabememory: 512Mi (oder 512M)
contianerPort: 80Unbekanntes Feld: im strikten Modus abgelehnt, sonst stillschweigend verworfencontainerPort: 80
Selector app: web, Pod-Label app: websiteDeployment abgelehnt: Selector passt nicht zum TemplateAn beiden Stellen dieselben Labels verwenden
type: ClusterIpNicht unterstützter Wert (Groß-/Kleinschreibung zählt)type: ClusterIP
serviceName / servicePort in einem IngressAlte v1beta1-Syntax, in 1.22 entferntservice: {name: web, port: {number: 80}} und pathType

Aktuelle apiVersion je Kind

KindVerwendenEntfernte Versionen
Deployment, StatefulSet, DaemonSet, ReplicaSetapps/v1extensions/v1beta1, apps/v1beta1, apps/v1beta2 (seit 1.16)
Ingress, IngressClassnetworking.k8s.io/v1extensions/v1beta1, networking.k8s.io/v1beta1 (seit 1.22)
CronJobbatch/v1batch/v1beta1 (1.25)
HorizontalPodAutoscalerautoscaling/v2v2beta1 (1.25), v2beta2 (1.26)
PodDisruptionBudgetpolicy/v1policy/v1beta1 (1.25)
Role, ClusterRole, RoleBinding, ClusterRoleBindingrbac.authorization.k8s.io/v1v1beta1 (1.22)
CustomResourceDefinitionapiextensions.k8s.io/v1v1beta1 (1.22)
Pod, Service, ConfigMap, Secret, PVC, Namespace, ServiceAccountv1(nie geändert)

Tipps

  • Validiere auch gegen einen Cluster: kubectl apply --dry-run=server -f file.yaml führt zusätzlich Admission Webhooks und Richtlinien aus.
  • Setze alles in Anführungszeichen, was nicht absichtlich eine Zahl oder ein Boolean ist, besonders Versionen, Ports in Umgebungsvariablen und Wörter wie yes, no, on und off.
  • Erzeuge einen korrekten Ausgangspunkt mit dem Kubernetes-YAML-Generator oder wandle eine bestehende Compose-Datei mit dem Konverter Docker Compose in Kubernetes um.

Häufige Fragen

Was prüft dieser Kubernetes-YAML-Validator?

Zuerst die YAML-Syntax nach den YAML-1.1-Regeln wie beim Kubernetes-API-Server. Dann wird jedes Objekt gegen ein Schema seines Kinds und seiner apiVersion geprüft: unbekannte Felder, Pflichtfelder, Werttypen und erlaubte Werte. Zum Schluss laufen Prüfungen, die der API-Server bei der Validierung durchführt, etwa ein Deployment-Selector, der zu den Labels des Pod-Templates passen muss, oder ein volumeMount, der auf ein definiertes Volume verweisen muss.

Warum ist replicas: "3" ein Fehler?

Kubernetes-Felder sind streng typisiert. replicas ist eine Ganzzahl, daher lehnt der API-Server den String "3" in Anführungszeichen ab. Das Gegenteil ist ebenfalls häufig: Werte von Umgebungsvariablen und Labels müssen Strings sein, daher brauchen value: 4 oder version: 1.2 Anführungszeichen.

Welche apiVersions wurden entfernt?

Wichtige Entfernungen: Deployments, DaemonSets und ReplicaSets unter extensions/v1beta1 und apps/v1beta1/v1beta2 in 1.16; Ingress unter extensions/v1beta1 und networking.k8s.io/v1beta1 sowie rbac v1beta1 und apiextensions v1beta1 in 1.22; batch/v1beta1 CronJob, policy/v1beta1 PodDisruptionBudget und PodSecurityPolicy in 1.25; autoscaling/v2beta2 in 1.26; flowcontrol v1beta3 in 1.32. Wähle deine Version, um zu sehen, ob ein Manifest betroffen ist.

Was ist der strikte Modus?

Seit Kubernetes 1.25 kann der API-Server unbekannte oder doppelte Felder ablehnen, und aktuelle kubectl-Versionen validieren standardmäßig strikt. Ein falsch geschriebenes Feld wie contianerPort wird sonst stillschweigend verworfen, sodass die gewünschte Einstellung nie greift. Schalte den strikten Modus aus, um unbekannte Felder stattdessen als Warnungen zu melden.

Werden Custom Resources (CRDs) validiert?

Custom Resources wie cert-manager Certificates oder Argo CD Applications werden als gültiges YAML erkannt, ihre Felder aber nicht geprüft, weil ihre Schemas in den CRDs deines Clusters liegen. Verwende dafür kubectl apply --dry-run=server gegen einen Cluster.

Ist das dasselbe wie kubectl apply --dry-run?

Es deckt dasselbe Schema und viele derselben Validierungsregeln ab, läuft aber offline, ohne Cluster. Serverseitige Dry Runs wenden zusätzlich Admission Webhooks, Quotas und Richtlinien deines Clusters an und können daher ein Manifest ablehnen, das hier besteht.

Werden meine Manifeste hochgeladen?

Nein. Parsen und Validieren laufen in JavaScript in deinem Browser; nur die Open-Source-YAML-Parser-Bibliothek wird heruntergeladen. Secrets und interne Namen in deinen Manifesten bleiben auf deinem Computer.

Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?

Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.

Ähnliche Tools

Alle Code-Generatoren & Builder ansehen →