...
Eroare Kubernetes · Manifeste YAML, apply și câmpuri invalide

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"

Pe scurt

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

Greșit
YAML
    imagePullPolicyy: IfNotPresent
Corect
YAML
    imagePullPolicy: IfNotPresent

Câmpul se numește imagePullPolicy.

2spec indentat sub metadata

Greșit
YAML
metadata:
  name: p
  spec:
    containers: ...
Corect
YAML
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

Greșit
YAML
    ports:
    - containerport: 80
Corect
YAML
    ports:
    - containerPort: 80

Numele câmpurilor țin cont de majuscule.

Repară tu

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.

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

← Toate erorile Kubernetes

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.