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

0/3 nodes are available: pod has unbound immediate PersistentVolumeClaims. preemption: 0/3 nodes are available: 3 Preemption is not helpful for scheduling.

Pe scurt

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

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

Ce înseamnă

Un pod cu un PVC nu poate porni până când PVC-ul nu e legat (Bound) de un PersistentVolume. Scheduler-ul verifică asta și, dacă PVC-ul e încă Pending, lasă podul în Pending cu mesajul pod has unbound immediate PersistentVolumeClaims. Mesajul descrie efectul, nu cauza.

Cauza se află în evenimentele PVC-ului (kubectl describe pvc): StorageClass-ul cerut nu există (ProvisioningFailed: storageclass.storage.k8s.io "rapid" not found), provisionerul nu suportă modul de acces cerut, nu există niciun PV manual potrivit (când nu folosești provisioning dinamic) sau provisionerul nu rulează.

Câmpurile principale ale unui PVC sunt imutabile, deci un PVC cu StorageClass greșit se șterge și se creează din nou, corect.

De ce apare: cauzele frecvente

1StorageClass inexistent

Greșit
YAML
spec:
  storageClassName: rapid
Corect
YAML
spec:
  storageClassName: standard

Numele trebuie să fie al unui StorageClass din cluster (kubectl get storageclass).

2Niciun PV manual potrivit

Greșit
YAML
# PVC fără StorageClass, PV de 1Gi, PVC cere 5Gi
Corect
YAML
# PV cel puțin cât cere PVC-ul, cu același accessMode

Un PVC se leagă doar de un PV care îi satisface cererea.

3Mod de acces nesuportat

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

Multe provisionere de disc suportă doar ReadWriteOnce.

Repară tu

Repară eroarea, direct în pagină

Podul galerie al unui fotograf stă în Pending cu pod has unbound immediate PersistentVolumeClaims. PVC-ul poze cere StorageClass-ul rapid, care nu există. Recreează PVC-ul cu clasa standard (același nume, 1Gi) și podul din ~/k8s/galerie.yaml, ca podul să pornească.

Indiciu

kubectl describe pvc poze arată cauza; kubectl get storageclass arată clasele existente.

Alte forme ale mesajului

  • 0/3 nodes are available: pod has unbound immediate PersistentVolumeClaims.

Cum o eviți pe viitor

  • Verifică StorageClass-urile din cluster înainte să scrii PVC-ul: kubectl get storageclass.
  • Omite storageClassName dacă vrei clasa implicită a clusterului.
  • Când un pod cu volum stă în Pending, citește întâi kubectl describe pvc.
  • Ține numele claselor în valori per mediu (Helm, Kustomize), pentru că diferă între clustere.

Întrebări frecvente

Ce înseamnă immediate în mesaj?

Că PVC-ul folosește un StorageClass cu volumeBindingMode: Immediate (sau o clasă necunoscută) și trebuia să fie deja legat înainte de programarea podului.

De ce trebuie să șterg PVC-ul?

Pentru că storageClassName și accessModes nu se mai pot schimba după creare.

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.