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

Normal WaitForFirstConsumer persistentvolume-controller waiting for first consumer to be created before binding

Pe scurt

Nu e o eroare: StorageClass-ul are volumeBindingMode: WaitForFirstConsumer, deci PVC-ul rămâne Pending până când un pod îl folosește. Creează podul (sau Deploymentul) care montează PVC-ul și acesta devine Bound.

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

Ce înseamnă

Cu volumeBindingMode: WaitForFirstConsumer, volumul nu e creat când apare PVC-ul, ci abia când scheduler-ul alege un nod pentru primul pod care îl folosește. Astfel discul e creat în zona sau pe nodul potrivit (esențial pentru discuri locale și pentru clustere cu mai multe zone). Până atunci, PVC-ul e Pending, iar evenimentul e de tip Normal, nu Warning.

Confuzia apare când cineva creează PVC-ul, vede Pending și crede că ceva e stricat, sau când un script așteaptă Bound înainte să creeze podul și rămâne blocat.

Dacă și podul stă în Pending și PVC-ul tot nu se leagă, problema e alta: verifică evenimentele podului (resurse, taint-uri) și ale PVC-ului.

De ce apare: cauzele frecvente

1Aștepți Bound înainte de pod

Greșit
YAML
kubectl apply -f pvc.yaml
kubectl wait --for=jsonpath='{.status.phase}'=Bound pvc/date
Corect
YAML
kubectl apply -f pvc.yaml -f pod.yaml
kubectl wait --for=condition=Ready pod/app

PVC-ul se leagă abia după ce apare podul.

2Crezi că PVC-ul e stricat

Greșit
YAML
kubectl delete pvc date   # Pending
Corect
YAML
kubectl describe pvc date   # WaitForFirstConsumer: e normal

Evenimentul Normal confirmă că așteaptă un consumator.

Repară tu

Repară eroarea, direct în pagină

Un script de livrare pentru un site de cursuri creează PVC-ul uploaduri și apoi așteaptă Bound, dar PVC-ul stă în Pending cu evenimentul WaitForFirstConsumer. Creează podul consumator cursuri din ~/k8s/cursuri.yaml, care îl montează, și verifică faptul că PVC-ul devine Bound.

Indiciu

kubectl describe pvc uploaduri arată că PVC-ul așteaptă un pod.

Alte forme ale mesajului

  • waiting for pod web-0 to be scheduled

Cum o eviți pe viitor

  • Știi ce volumeBindingMode are clasa: kubectl get storageclass (coloana VOLUMEBINDINGMODE).
  • În scripturi, așteaptă podul, nu PVC-ul.
  • Aplică PVC-ul și consumatorul împreună.
  • Diferențiază evenimentele Normal de cele Warning când depanezi.
  • Nu șterge un PVC doar pentru că e Pending: citește întâi evenimentul și verifică dacă există deja podul care îl folosește.

Întrebări frecvente

De ce nu e Immediate implicit?

Pentru că un disc creat înainte de programare poate ajunge într-o zonă în care podul nu poate rula. WaitForFirstConsumer evită asta.

Ce se întâmplă dacă șterg podul?

PVC-ul rămâne Bound, iar volumul și datele rămân. Un pod nou îl va folosi 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.