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

The Pod "p" is invalid: spec.containers[0].name: Required value

Pe scurt

Containerul nu are câmpul name, obligatoriu pentru fiecare container. Adaugă - name: web (litere mici, cifre, -) la începutul containerului și aplică din nou.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Fiecare container dintr-un pod trebuie să aibă un nume unic în pod: kubectl îl folosește la logs -c, exec -c, iar kubelet-ul la reporniri și stări. API server-ul verifică asta și dă calea exactă a câmpului lipsă: spec.containers[0].name (primul container), spec.template.spec.containers[1].name (al doilea container dintr-un Deployment).

De obicei numele lipsește pentru că ai scris direct - image: ... sau pentru că o indentare greșită a mutat name în alt loc. Mesajul mai poate avea forma Required value pentru image, dacă lipsește imaginea.

Numele containerului e independent de numele podului și al imaginii; convenția e să fie scurt și descriptiv (app, web, colector).

De ce apare: cauzele frecvente

1Container fără name

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

name e obligatoriu pentru fiecare container.

2Două containere cu același nume

Greșit
YAML
  - name: app
    image: nginx:1.27
  - name: app
    image: busybox:1.36
Corect
YAML
  - name: app
    image: nginx:1.27
  - name: colector
    image: busybox:1.36

Numele trebuie să fie unice în pod (altfel apare Duplicate value).

Repară tu

Repară eroarea, direct în pagină

Manifestul ~/k8s/p.yaml pentru podul p (un server web de test) are containerul fără nume, iar kubectl apply dă spec.containers[0].name: Required value. Dă containerului numele web și aplică fișierul.

Indiciu

- name: web deschide containerul, iar image vine sub el, aliniat.

Alte forme ale mesajului

  • The Deployment "web" is invalid: spec.template.spec.containers[0].name: Required value
  • spec.containers[1].name: Duplicate value: "app"
  • spec.containers[0].image: Required value

Cum o eviți pe viitor

  • Generează scheletul cu kubectl run ... --dry-run=client -o yaml: containerul are deja nume.
  • Scrie name primul în fiecare container, ca să vezi imediat dacă lipsește.
  • Alege nume scurte și consecvente pentru containere (app, colector), aceleași în toate serviciile.
  • Validează manifestele cu kubectl apply --dry-run=server -f înainte de livrare.

Întrebări frecvente

Ce nume primește containerul la kubectl create deployment?

Numele derivat din imagine: nginx pentru nginx:1.27, magazin pentru academia/magazin:v1.

Pot schimba numele containerului ulterior?

Într-un Deployment, da: schimbi șablonul și se creează poduri noi. Într-un pod existent nu, numele containerelor nu se modifică.

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.