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

The PersistentVolumeClaim "date" is invalid: spec: Forbidden: spec is immutable after creation except resources.requests and volumeAttributesClassName for bound claims

Pe scurt

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

Greșit
YAML
  accessModes:
  - ReadWriteMany   # era ReadWriteOnce
  resources:
    requests:
      storage: 2Gi
Corect
YAML
  accessModes:
  - ReadWriteOnce
  resources:
    requests:
      storage: 2Gi

Doar mărimea poate fi schimbată; restul rămâne ca la creare.

2Schimbi clasa

Greșit
YAML
  storageClassName: rapid   # era standard
Corect
YAML
# PVC nou cu clasa rapid + copierea datelor

Clasa definește discul; nu se schimbă pe loc.

3Micșorezi

Greșit
YAML
      storage: 500Mi   # era 1Gi
Corect
YAML
      storage: 1Gi

Volumele nu pot fi micșorate.

Repară tu

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.

Alte forme ale mesajului

  • spec.resources.requests.storage: Forbidden: field can not be less than previous value
  • The 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ă allowVolumeExpansion pe 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

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