...
Eroare Kubernetes · Volume, PVC și StatefulSet

The StatefulSet "db" is invalid: spec: Forbidden: updates to statefulset spec for fields other than 'replicas', 'ordinals', 'template', 'updateStrategy', 'persistentVolumeClaimRetentionPolicy' and 'minReadySeconds' are forbidden

Pe scurt

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

Greșit
YAML
  volumeClaimTemplates:
  ...
          storage: 5Gi   # era 1Gi
Corect
YAML
kubectl patch pvc date-db-0 -p '{"spec":{"resources":{"requests":{"storage":"5Gi"}}}}'

PVC-urile existente se măresc direct.

2Schimbi serviceName

Greșit
YAML
  serviceName: db-nou
Corect
YAML
  serviceName: db

Numele serviciului e parte din identitatea podurilor.

3Șablonul trebuie totuși schimbat

Greșit
YAML
kubectl apply -f db.yaml
Corect
YAML
kubectl delete statefulset db --cascade=orphan
kubectl apply -f db.yaml

Podurile și PVC-urile rămân, iar StatefulSet-ul nou le adoptă.

Repară tu

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.

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: true pentru baze de date.
  • Schimbă replicas și template separat de orice alt câmp.
  • Documentează procedura cu --cascade=orphan pentru 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

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