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

The Deployment "web" is invalid: spec.template.metadata.labels: Invalid value: map[string]string{"app":"site"}: `selector` does not match template `labels`

Pe scurt

Selectorul Deploymentului (spec.selector.matchLabels) cere alte etichete decât cele puse pe poduri în spec.template.metadata.labels. Fă-le identice (de exemplu app: web în ambele locuri) și aplică din nou.

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

Ce înseamnă

Un Deployment își găsește podurile după etichete: spec.selector.matchLabels spune ce etichete caută, iar spec.template.metadata.labels spune ce etichete primesc podurile create. Dacă podurile noi nu s-ar potrivi cu selectorul, Deploymentul le-ar crea la nesfârșit fără să le recunoască, așa că API server-ul refuză manifestul.

Mesajul arată etichetele din șablon (map[string]string{"app":"site"}). Compară-le cu selectorul. Cauza obișnuită: ai copiat un manifest și ai redenumit aplicația doar într-un loc, sau ai scris o literă diferit (app: web față de App: web).

Șablonul poate avea etichete în plus (de exemplu versiune: v2), dar trebuie să le conțină pe toate cele din selector, cu aceleași valori. Aceeași regulă se aplică la StatefulSet, DaemonSet, ReplicaSet și Job.

De ce apare: cauzele frecvente

1Nume schimbat doar în șablon

Greșit
YAML
  selector:
    matchLabels:
      app: web
  template:
    metadata:
      labels:
        app: site
Corect
YAML
  selector:
    matchLabels:
      app: web
  template:
    metadata:
      labels:
        app: web

Selectorul trebuie să se regăsească în etichetele șablonului.

2Cheie scrisă diferit

Greșit
YAML
matchLabels:
  app: web
...
labels:
  App: web
Corect
YAML
matchLabels:
  app: web
...
labels:
  app: web

Cheile etichetelor țin cont de litere mari și mici.

3Selector cu mai multe etichete

Greșit
YAML
matchLabels:
  app: web
  nivel: frontend
...
labels:
  app: web
Corect
YAML
matchLabels:
  app: web
  nivel: frontend
...
labels:
  app: web
  nivel: frontend

Toate etichetele din selector trebuie să existe în șablon.

Repară tu

Repară eroarea, direct în pagină

Manifestul ~/k8s/web.yaml al site-ului unei grădinițe a fost copiat dintr-un proiect mai vechi: selectorul caută app: web, dar șablonul pune pe poduri app: site, iar kubectl apply dă selector does not match template labels. Fă eticheta podurilor app: web și aplică fișierul.

Indiciu

Schimbă eticheta din spec.template.metadata.labels, nu selectorul.

Cum o eviți pe viitor

  • Generează scheletul cu kubectl create deployment NUME --image=... --dry-run=client -o yaml: selectorul și etichetele vin deja potrivite.
  • La copierea unui manifest, caută și înlocuiește numele vechi peste tot.
  • Păstrează în selector doar etichete stabile (app), nu și versiunea: selectorul nu se mai poate schimba după creare.

Întrebări frecvente

Pot pune în șablon mai multe etichete decât în selector?

Da, e chiar recomandat pentru etichete ca versiune. Contează doar ca toate etichetele din selector să fie și în șablon.

Pot schimba ulterior selectorul?

Nu: la Deployment, spec.selector e imutabil după creare. Ca să-l schimbi, ștergi Deploymentul și îl creezi din nou.

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.