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

The Pod "" is invalid: metadata.name: Required value: name or generateName is required

Pe scurt

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

Greșit
YAML
apiVersion: v1
kind: Pod
spec:
  containers: ...
Corect
YAML
apiVersion: v1
kind: Pod
metadata:
  name: web
spec:
  containers: ...

metadata.name e obligatoriu.

2name indentat sub labels

Greșit
YAML
metadata:
  labels:
    app: web
    name: web
Corect
YAML
metadata:
  name: web
  labels:
    app: web

Sub labels, name devine o etichetă, nu numele obiectului.

3generateName cu apply

Greșit
YAML
metadata:
  generateName: raport-
# kubectl apply -f job.yaml
Corect
YAML
kubectl create -f job.yaml

apply are nevoie de un nume fix ca să poată urmări obiectul; create acceptă generateName.

Repară tu

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.

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.name imediat 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 și annotations stau 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

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