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

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

Pe scurt

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

Greșit
YAML
# web.yaml: matchLabels app: magazin-web (era app: web)
kubectl apply -f web.yaml
Corect
YAML
kubectl delete -f web.yaml
# (sau kubectl delete deploy web)
kubectl apply -f web.yaml

Selectorul vechi nu poate fi modificat; obiectul nou primește selectorul nou.

2Vrei recrearea într-o singură comandă

Greșit
YAML
kubectl apply -f web.yaml
Corect
YAML
kubectl replace --force -f web.yaml

replace --force șterge obiectul și îl creează din fișier.

3Voiai doar o etichetă în plus

Greșit
YAML
matchLabels:
  app: web
  versiune: v2
Corect
YAML
matchLabels:
  app: web
# eticheta versiune doar în template.metadata.labels

Etichetele noi pot fi puse pe poduri fără să atingi selectorul.

Repară tu

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.

Alte forme ale mesajului

  • The Job "j2" is invalid: spec.template: Invalid value: core.PodTemplateSpec{...}: field is immutable
  • The Secret "s" is invalid: type: Invalid value: "kubernetes.io/tls": field is immutable
  • The 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

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