Error from server (BadRequest): error when creating "web.yaml": Deployment in version "v1" cannot be handled as a Deployment: strict decoding error: unknown field "spec.template.spec.containers[0].imagePullPolicyy"
Manifestul are un câmp pe care API-ul nu îl cunoaște: o greșeală de tastare (imagePullPolicyy) sau un câmp pus la nivelul greșit de indentare. Corectează numele sau mută câmpul, verificând cu kubectl explain.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Din Kubernetes 1.25, kubectl cere serverului validare strictă: orice câmp necunoscut oprește cererea, în loc să fie ignorat în tăcere. Mesajul dă calea completă a câmpului, de exemplu spec.template.spec.containers[0].imagePullPolicyy.
Două cauze dau aproape toate cazurile. Prima: numele e scris greșit (o literă în plus, containerport în loc de containerPort, câmpurile sunt camelCase). A doua: câmpul e corect, dar stă la alt nivel de indentare, iar calea arată unde a ajuns: unknown field "metadata.spec" înseamnă că spec a fost indentat sub metadata; unknown field "spec.containers" într-un Deployment înseamnă că lipsește nivelul template.spec.
kubectl explain pod.spec.containers îți arată câmpurile valide la fiecare nivel.
De ce apare: cauzele frecvente
1Literă în plus
imagePullPolicyy: IfNotPresent imagePullPolicy: IfNotPresentCâmpul se numește imagePullPolicy.
2spec indentat sub metadata
metadata:
name: p
spec:
containers: ...metadata:
name: p
spec:
containers: ...Indentarea pune spec în interiorul lui metadata, unde nu există un astfel de câmp.
3Litere mici în loc de camelCase
ports:
- containerport: 80 ports:
- containerPort: 80Numele câmpurilor țin cont de majuscule.
Repară eroarea, direct în pagină
În ~/k8s/web.yaml (site-ul unei florării) câmpul imagePullPolicy e scris greșit, iar kubectl apply dă strict decoding error: unknown field. Corectează numele câmpului, păstrând valoarea IfNotPresent, și aplică fișierul.
Indiciu
Calea din mesaj îți arată exact câmpul; numele corect are un singur y.
Reparația
Validarea eșuează:
kubectl apply -f web.yaml || trueError from server (BadRequest): error when creating "web.yaml": Deployment in version "v1" cannot be handled as a Deployment: strict decoding error: unknown field "spec.template.spec.containers[0].imagePullPolicyy"Corectează numele și aplică:
sed -i 's/imagePullPolicyy/imagePullPolicy/' web.yaml
kubectl apply -f web.yaml
kubectl get deploy web -o jsonpath='{.spec.template.spec.containers[0].imagePullPolicy}'
echodeployment.apps/web created
IfNotPresentDe ce merge
Cu validarea strictă, API server-ul refuză orice câmp pe care nu îl cunoaște, ca să nu ignore în tăcere setări greșite. După corectare, imagePullPolicy: IfNotPresent e un câmp valid al containerului, iar Deploymentul e creat. kubectl explain pod.spec.containers îți listează toate câmpurile permise.
Alte forme ale mesajului
Error from server (BadRequest): error when creating "d.yaml": Pod in version "v1" cannot be handled as a Pod: strict decoding error: unknown field "metadata.spec", unknown field "metadata.containers"Warning: unknown field "spec.template.spec.containers[0].imagePullPolicyy"
Cum o eviți pe viitor
- Folosește un editor cu schema Kubernetes (extensia YAML din VS Code): subliniază câmpurile necunoscute pe loc.
- Verifică numele câmpurilor cu
kubectl explain. - Rulează
kubectl apply --dry-run=server -fîn pipeline, înainte de livrare. - Nu dezactiva validarea cu
--validate=false: problema rămâne, doar că nu o mai vezi.
Întrebări frecvente
De ce înainte mergea și acum nu?
Versiunile vechi ignorau câmpurile necunoscute, iar greșeala trecea neobservată (setarea pur și simplu nu se aplica). Din 1.25 validarea strictă e implicită.
Ce înseamnă câmpul cu Warning: în loc de eroare?
Cu --validate=warn, kubectl doar avertizează și aplică manifestul fără câmpul necunoscut. Implicit (strict) refuză.
Erori înrudite
error: error parsing web.yaml: error converting YAML to JSON: yaml: line 11: mapping values are not allowed in this context YAML-ul are pe linia indicată un : nepermis: de obicei o valoare care conține „: ” fără ghilimele (Luni-Vineri: 9-18) sau o indentare greșită. Pune valoarea între ghilimele sau corectează indentarea și aplică din nou. Pod in version "v1" cannot be handled as a Pod: json: cannot unmarshal object into Go struct field PodSpec.spec.containers of type array Un câmp care trebuie să fie listă (containers, ports, env, volumes) a fost scris ca obiect, fără liniuța - în fața elementului. Adaugă - la primul câmp al fiecărui element: - name: web. error: error validating "job.yaml": error validating data: apiVersion not set; if you choose to ignore these errors, turn validation off with --validate=false Manifestul nu are câmpul apiVersion (sau e indentat greșit), deci kubectl nu știe în ce grup al API-ului e obiectul. Adaugă pe prima linie versiunea corectă: v1 pentru Pod/Service/ConfigMap, apps/v1 pentru Deployment, batch/v1 pentru Job și CronJob. Învață Kubernetes de la zero, cu exerciții la fiecare lecție
Curs Kubernetes: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 12 lecții sunt gratuite.
