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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un PVC legat reprezintă un disc real, deja creat cu anumite proprietăți. De aceea API server-ul refuză schimbările la storageClassName, accessModes, volumeName sau selector. Poți schimba doar resources.requests.storage (mărire, dacă StorageClass-ul are allowVolumeExpansion: true) și volumeAttributesClassName.
Eroarea apare des când cineva editează fișierul PVC-ului (de exemplu, schimbă și modul de acces, și mărimea) și rulează kubectl apply. Întreaga cerere e refuzată, inclusiv mărirea, care era permisă.
Micșorarea nu e suportată deloc. Pentru o schimbare de clasă sau de mod de acces: PVC nou, copiere de date (un Job care montează ambele volume), apoi schimbarea referinței din aplicație.
De ce apare: cauzele frecvente
1Schimbi modul de acces împreună cu mărimea
accessModes:
- ReadWriteMany # era ReadWriteOnce
resources:
requests:
storage: 2Gi accessModes:
- ReadWriteOnce
resources:
requests:
storage: 2GiDoar mărimea poate fi schimbată; restul rămâne ca la creare.
2Schimbi clasa
storageClassName: rapid # era standard# PVC nou cu clasa rapid + copierea datelorClasa definește discul; nu se schimbă pe loc.
3Micșorezi
storage: 500Mi # era 1Gi storage: 1GiVolumele nu pot fi micșorate.
Repară eroarea, direct în pagină
PVC-ul date al unui magazin de jocuri (1Gi, ReadWriteOnce, clasa extensibil, cu allowVolumeExpansion: true) e plin. Cineva a editat ~/k8s/date.yaml și a pus storage: 2Gi, dar și ReadWriteMany, iar kubectl apply e refuzat. Lasă modul ReadWriteOnce, păstrează mărirea la 2Gi și aplică fișierul.
Indiciu
Doar resources.requests.storage se poate schimba la un PVC legat.
Reparația
Refuzul:
kubectl apply -f date.yaml || trueThe PersistentVolumeClaim "date" is invalid: spec: Forbidden: spec is immutable after creation except resources.requests and volumeAttributesClassName for bound claims
core.PersistentVolumeClaimSpec{
- AccessModes: []core.PersistentVolumeAccessMode{"ReadWriteOnce"},
+ AccessModes: []core.PersistentVolumeAccessMode{"ReadWriteMany"},
... // other fields
}Doar mărimea:
sed -i 's/ReadWriteMany/ReadWriteOnce/' date.yaml
kubectl apply -f date.yaml
kubectl get pvc datepersistentvolumeclaim/date configured
NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS VOLUMEATTRIBUTESCLASS AGE
date Bound pvc-8afa31b7-284d-45e5-af50-4d203ebca6d3 1Gi RWO extensibil <unset> 44sDe ce merge
La un PVC legat, singura modificare permisă e mărimea, iar orice alt câmp schimbat face ca întreaga cerere să fie refuzată. Cu ReadWriteOnce readus, diferența față de obiectul live e doar storage: 2Gi, pe care API server-ul o acceptă, pentru că clasa extensibil permite expansiunea, iar volumul e mărit.
Alte forme ale mesajului
spec.resources.requests.storage: Forbidden: field can not be less than previous valueThe PersistentVolumeClaim "date" is invalid: spec: Forbidden: spec is immutable after creation except resources.requests for bound claims
Cum o eviți pe viitor
- Schimbă un singur lucru odată la un PVC existent: de obicei, doar mărimea.
- Alege de la început clasa și modul de acces, pentru că rămân fixe.
- Verifică
allowVolumeExpansionpe StorageClass înainte să planifici măriri. - Pentru migrări de clasă, scrie un Job care copiază datele între două PVC-uri.
Întrebări frecvente
Mărirea funcționează fără să repornesc podul?
La majoritatea driverelor CSI moderne, da (expansiune online). Unele cer repornirea podului pentru a redimensiona sistemul de fișiere.
De ce kubectl apply refuză tot, nu doar câmpul interzis?
Pentru că o actualizare e validată ca întreg: dacă un câmp e invalid, nimic nu se salvează.
Erori înrudite
failed to provision volume with StorageClass "standard": Only support ReadWriteOnce access mode Provisionerul StorageClass-ului (aici local-path, folosit de kind) poate crea doar volume ReadWriteOnce, iar PVC-ul cere ReadWriteMany. Folosește ReadWriteOnce (cu un singur pod sau poduri pe același nod) sau o clasă care suportă RWX (NFS, CephFS, EFS, Azure Files). 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ă. 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. Î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.
