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.
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
storageClassName: ssd-rapid storageClassName: standardFolosește o clasă care există: kubectl get storageclass.
2Corectezi doar StatefulSet-ul
kubectl apply -f db.yaml # volumeClaimTemplates schimbatkubectl 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ă
# PVC fără storageClassName, clusterul nu are clasă implicită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ă 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.
Reparația
PVC-ul și cauza:
kubectl get pvc
kubectl describe pvc date-db-0 | grep ProvisioningFailed | tail -1NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS VOLUMEATTRIBUTESCLASS AGE
date-db-0 Pending ssd-rapid <unset> 23s
Warning ProvisioningFailed 25s persistentvolume-controller storageclass.storage.k8s.io "ssd-rapid" not foundClasa corectă și recreare:
sed -i 's/storageClassName: ssd-rapid/storageClassName: standard/' db.yaml
kubectl delete statefulset db
kubectl delete pvc date-db-0
kubectl apply -f db.yaml
kubectl rollout status statefulset/db --timeout=120s
kubectl get pvcstatefulset.apps "db" deleted
persistentvolumeclaim "date-db-0" deleted
statefulset.apps/db created
Waiting for 1 pods to be ready...
partitioned roll out complete: 1 new pods have been updated...
NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS VOLUMEATTRIBUTESCLASS AGE
date-db-0 Bound pvc-9c26c091-f023-4c51-a359-5c0b8b631df8 1Gi RWO standard <unset> 13sDe ce merge
PVC-ul generat din șablon cerea o clasă inexistentă, deci volumul nu era creat, iar db-0 aștepta. Șablonul de volume al unui StatefulSet e imutabil, iar PVC-ul vechi păstrează clasa greșită, de aceea le ștergi pe amândouă. La aplicare, StatefulSet-ul creează date-db-0 cu standard, care e provizionat.
Alte forme ale mesajului
storageclass.storage.k8s.io "gp3" not foundfailed 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
storageClassNamedacă 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
0/3 nodes are available: pod has unbound immediate PersistentVolumeClaims. preemption: 0/3 nodes are available: 3 Preemption is not helpful for scheduling. Podul folosește un PVC care nu e legat de niciun volum (status Pending), deci scheduler-ul nu-l poate plasa. Cauza reală e la PVC: kubectl describe pvc arată de ce nu se creează volumul (de obicei un StorageClass inexistent). 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. 0/3 nodes are available: persistentvolumeclaim "rapoarte" not found. preemption: 0/3 nodes are available: 3 Preemption is not helpful for scheduling. Podul montează un PVC care nu există în namespace-ul lui, deci rămâne în Pending. Creează PVC-ul cu numele exact din claimName (sau corectează numele); podul e programat automat după aceea. Î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.
