The ConfigMap "setari-v1" is invalid: data: Forbidden: field is immutable when `immutable` is set
ConfigMap-ul (sau Secret-ul) are immutable: true, deci conținutul lui nu mai poate fi schimbat. Creează un ConfigMap nou, cu altă versiune în nume (setari-v2), și schimbă referința din Deployment; podurile se recreează cu configurația nouă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
immutable: true îngheață un ConfigMap sau Secret: nici data, nici binaryData nu mai pot fi modificate, iar câmpul immutable nu poate fi scos. Avantajele: nimeni nu poate schimba din greșeală configurația unei aplicații în funcțiune, iar kubelet-ul nu mai urmărește obiectul pentru modificări (mai puțină încărcare pe API server în clustere mari).
Modelul de lucru e versionarea: fiecare schimbare înseamnă un obiect nou (setari-v2), iar Deploymentul e actualizat să-l folosească. Schimbarea șablonului declanșează un rolling update, deci configurația nouă ajunge controlat, iar rollout undo revine la cea veche.
Singura operație permisă pe obiectul vechi e ștergerea, după ce nu mai e folosit.
De ce apare: cauzele frecvente
1Editezi un ConfigMap imutabil
kubectl patch configmap setari-v1 -p '{"data":{"TEMA":"inchis"}}'kubectl create configmap setari-v2 --from-literal=TEMA=inchis
# apoi schimbi referința din DeploymentObiectul imutabil nu se modifică; se înlocuiește cu o versiune nouă.
2Încerci să scoți immutable
kubectl patch configmap setari-v1 -p '{"immutable":false}'kubectl create configmap setari-v2 ...Nici câmpul immutable nu se mai poate schimba.
Repară eroarea, direct în pagină
Aplicația unei agenții de turism (agentie) citește variabilele din ConfigMap-ul imutabil setari-v1 (TEMA=deschis). Echipa vrea TEMA=inchis, dar patch-ul dă field is immutable. Creează setari-v2 (imutabil, TEMA=inchis) și schimbă Deploymentul să-l folosească.
Indiciu
kubectl create configmap ... --dry-run=client -o yaml + immutable: true; referința se schimbă cu un patch pe envFrom.
Reparația
Modificarea e refuzată:
kubectl patch configmap setari-v1 -p '{"data":{"TEMA":"inchis"}}' || trueThe ConfigMap "setari-v1" is invalid: data: Forbidden: field is immutable when `immutable` is setVersiune nouă și referința din Deployment:
Fișierul setari-v2.yaml:
apiVersion: v1
kind: ConfigMap
metadata:
name: setari-v2
immutable: true
data:
TEMA: inchiskubectl apply -f setari-v2.yaml
sed -i 's/name: setari-v1/name: setari-v2/' agentie.yaml
kubectl apply -f agentie.yaml
kubectl rollout status deploy/agentie
kubectl exec deploy/agentie -- printenv TEMAconfigmap/setari-v2 created
deployment.apps/agentie configured
Waiting for deployment "agentie" rollout to finish: 1 old replicas are pending termination...
deployment "agentie" successfully rolled out
inchisDe ce merge
Un ConfigMap imutabil nu se mai modifică, deci configurația nouă devine un obiect nou, setari-v2. Schimbarea referinței din envFrom modifică șablonul Deploymentului, care face un rolling update: podurile noi pornesc cu TEMA=inchis. Dacă ceva nu merge, rollout undo revine la setari-v1, care a rămas neatins.
Alte forme ale mesajului
The Secret "db-v1" is invalid: data: Forbidden: field is immutable when `immutable` is set
Cum o eviți pe viitor
- Folosește nume versionate pentru ConfigMap-urile imutabile (
setari-v1,setari-v2sau un hash al conținutului). - Schimbă referința din Deployment prin fișier și
kubectl apply, ca schimbarea să fie în git. - Șterge versiunile vechi după ce nu mai sunt folosite.
- Kustomize (
configMapGenerator) și Helm pot genera automat nume cu hash.
Întrebări frecvente
De ce aș vrea un ConfigMap imutabil?
Ca o configurație greșită să nu poată ajunge instantaneu în toate podurile. Cu versiuni, schimbarea trece printr-un rollout, care poate fi urmărit și anulat.
Ce se întâmplă cu podurile vechi?
Rămân pe setari-v1 până sunt înlocuite de rolling update. După terminarea lui, poți șterge setari-v1.
Erori înrudite
Error from server (AlreadyExists): configmaps "setari" already exists kubectl create configmap nu poate actualiza un ConfigMap existent. Ca să-i schimbi valorile, generează-l cu --dry-run=client -o yaml și trimite-l la kubectl apply -f -, sau editează-l (kubectl edit). Apoi repornește podurile care îl folosesc ca variabile. 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: configmap "setari-magazin" not found Podul folosește un ConfigMap (prin env, envFrom sau valueFrom) care nu există în namespace-ul lui, așa că containerul nu poate fi creat (CreateContainerConfigError). Creează ConfigMap-ul cu numele exact; kubelet-ul reîncearcă singur și pornește containerul. Î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.
