...
Eroare Kubernetes · ConfigMap, Secret, namespace-uri și cote

The ConfigMap "setari-v1" is invalid: data: Forbidden: field is immutable when `immutable` is set

Pe scurt

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

Greșit
YAML
kubectl patch configmap setari-v1 -p '{"data":{"TEMA":"inchis"}}'
Corect
YAML
kubectl create configmap setari-v2 --from-literal=TEMA=inchis
# apoi schimbi referința din Deployment

Obiectul imutabil nu se modifică; se înlocuiește cu o versiune nouă.

2Încerci să scoți immutable

Greșit
YAML
kubectl patch configmap setari-v1 -p '{"immutable":false}'
Corect
YAML
kubectl create configmap setari-v2 ...

Nici câmpul immutable nu se mai poate schimba.

Repară tu

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.

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-v2 sau 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

← 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.