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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În API, containers, ports, env, volumes, volumeMounts și multe altele sunt liste, chiar dacă au un singur element. În YAML, elementele de listă încep cu - . Dacă uiți liniuța, YAML creează un obiect (dicționar) în loc de listă, iar serverul refuză: a primit object acolo unde aștepta array.
Mesajul arată exact câmpul: PodSpec.spec.containers, Container.spec.containers.ports, Container.spec.containers.env. Uneori, dacă lipsesc liniuțele la mai multe elemente, YAML-ul nici nu mai e valid și apare o eroare de parsare.
Opusul (cannot unmarshal array into ... of type ...) apare când pui liniuță la un câmp care e obiect, de exemplu resources.
De ce apare: cauzele frecvente
1containers fără liniuță
containers:
name: web
image: nginx:1.27 containers:
- name: web
image: nginx:1.27Liniuța face din container un element al listei.
2env fără liniuță
env:
name: ORAS
value: Iasi env:
- name: ORAS
value: Iasienv e o listă de perechi name/value.
3Liniuță pusă la un obiect
resources:
- limits:
memory: 256Mi resources:
limits:
memory: 256Miresources e obiect, nu listă; liniuța dă eroarea inversă.
Repară eroarea, direct în pagină
În ~/k8s/web.yaml (podul web al unui muzeu) containerul e scris fără liniuță sub containers, iar kubectl apply dă cannot unmarshal object into Go struct field PodSpec.spec.containers of type array. Repară lista și aplică fișierul.
Indiciu
Primul câmp al containerului (name) trebuie să fie precedat de - .
Reparația
Serverul respinge structura:
kubectl apply -f web.yaml || trueError from server (BadRequest): error when creating "web.yaml": Pod in version "v1" cannot be handled as a Pod: json: cannot unmarshal object into Go struct field PodSpec.spec.containers of type arrayLiniuța pentru elementul listei:
sed -i 's/^ name: web/ - name: web/' web.yaml
cat web.yaml
kubectl apply -f web.yamlapiVersion: v1
kind: Pod
metadata:
name: web
spec:
containers:
- name: web
image: nginx:1.27
pod/web createdDe ce merge
containers e o listă în API, chiar și cu un singur element. Fără liniuță, YAML produce un obiect, iar serverul nu îl poate transforma în listă. Cu - name: web, containerul devine primul element al listei, iar image rămâne aliniat sub name.
Alte forme ale mesajului
json: cannot unmarshal object into Go struct field Container.spec.containers.ports of type []v1.ContainerPortjson: cannot unmarshal array into Go struct field Container.spec.containers.resources of type v1.ResourceRequirements
Cum o eviți pe viitor
- Ține minte câmpurile-listă des folosite:
containers,initContainers,ports,env,envFrom,volumes,volumeMounts,rules,subjects. kubectl explain pod.spec.containersarată tipul:<[]Container>înseamnă listă.- Folosește un editor cu schema Kubernetes, care semnalează tipul greșit.
- Generează scheletul cu
--dry-run=client -o yamlși completează-l, în loc să scrii structura de la zero.
Întrebări frecvente
De ce e listă chiar dacă am un singur container?
Pentru că un pod poate avea oricâte containere. API-ul folosește aceeași formă indiferent de număr.
Cum recunosc o listă în kubectl explain?
Tipul începe cu [], de exemplu containers <[]Container>. Un obiect apare fără paranteze, de exemplu resources <ResourceRequirements>.
Erori înrudite
error: error parsing web.yaml: error converting YAML to JSON: yaml: line 9: did not find expected '-' indicator Un element dintr-o listă YAML nu e aliniat: parserul aștepta un nou element care începe cu - sau o cheie la același nivel, dar a găsit altă indentare. Aliniază câmpurile containerului (name, image, ports) exact unul sub altul. The Pod "p" is invalid: spec.containers[0].name: Required value Containerul nu are câmpul name, obligatoriu pentru fiecare container. Adaugă - name: web (litere mici, cifre, -) la începutul containerului și aplică din nou. Error from server (BadRequest): error when creating "web.yaml": Pod in version "v1" cannot be handled as a Pod: json: cannot unmarshal string into Go struct field ContainerPort.spec.containers.ports.containerPort of type int32 Un câmp numeric din manifest a primit text: de obicei un port între ghilimele ("8080") sau un nume (http). Scrie numărul fără ghilimele: containerPort: 8080. Î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.
