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

Pod in version "v1" cannot be handled as a Pod: json: cannot unmarshal object into Go struct field PodSpec.spec.containers of type array

Pe scurt

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ță

Greșit
YAML
  containers:
    name: web
    image: nginx:1.27
Corect
YAML
  containers:
  - name: web
    image: nginx:1.27

Liniuța face din container un element al listei.

2env fără liniuță

Greșit
YAML
    env:
      name: ORAS
      value: Iasi
Corect
YAML
    env:
    - name: ORAS
      value: Iasi

env e o listă de perechi name/value.

3Liniuță pusă la un obiect

Greșit
YAML
    resources:
    - limits:
        memory: 256Mi
Corect
YAML
    resources:
      limits:
        memory: 256Mi

resources e obiect, nu listă; liniuța dă eroarea inversă.

Repară tu

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

Alte forme ale mesajului

  • json: cannot unmarshal object into Go struct field Container.spec.containers.ports of type []v1.ContainerPort
  • json: 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.containers arată 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

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