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

failed to provision volume with StorageClass "standard": Only support ReadWriteOnce access mode

Pe scurt

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

Greșit
YAML
  accessModes:
  - ReadWriteMany
  storageClassName: standard
Corect
YAML
  accessModes:
  - ReadWriteOnce
  storageClassName: standard

Discul se atașează unui singur nod.

2Ai nevoie reală de partajare

Greșit
YAML
  storageClassName: standard   # local-path
Corect
YAML
  storageClassName: nfs   # provisioner cu RWX

Doar stocarea de tip fișier (NFS, CephFS, EFS) suportă RWX.

3Fișiere partajate între replici

Greșit
YAML
# 3 replici scriu încărcări în același volum
Corect
YAML
# încărcările merg într-un object storage (S3, MinIO)

Object storage scalează mai bine decât un volum partajat.

Repară tu

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.

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 ReadWriteOnce implicit și cere ReadWriteMany doar 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, ReadWriteOncePod dă 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

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