Finalizers: [kubernetes.io/pvc-protection] Status: Terminating
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
kubectl delete pvc vechikubectl delete pod import
# PVC-ul dispare singur după aceeaProtecția se ridică imediat ce niciun pod nu mai folosește PVC-ul.
2Podul e gestionat de un Deployment
kubectl delete pod import-7d9f... # Deploymentul îl recreeazăkubectl scale deployment import --replicas=0Fără replici, niciun pod nu mai montează PVC-ul.
3Scoți finalizerul de mână
kubectl patch pvc vechi -p '{"metadata":{"finalizers":null}}'kubectl describe pvc vechi # Used By, apoi oprești podulFără protecție, volumul poate dispărea sub aplicație.
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'.
Reparația
Starea și cine îl folosește:
kubectl get pvc import
kubectl describe pvc import | grep -E 'Finalizers|Used By'NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS VOLUMEATTRIBUTESCLASS AGE
import Terminating pvc-4469823b-137d-494b-af2f-d9f506166baf 1Gi RWO standard <unset> 36s
Finalizers: [kubernetes.io/pvc-protection]
Used By: importOprește podul:
kubectl delete pod import
kubectl wait --for=delete pvc/import --timeout=60s
kubectl get pvcpod "import" deleted
persistentvolumeclaim/import condition met
No resources found in default namespace.De ce merge
Finalizerul pvc-protection ține PVC-ul cât timp un pod îl montează, ca datele să nu dispară sub aplicație. După ștergerea podului import, niciun pod nu mai folosește volumul, deci protecția se ridică, iar ștergerea începută mai devreme se termină singură.
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înkubectl describe pvcînainte de ștergere. - Verifică
reclaimPolicyal volumului: cuDelete, 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
Error from server (Forbidden): pods "web" is forbidden: unable to create new content in namespace vechi because it is being terminated Namespace-ul e în curs de ștergere (Terminating) și nu mai acceptă obiecte noi. Așteaptă să dispară (kubectl wait --for=delete namespace/NUME), apoi creează-l din nou și repune obiectele, sau folosește alt namespace. 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). error: unable to drain node "academia-worker" due to error: cannot delete Pods with local storage (use --delete-emptydir-data to override): default/procesare-6f7d8c9b4-k2x9p Pe nod rulează poduri cu volume emptyDir, iar datele din ele se pierd la evacuare. Drain cere confirmare: dacă datele sunt temporare (cache, fișiere de lucru), adaugă --delete-emptydir-data; dacă sunt importante, mută-le pe un volum persistent înainte. Î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.
