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

The Deployment "web" is invalid: spec.selector: Required value

Pe scurt

Manifestul Deploymentului nu are spec.selector, care e obligatoriu în apps/v1. Adaugă selector.matchLabels cu aceleași etichete ca în spec.template.metadata.labels (de exemplu app: web).

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

Ce înseamnă

În versiunile vechi (extensions/v1beta1), selectorul unui Deployment se deducea din etichetele șablonului. Din apps/v1 trebuie scris explicit, iar API server-ul respinge manifestul fără el. Mesajul spune calea exactă a câmpului lipsă: spec.selector.

De obicei apare la manifeste scrise de mână după un tutorial vechi, la copierea unui Pod în interiorul unui Deployment sau când indentarea greșită a mutat selector în alt loc (de exemplu sub template), unde e ignorat ca necunoscut sau dă altă eroare.

Selectorul trebuie să se potrivească cu etichetele șablonului, altfel urmează eroarea selector does not match template labels.

De ce apare: cauzele frecvente

1Selector lipsă

Greșit
YAML
spec:
  replicas: 2
  template:
    metadata:
      labels:
        app: web
Corect
YAML
spec:
  replicas: 2
  selector:
    matchLabels:
      app: web
  template:
    metadata:
      labels:
        app: web

apps/v1 cere selectorul explicit.

2Selector pus în locul greșit

Greșit
YAML
  template:
    selector:
      matchLabels:
        app: web
Corect
YAML
  selector:
    matchLabels:
      app: web
  template:

selector aparține de spec, la același nivel cu template și replicas.

Repară tu

Repară eroarea, direct în pagină

Manifestul ~/k8s/web.yaml al unui blog culinar, scris după un tutorial vechi, nu are selector, iar kubectl apply dă spec.selector: Required value. Adaugă selectorul matchLabels: app: web sub spec și aplică fișierul.

Indiciu

selector stă sub spec, la același nivel cu replicas și template.

Alte forme ale mesajului

  • The StatefulSet "db" is invalid: spec.selector: Required value
  • error validating data: ValidationError(Deployment.spec): missing required field "selector" in io.k8s.api.apps.v1.DeploymentSpec

Cum o eviți pe viitor

  • Pornește de la un schelet generat: kubectl create deployment web --image=nginx:1.27 --dry-run=client -o yaml.
  • Verifică structura cu kubectl explain deployment.spec când nu știi unde stă un câmp.
  • Validează fișierul cu kubectl apply --dry-run=server -f înainte să-l pui în git.

Întrebări frecvente

De ce tutorialele vechi nu au selector?

Pentru că foloseau extensions/v1beta1 sau apps/v1beta1, unde selectorul era opțional. Aceste versiuni au fost scoase în Kubernetes 1.16.

Ce câmpuri sunt obligatorii într-un Deployment?

apiVersion, kind, metadata.name, spec.selector, spec.template cu etichete și cel puțin un container cu name și image.

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.