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ă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Unele câmpuri sunt imutabile: odată creat obiectul, API server-ul refuză orice modificare a lor. Pentru un Deployment, spec.selector e imutabil pentru că leagă Deploymentul de ReplicaSet-urile și podurile existente; schimbarea lui ar lăsa poduri orfane și istoric de revizii fără sens.
Cel mai des apare când redenumești aplicația și schimbi eticheta app în tot fișierul, inclusiv în selector, apoi rulezi kubectl apply. Alte câmpuri imutabile întâlnite des: spec.selector la Service nu e imutabil, dar la Job spec.template și spec.selector sunt; la PVC aproape tot spec; la StatefulSet volumeClaimTemplates și serviceName.
Soluția: recreezi obiectul. Pentru un Deployment, asta înseamnă câteva secunde în care podurile vechi sunt oprite și pornesc cele noi.
De ce apare: cauzele frecvente
1Schimbi eticheta din selector la apply
# web.yaml: matchLabels app: magazin-web (era app: web)
kubectl apply -f web.yamlkubectl delete -f web.yaml
# (sau kubectl delete deploy web)
kubectl apply -f web.yamlSelectorul vechi nu poate fi modificat; obiectul nou primește selectorul nou.
2Vrei recrearea într-o singură comandă
kubectl apply -f web.yamlkubectl replace --force -f web.yamlreplace --force șterge obiectul și îl creează din fișier.
3Voiai doar o etichetă în plus
matchLabels:
app: web
versiune: v2matchLabels:
app: web
# eticheta versiune doar în template.metadata.labelsEtichetele noi pot fi puse pe poduri fără să atingi selectorul.
Repară eroarea, direct în pagină
Aplicația web a unei edituri a fost redenumită intern: în ~/k8s/web.yaml eticheta e acum app: magazin-web peste tot, inclusiv în selector, iar kubectl apply dă spec.selector: field is immutable. Recreează Deploymentul din fișier, ca selectorul și podurile să folosească eticheta nouă.
Indiciu
Un obiect cu câmpuri imutabile schimbate se recreează: kubectl replace --force -f sau delete + apply.
Reparația
apply refuză selectorul nou:
kubectl apply -f web.yaml || trueThe request is invalid: The Deployment "web" is invalid: spec.selector: Invalid value: v1.LabelSelector{MatchLabels:map[string]string{"app":"magazin-web"}, MatchExpressions:[]v1.LabelSelectorRequirement(nil)}: field is immutableRecreează Deploymentul:
kubectl replace --force -f web.yaml
kubectl rollout status deploy/web
kubectl get pods --show-labelsdeployment.apps "web" deleted
deployment.apps/web replaced
Waiting for deployment "web" rollout to finish: 0 of 2 updated replicas are available...
deployment "web" successfully rolled out
NAME READY STATUS RESTARTS AGE LABELS
web-ldx5ltpldb-b6fbg 1/1 Running 0 4s app=magazin-web,pod-template-hash=ldx5ltpldb
web-ldx5ltpldb-z5xml 1/1 Running 0 4s app=magazin-web,pod-template-hash=ldx5ltpldbDe ce merge
Selectorul leagă Deploymentul de ReplicaSet-urile și podurile lui, de aceea nu poate fi schimbat după creare. kubectl replace --force șterge Deploymentul și îl creează din fișier, cu selectorul nou; podurile vechi dispar odată cu el, iar cele noi pornesc cu eticheta app: magazin-web.
Alte forme ale mesajului
The Job "j2" is invalid: spec.template: Invalid value: core.PodTemplateSpec{...}: field is immutableThe Secret "s" is invalid: type: Invalid value: "kubernetes.io/tls": field is immutableThe request is invalid: spec.selector: Invalid value: ...: field is immutable
Cum o eviți pe viitor
- Alege de la început un selector stabil (
app: nume) și nu pune în el versiuni sau medii. - Etichetele care se schimbă (versiune, echipă) pune-le doar în
template.metadata.labels. - Când trebuie totuși schimbat, planifică recrearea: pentru câteva secunde aplicația poate avea mai puține replici.
Întrebări frecvente
Pierd ceva dacă șterg și recreez Deploymentul?
Pierzi istoricul de revizii (rollout history) și podurile sunt recreate. Configurația din fișier și Service-ul rămân, iar Service-ul găsește podurile noi dacă selectorul lui se potrivește.
Și Service-ul trebuie schimbat?
Dacă Service-ul alege podurile după eticheta veche, da: actualizează-i selectorul (la Service câmpul nu e imutabil) ca să trimită trafic la podurile noi.
Erori înrudite
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. The Pod "p" is invalid: spec: Forbidden: pod updates may not change fields other than `spec.containers[*].image`,`spec.initContainers[*].image`,`spec.activeDeadlineSeconds`,`spec.tolerations` (only additions to existing tolerations),`spec.terminationGracePeriodSeconds` (allow it to be set to 1 if it was previously negative) Un pod existent permite modificarea doar a câtorva câmpuri (imaginea, toleranțele, activeDeadlineSeconds). Pentru variabile de mediu, porturi, resurse sau volume trebuie să-l recreezi (kubectl replace --force -f sau delete + apply). Mai bine, rulează aplicația într-un Deployment, care recreează podurile singur. The Job "import" is invalid: spec.template: Invalid value: core.PodTemplateSpec{...}: field is immutable Șablonul podului unui Job nu se mai poate modifica după creare. Ca să rulezi Job-ul cu altă comandă sau imagine, șterge-l și creează-l din nou (kubectl delete job, apoi apply), sau dă-i alt nume la fiecare rulare. Î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.
