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

Warning ProvisioningFailed persistentvolume-controller storageclass.storage.k8s.io "ssd-rapid" not found

Pe scurt

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.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Provisioning-ul dinamic funcționează așa: PVC-ul numește un StorageClass, iar provisionerul acelei clase creează volumul. Dacă numele nu corespunde niciunei clase, controllerul de volume emite evenimentul ProvisioningFailed cu storageclass.storage.k8s.io "ssd-rapid" not found, iar PVC-ul stă în Pending pentru totdeauna.

Apare des la manifeste copiate din alt cluster: în cloud clasele au nume ca gp3, premium-rwo sau managed-csi, iar în kind sau minikube clasa e standard.

La un StatefulSet e mai complicat: volumeClaimTemplates nu se pot modifica (vezi updates to statefulset spec ... are forbidden), iar PVC-urile deja create (date-db-0) rămân cu clasa greșită. Trebuie șterse StatefulSet-ul și PVC-urile, apoi aplicat manifestul corectat.

De ce apare: cauzele frecvente

1Clasă din alt cluster

Greșit
YAML
      storageClassName: ssd-rapid
Corect
YAML
      storageClassName: standard

Folosește o clasă care există: kubectl get storageclass.

2Corectezi doar StatefulSet-ul

Greșit
YAML
kubectl apply -f db.yaml   # volumeClaimTemplates schimbat
Corect
YAML
kubectl delete statefulset db
kubectl delete pvc date-db-0
kubectl apply -f db.yaml

Șablonul de volume e imutabil, iar PVC-ul vechi rămâne Pending.

3Clasă implicită lipsă

Greșit
YAML
# PVC fără storageClassName, clusterul nu are clasă implicită
Corect
YAML
kubectl patch storageclass standard -p '{"metadata":{"annotations":{"storageclass.kubernetes.io/is-default-class":"true"}}}'

Fără clasă implicită, un PVC fără clasă așteaptă un PV manual.

Repară tu

Repară eroarea, direct în pagină

Baza de date a unui service auto (StatefulSet db, ~/k8s/db.yaml) cere StorageClass-ul ssd-rapid, copiat din cloud, iar PVC-ul date-db-0 stă în Pending. Schimbă clasa în standard, apoi recreează StatefulSet-ul și PVC-ul, ca db-0 să pornească.

Indiciu

volumeClaimTemplates nu se modifică pe loc: șterge StatefulSet-ul și PVC-ul date-db-0, apoi aplică fișierul.

Alte forme ale mesajului

  • storageclass.storage.k8s.io "gp3" not found
  • failed to provision volume with StorageClass "rapid": storageclass.storage.k8s.io "rapid" not found

Cum o eviți pe viitor

  • Rulează kubectl get storageclass în fiecare cluster nou.
  • Parametrizează clasa în chart sau overlay, pentru că diferă între medii.
  • Omite storageClassName dacă vrei clasa implicită.
  • Testează manifestele de StatefulSet într-un namespace de probă înainte de producție.
  • Când copiezi manifeste dintr-un tutorial, verifică întâi clasa cerută.

Întrebări frecvente

Cum aflu clasa implicită?

kubectl get storageclass o marchează cu (default).

Pierd datele dacă șterg PVC-urile?

Depinde de reclaimPolicy. Aici volumul nu a fost creat niciodată, deci nu există date de pierdut.

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.