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).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Modul de acces spune cum poate fi montat volumul: ReadWriteOnce (citire și scriere de pe un singur nod), ReadOnlyMany, ReadWriteMany (scriere de pe mai multe noduri) sau ReadWriteOncePod. Nu toate tipurile de stocare suportă toate modurile: un disc bloc (EBS, Persistent Disk, local-path) se atașează unui singur nod.
Când ceri ReadWriteMany de la un provisioner care nu-l suportă, volumul nu e creat, iar PVC-ul rămâne Pending cu acest mesaj (formularea exactă diferă după provisioner). Podul care îl folosește stă și el în Pending.
Întrebarea reală e de design: chiar ai nevoie ca mai multe poduri să scrie în același folder? Adesea un singur pod, o bază de date sau un object storage (S3, MinIO) e o soluție mai bună.
De ce apare: cauzele frecvente
1RWX pe un provisioner de disc
accessModes:
- ReadWriteMany
storageClassName: standard accessModes:
- ReadWriteOnce
storageClassName: standardDiscul se atașează unui singur nod.
2Ai nevoie reală de partajare
storageClassName: standard # local-path storageClassName: nfs # provisioner cu RWXDoar stocarea de tip fișier (NFS, CephFS, EFS) suportă RWX.
3Fișiere partajate între replici
# 3 replici scriu încărcări în același volum# încărcările merg într-un object storage (S3, MinIO)Object storage scalează mai bine decât un volum partajat.
Repară eroarea, direct în pagină
Un blog de rețete (podul retete) cere PVC-ul comun cu ReadWriteMany, dar clasa standard (local-path) suportă doar ReadWriteOnce, iar PVC-ul stă în Pending. Un singur pod scrie în el, deci recreează PVC-ul cu ReadWriteOnce (1Gi) și podul, ca acesta să pornească.
Indiciu
accessModes e imutabil: șterge podul și PVC-ul, corectează fișierul, aplică din nou.
Reparația
Cauza:
kubectl get pvc comun
kubectl describe pvc comun | grep -m1 'Only support'NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS VOLUMEATTRIBUTESCLASS AGE
comun Pending standard <unset> 34s
Warning ProvisioningFailed 4s (x3 over 34s) rancher.io/local-path_local-path-provisioner failed to provision volume with StorageClass "standard": Only support ReadWriteOnce access modeReadWriteOnce:
kubectl delete pod retete
kubectl delete pvc comun
sed -i 's/ReadWriteMany/ReadWriteOnce/' comun.yaml
kubectl apply -f comun.yaml -f retete.yaml
kubectl wait --for=condition=Ready pod/retete --timeout=90s
kubectl get pvc comunpod "retete" deleted
persistentvolumeclaim "comun" deleted
persistentvolumeclaim/comun created
pod/retete created
pod/retete condition met
NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS VOLUMEATTRIBUTESCLASS AGE
comun Bound pvc-69c96fec-97e4-43f2-a28a-515305976270 1Gi RWO standard <unset> 11sDe ce merge
Provisionerul local-path creează discuri locale, atașate unui singur nod, deci nu poate oferi ReadWriteMany. Cu un singur pod care scrie, ReadWriteOnce e suficient. Modul de acces nu se schimbă pe loc, așa că PVC-ul e recreat, iar provisionerul creează volumul și podul pornește.
Alte forme ale mesajului
Warning ProvisioningFailed failed to provision volume with StorageClass "gp3": rpc error: code = InvalidArgument desc = Volume capabilities not supported
Cum o eviți pe viitor
- Verifică ce moduri suportă provisionerul clasei înainte să scrii PVC-ul.
- Folosește
ReadWriteOnceimplicit și cereReadWriteManydoar când ai o clasă care îl oferă. - Pentru fișiere încărcate de utilizatori, preferă un object storage în locul unui volum partajat.
- Pentru un singur pod care scrie,
ReadWriteOncePoddă cea mai strictă garanție.
Întrebări frecvente
ReadWriteOnce înseamnă un singur pod?
Nu, un singur nod. Mai multe poduri de pe același nod îl pot monta. ReadWriteOncePod restrânge la un singur pod.
Pot schimba modul de acces al unui PVC existent?
Nu, accessModes e imutabil. Ștergi PVC-ul și îl creezi din nou.
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 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. 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. Î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.
