The Pod "" is invalid: metadata.name: Required value: name or generateName is required
Manifestul nu are metadata.name, deci obiectul nu are nume. Adaugă metadata: name: web (sau metadata.generateName pentru nume generate la kubectl create). Verifică și indentarea: name trebuie să fie sub metadata.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Orice obiect Kubernetes are nevoie de un nume unic în namespace pentru tipul lui. Ghilimelele goale din The Pod "" îți spun deja că numele lipsește. Poți da numele explicit (metadata.name) sau un prefix (metadata.generateName: raport-), la care serverul adaugă un sufix aleator; al doilea merge doar cu kubectl create, nu cu apply.
Cauzele tipice: ai uitat metadata cu totul, name e indentat greșit (de exemplu sub labels, unde devine o etichetă), sau un șablon Helm a produs un nume gol.
Dacă name apare indentat sub labels, kubectl nu dă eroare de câmp necunoscut, ci creează eticheta name, și abia apoi serverul spune că lipsește numele.
De ce apare: cauzele frecvente
1Lipsește metadata
apiVersion: v1
kind: Pod
spec:
containers: ...apiVersion: v1
kind: Pod
metadata:
name: web
spec:
containers: ...metadata.name e obligatoriu.
2name indentat sub labels
metadata:
labels:
app: web
name: webmetadata:
name: web
labels:
app: webSub labels, name devine o etichetă, nu numele obiectului.
3generateName cu apply
metadata:
generateName: raport-
# kubectl apply -f job.yamlkubectl create -f job.yamlapply are nevoie de un nume fix ca să poată urmări obiectul; create acceptă generateName.
Repară eroarea, direct în pagină
Manifestul ~/k8s/raport.yaml al unui pod de rapoarte are name: raport pus din greșeală sub labels, iar kubectl apply dă name or generateName is required. Fă din raport numele podului (direct sub metadata), păstrând eticheta app: raport, și aplică fișierul.
Indiciu
name trebuie să fie la același nivel cu labels, nu în interiorul lui.
Reparația
Validarea eșuează:
kubectl apply -f raport.yaml || trueError from server (Invalid): error when creating "raport.yaml": The Pod "" is invalid: metadata.name: Required value: name or generateName is requiredNumele la locul lui:
Fișierul raport.yaml:
apiVersion: v1
kind: Pod
metadata:
name: raport
labels:
app: raport
spec:
containers:
- name: raport
image: nginx:1.27kubectl apply -f raport.yaml
kubectl get pod raport --show-labelspod/raport created
NAME READY STATUS RESTARTS AGE LABELS
raport 0/1 ContainerCreating 0 2s app=raportDe ce merge
Sub labels, name: raport devine o etichetă, iar podul rămâne fără nume, pe care serverul îl cere. Mutat direct sub metadata, devine numele obiectului. Eticheta app: raport rămâne, ca selectorii să găsească podul. kubectl get pod raport --show-labels confirmă ambele lucruri.
Alte forme ale mesajului
error: error when retrieving current configuration of: ... from server for: "job.yaml": resource name may not be empty
Cum o eviți pe viitor
- Pune
metadata.nameimediat dupăkindîn fiecare manifest. - În charturi Helm, construiește numele din
include "chart.fullname", nu din valori care pot lipsi. - Verifică indentarea sub
metadata:name,namespace,labelsșiannotationsstau la același nivel. - Validează fișierele cu
kubectl apply --dry-run=server -f.
Întrebări frecvente
Când folosesc generateName?
Pentru obiecte create de multe ori din același fișier, ca Job-uri de testare sau poduri temporare. Cu kubectl create -f, fiecare rulare primește alt nume.
De ce mesajul spune Pod ""?
Pentru că serverul afișează numele obiectului, iar acesta e gol. E un indiciu direct că problema e în metadata.
Erori înrudite
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. The Deployment "Web_App" is invalid: metadata.name: Invalid value: "Web_App": a lowercase RFC 1123 subdomain must consist of lower case alphanumeric characters, '-' or '.', and must start and end with an alphanumeric character Numele obiectului nu respectă regulile Kubernetes: doar litere mici, cifre, - și ., începând și terminând cu literă sau cifră. Înlocuiește majusculele și underscore-ul: Web_App devine web-app. error: error validating "cm.yaml": error validating data: kind not set; if you choose to ignore these errors, turn validation off with --validate=false Manifestul nu spune ce fel de obiect este: lipsește câmpul kind sau e scris greșit. Adaugă kind: ConfigMap (Pod, Deployment, Service etc.), cu majuscula exactă, sub apiVersion. Î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.
