The Deployment "web" is invalid: spec.template.metadata.labels: Invalid value: map[string]string{"app":"site"}: `selector` does not match template `labels`
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
selector:
matchLabels:
app: web
template:
metadata:
labels:
app: site selector:
matchLabels:
app: web
template:
metadata:
labels:
app: webSelectorul trebuie să se regăsească în etichetele șablonului.
2Cheie scrisă diferit
matchLabels:
app: web
...
labels:
App: webmatchLabels:
app: web
...
labels:
app: webCheile etichetelor țin cont de litere mari și mici.
3Selector cu mai multe etichete
matchLabels:
app: web
nivel: frontend
...
labels:
app: webmatchLabels:
app: web
nivel: frontend
...
labels:
app: web
nivel: frontendToate etichetele din selector trebuie să existe în șablon.
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.
Reparația
Validarea eșuează:
kubectl apply -f web.yaml || trueError from server (Invalid): error when creating "web.yaml": The Deployment "web" is invalid: spec.template.metadata.labels: Invalid value: map[string]string{"app":"site"}: `selector` does not match template `labels`Potrivește eticheta din șablon:
sed -i 's/app: site/app: web/' web.yaml
kubectl apply -f web.yaml
kubectl rollout status deploy/webdeployment.apps/web created
Waiting for deployment "web" rollout to finish: 0 of 2 updated replicas are available...
deployment "web" successfully rolled outDe ce merge
Deploymentul recunoaște podurile după etichetele din selector. Dacă șablonul ar pune alte etichete, podurile create nu ar aparține Deploymentului, deci API server-ul refuză manifestul. După ce eticheta din șablon devine app: web, selectorul se potrivește, iar Deploymentul se creează și pornește podurile.
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
The Deployment "web" is invalid: spec.selector: Required value 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). The Deployment "web" is invalid: spec.selector: Invalid value: v1.LabelSelector{MatchLabels:map[string]string{"app":"magazin-web"}, MatchExpressions:[]v1.LabelSelectorRequirement(nil)}: field is immutable Selectorul unui Deployment (StatefulSet, DaemonSet) nu se mai poate schimba după creare. Ca să-l schimbi, șterge obiectul și creează-l din nou din fișier (kubectl delete -f, apoi apply -f, sau kubectl replace --force -f), acceptând că podurile se recreează. error: 'env' already has a value (test), and --overwrite is false Încerci să schimbi o etichetă (sau adnotare) care există deja cu altă valoare. kubectl label nu suprascrie implicit; adaugă --overwrite: kubectl label pod raport env=prod --overwrite. Î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.
