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:
Die Prüfungen laufen in deinem Browser gegen ein eingebautes Schema der Kubernetes-Kernressourcen. Custom Resources (CRDs) werden aufgeführt, aber nicht geprüft.
Anleitung: Kubernetes YAML Validator
- Füge deine Manifeste ein oder öffne eine .yaml-Datei. Mehrere durch
---getrennte Dokumente sind kein Problem. - Wähle deine Kubernetes-Version, damit entfernte und neue APIs richtig bewertet werden.
- Lies die Zusammenfassung: Jedes Dokument wird als gültig, mit Warnungen, mit Fehlern oder nicht geprüft (Custom Resources) angezeigt.
- Klicke auf ein Problem, um im Editor zu seiner Zeile zu springen. Fehlerzeilen sind auch in den Zeilennummern rot markiert.
- 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 geschrieben | Was passiert | Lösung |
|---|---|---|
replicas: "3" | Abgelehnt: replicas muss eine Ganzzahl sein | replicas: 3 |
value: 8080 unter env | Abgelehnt: env-Werte sind Strings | value: "8080" |
Label version: 1.10 | Wird als Zahl 1.1 gelesen und dann abgelehnt | version: "1.10" |
enabled: on in einer ConfigMap | YAML 1.1 liest on als true, in data abgelehnt | enabled: "on" |
memory: 512MB | Ungültige Mengenangabe | memory: 512Mi (oder 512M) |
contianerPort: 80 | Unbekanntes Feld: im strikten Modus abgelehnt, sonst stillschweigend verworfen | containerPort: 80 |
Selector app: web, Pod-Label app: website | Deployment abgelehnt: Selector passt nicht zum Template | An beiden Stellen dieselben Labels verwenden |
type: ClusterIp | Nicht unterstützter Wert (Groß-/Kleinschreibung zählt) | type: ClusterIP |
serviceName / servicePort in einem Ingress | Alte v1beta1-Syntax, in 1.22 entfernt | service: {name: web, port: {number: 80}} und pathType |
Aktuelle apiVersion je Kind
| Kind | Verwenden | Entfernte Versionen |
|---|---|---|
| Deployment, StatefulSet, DaemonSet, ReplicaSet | apps/v1 | extensions/v1beta1, apps/v1beta1, apps/v1beta2 (seit 1.16) |
| Ingress, IngressClass | networking.k8s.io/v1 | extensions/v1beta1, networking.k8s.io/v1beta1 (seit 1.22) |
| CronJob | batch/v1 | batch/v1beta1 (1.25) |
| HorizontalPodAutoscaler | autoscaling/v2 | v2beta1 (1.25), v2beta2 (1.26) |
| PodDisruptionBudget | policy/v1 | policy/v1beta1 (1.25) |
| Role, ClusterRole, RoleBinding, ClusterRoleBinding | rbac.authorization.k8s.io/v1 | v1beta1 (1.22) |
| CustomResourceDefinition | apiextensions.k8s.io/v1 | v1beta1 (1.22) |
| Pod, Service, ConfigMap, Secret, PVC, Namespace, ServiceAccount | v1 | (nie geändert) |
Tipps
- Validiere auch gegen einen Cluster:
kubectl apply --dry-run=server -f file.yamlfü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.