The StatefulSet "db" is invalid: spec: Forbidden: updates to statefulset spec for fields other than 'replicas', 'ordinals', 'template', 'updateStrategy', 'persistentVolumeClaimRetentionPolicy' and 'minReadySeconds' are forbidden
La un StatefulSet existent poți schimba doar replicas, template, updateStrategy și câteva câmpuri asemănătoare. volumeClaimTemplates, serviceName și selector sunt fixe. Readu-le la valoarea inițială; pentru discuri mai mari, mărește direct PVC-urile.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
StatefulSet-ul e gândit pentru aplicații cu stare, iar unele câmpuri definesc identitatea lui: selector, serviceName (numele DNS ale podurilor) și volumeClaimTemplates (cum arată discul fiecărui pod). API server-ul refuză orice modificare a lor, iar mesajul listează exact ce câmpuri se pot schimba.
Cazul cel mai des întâlnit: vrei discuri mai mari și schimbi storage în volumeClaimTemplates. Asta nu e permis, iar PVC-urile deja create (date-db-0, date-db-1) nu ar fi afectate oricum. Soluția practică: mărești fiecare PVC direct (kubectl patch pvc), dacă StorageClass-ul permite expansiunea.
Dacă chiar trebuie schimbat șablonul (pentru podurile viitoare), StatefulSet-ul se șterge cu --cascade=orphan (podurile și PVC-urile rămân) și se recreează cu șablonul nou.
De ce apare: cauzele frecvente
1Mărești discul în șablon
volumeClaimTemplates:
...
storage: 5Gi # era 1Gikubectl patch pvc date-db-0 -p '{"spec":{"resources":{"requests":{"storage":"5Gi"}}}}'PVC-urile existente se măresc direct.
2Schimbi serviceName
serviceName: db-nou serviceName: dbNumele serviciului e parte din identitatea podurilor.
3Șablonul trebuie totuși schimbat
kubectl apply -f db.yamlkubectl delete statefulset db --cascade=orphan
kubectl apply -f db.yamlPodurile și PVC-urile rămân, iar StatefulSet-ul nou le adoptă.
Repară eroarea, direct în pagină
În ~/k8s/db.yaml (StatefulSet-ul db al unei clinici veterinare), cineva a schimbat replicas: 2, dar și storage: 5Gi în volumeClaimTemplates, iar kubectl apply e refuzat. Readu storage la 1Gi, păstrează replicas: 2 și aplică fișierul.
Indiciu
Mesajul spune ce câmpuri sunt permise; volumeClaimTemplates nu e printre ele.
Reparația
Refuzul:
kubectl apply -f db.yaml || trueThe StatefulSet "db" is invalid: spec: Forbidden: updates to statefulset spec for fields other than 'replicas', 'ordinals', 'template', 'updateStrategy', 'persistentVolumeClaimRetentionPolicy' and 'minReadySeconds' are forbiddenDoar replicile:
sed -i 's/storage: 5Gi/storage: 1Gi/' db.yaml
kubectl apply -f db.yaml
kubectl rollout status statefulset/db --timeout=120s
kubectl get pvcstatefulset.apps/db configured
Waiting for 1 pods to be ready...
partitioned roll out complete: 2 new pods have been updated...
NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS VOLUMEATTRIBUTESCLASS AGE
date-db-0 Bound pvc-2d6a5170-9d73-4ade-ada0-0f1c4f0e8253 1Gi RWO standard <unset> 51s
date-db-1 Bound pvc-0fef034c-06d4-4d27-ab7f-a31981f6ffee 1Gi RWO standard <unset> 11sDe ce merge
Șablonul de volume al unui StatefulSet nu se poate modifica, iar câmpul interzis face ca toată actualizarea să fie refuzată. Cu storage readus la 1Gi, singura diferență rămâne replicas: 2, care e permisă. StatefulSet-ul creează db-1 cu PVC-ul lui, date-db-1.
Alte forme ale mesajului
The StatefulSet "redis" is invalid: spec: Forbidden: updates to statefulset spec for fields other than 'replicas', 'template', 'updateStrategy', 'persistentVolumeClaimRetentionPolicy' and 'minReadySeconds' are forbidden
Cum o eviți pe viitor
- Alege de la început mărimea discurilor cu o rezervă rezonabilă.
- Folosește un StorageClass cu
allowVolumeExpansion: truepentru baze de date. - Schimbă
replicasșitemplateseparat de orice alt câmp. - Documentează procedura cu
--cascade=orphanpentru schimbările rare de șablon. - Rulează
kubectl diff -fînainte de apply, ca să vezi ce câmpuri schimbi.
Întrebări frecvente
Dacă scalez la mai multe replici, noile poduri primesc disc?
Da, StatefulSet-ul creează PVC-uri noi din volumeClaimTemplates pentru fiecare pod nou.
De ce kubectl apply refuză și schimbarea de replici?
Pentru că întregul obiect e validat. Dacă un câmp interzis e schimbat, nimic nu se salvează.
Erori înrudite
The PersistentVolumeClaim "date" is invalid: spec: Forbidden: spec is immutable after creation except resources.requests and volumeAttributesClassName for bound claims După creare, la un PVC poți schimba doar mărimea cerută (resources.requests.storage, pentru PVC-uri legate) și volumeAttributesClassName. Pentru altă clasă sau alt mod de acces, creezi un PVC nou și muți datele; pentru mai mult spațiu, mărești doar storage. 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ă. Warning ProvisioningFailed persistentvolume-controller storageclass.storage.k8s.io "ssd-rapid" not found PVC-ul cere un StorageClass care nu există în cluster, deci volumul nu e creat și PVC-ul rămâne Pending. Folosește o clasă existentă (kubectl get storageclass); la StatefulSet, corectează volumeClaimTemplates, apoi recreează StatefulSet-ul și PVC-urile. Î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.
