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

Finalizers: [kubernetes.io/pvc-protection] Status: Terminating

Pe scurt

Un PVC șters rămâne Terminating cât timp e folosit de un pod: finalizerul kubernetes.io/pvc-protection previne pierderea datelor unui volum montat. Șterge (sau oprește) podurile care îl folosesc și PVC-ul dispare singur.

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

Ce înseamnă

Când ștergi un PVC, Kubernetes nu-l elimină imediat dacă un pod încă îl montează. Finalizerul kubernetes.io/pvc-protection ține obiectul în Terminating până când niciun pod nu-l mai folosește, ca volumul să nu dispară sub o aplicație care scrie în el. kubectl delete pvc pare că se blochează (așteaptă), iar kubectl get pvc arată Terminating.

Află cine îl folosește cu kubectl describe pvc (câmpul Used By). Dacă podul e gestionat de un Deployment sau StatefulSet, scalează-l la 0 sau șterge-l; altfel, controllerul recreează podul, care folosește din nou PVC-ul (sau rămâne Pending).

Nu șterge finalizerul de mână: e o protecție, nu o eroare.

De ce apare: cauzele frecvente

1Ștergi PVC-ul cu podul încă pornit

Greșit
YAML
kubectl delete pvc vechi
Corect
YAML
kubectl delete pod import
# PVC-ul dispare singur după aceea

Protecția se ridică imediat ce niciun pod nu mai folosește PVC-ul.

2Podul e gestionat de un Deployment

Greșit
YAML
kubectl delete pod import-7d9f...   # Deploymentul îl recreează
Corect
YAML
kubectl scale deployment import --replicas=0

Fără replici, niciun pod nu mai montează PVC-ul.

3Scoți finalizerul de mână

Greșit
YAML
kubectl patch pvc vechi -p '{"metadata":{"finalizers":null}}'
Corect
YAML
kubectl describe pvc vechi   # Used By, apoi oprești podul

Fără protecție, volumul poate dispărea sub aplicație.

Repară tu

Repară eroarea, direct în pagină

PVC-ul vechi import al unei agenții imobiliare a fost șters, dar stă în Terminating. Podul import încă îl folosește. Găsește podul în Used By, șterge-l și verifică faptul că PVC-ul dispare.

Indiciu

kubectl describe pvc import | grep 'Used By'.

Alte forme ale mesajului

  • persistentvolumeclaim "vechi" deleted (comanda așteaptă)
  • Used By: import-0

Cum o eviți pe viitor

  • Oprește întâi aplicația, apoi șterge PVC-ul.
  • Verifică Used By în kubectl describe pvc înainte de ștergere.
  • Verifică reclaimPolicy al volumului: cu Delete, datele dispar odată cu PVC-ul.
  • Nu scoate finalizeri de protecție decât dacă știi exact de ce sunt blocați.

Întrebări frecvente

Ce se întâmplă cu datele după ce PVC-ul dispare?

Depinde de reclaimPolicy al PV-ului: cu Delete, discul e șters; cu Retain, PV-ul rămâne Released, iar datele se păstrează.

De ce kubectl delete pvc nu revine?

Pentru că așteaptă ștergerea efectivă, blocată de finalizer. Cu --wait=false, comanda revine imediat, iar PVC-ul rămâne Terminating.

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.