容器与云原生 / 系统课时

使用 finalizer 保护存储对象

使用 finalizer 保护存储对象

删除 PVC 或 PV 后长期停在 Terminating,往往不是 API Server “删不掉”,而是 finalizer 正在等待引用或清理条件满足。本节用对象关系定位阻塞点,区分正常保护、控制器异常与需要人工介入的情况。

学习目标

  • 解释 PVC/PV 保护 finalizer 为什么会让删除进入等待状态
  • 用 deletionTimestamp、finalizers、Pod 引用和 PV 绑定关系定位阻塞点
  • 区分对象使用保护与 CSI 后端卷删除保护,避免直接移除 finalizer 掩盖根因

finalizer 如何把删除变成两阶段流程

finalizer 不是“拒绝 DELETE”的访问控制。删除请求被接受后,API Server 会写入 metadata.deletionTimestamp,对象进入待删除状态;只要 metadata.finalizers 仍有条目,对象就继续存在。负责该 finalizer 的控制器完成清理条件后移除对应键,finalizer 列表清空时对象才真正从 API 中消失。

对存储对象,最常见的是 kubernetes.io/pvc-protection 与 kubernetes.io/pv-protection。PVC 仍被某个现存 Pod 引用时,PVC 删除会被推迟;PV 仍绑定到 PVC 时,PV 删除也会被推迟。这里保护的是 Kubernetes 对象之间的使用关系,目的在于避免删除正在使用的存储对象导致数据风险。

PVC 与 PV finalizer 删除阻塞状态流

从对象状态定位谁在阻塞

先看删除时间和 finalizer,再追引用关系,不要先改 metadata。下面的命令只读取对象;把 app、data 和 PV 名称替换为实际值。

bash
kubectl get pvc data -n app -o custom-columns='NAME:.metadata.name,PHASE:.status.phase,VOLUME:.spec.volumeName,DELETION:.metadata.deletionTimestamp,FINALIZERS:.metadata.finalizers'

kubectl get pods -n app -o custom-columns='POD:.metadata.name,PHASE:.status.phase,CLAIMS:.spec.volumes[*].persistentVolumeClaim.claimName' | grep -E '(^POD|data)'

kubectl get pv <PV_NAME> -o custom-columns='NAME:.metadata.name,PHASE:.status.phase,CLAIM_NS:.spec.claimRef.namespace,CLAIM:.spec.claimRef.name,RECLAIM:.spec.persistentVolumeReclaimPolicy,DELETION:.metadata.deletionTimestamp,FINALIZERS:.metadata.finalizers'

预期输出

text
NAME   PHASE   VOLUME       DELETION   FINALIZERS
data   Bound   <PV_NAME>    <TIME>     [kubernetes.io/pvc-protection]

POD        PHASE     CLAIMS
<Pod_A>    Running   data

NAME        PHASE   CLAIM_NS   CLAIM   RECLAIM   DELETION   FINALIZERS
<PV_NAME>   Bound   app        data    Delete    <TIME>     [kubernetes.io/pv-protection ...]

实际时间、Pod 名称、PV 名称和 finalizer 列表会随集群而变化。只要仍存在引用 data 的 Pod,PVC protection 等待就是预期行为;如果 PV 仍有 claimRef 指向该 PVC,PV protection 等待也同样合理。

区分使用保护与后端删除保护

CSI PV 在 persistentVolumeReclaimPolicy: Delete 场景下,还可能看到 external-provisioner.volume.kubernetes.io/finalizer。它与 kubernetes.io/pv-protection 解决的不是同一件事:前者用于确保后端存储删除完成后再移除 PV 对象,后者用于避免删除仍绑定使用的 PV。

因此,看到 PV 长期 Terminating 时应按 finalizer 名称分流。若卡在 pv-protection,优先检查 PVC 绑定关系;若卡在 external-provisioner finalizer,则继续检查 external-provisioner、CSI Controller、DeleteVolume 调用及后端存储状态。单看“Terminating”无法判断根因。

用证据闭环确认可以删除

正常恢复路径应先解除真实依赖:停止相关工作负载,并确认引用该 PVC 的 Pod 对象已经删除;仅让容器退出而保留 Pod 对象并不足以证明保护条件消失。随后观察 PVC finalizer 自动消失。PVC 删除完成后,再确认 PV 的绑定关系与回收策略是否按预期推进。对于 Delete 策略的 CSI PV,还要确认 provisioner 完成后端卷删除。

如果依赖已经解除但 finalizer 长时间不变化,再查对应控制器日志与事件。判断是否修复成功的标准不是“对象被强删了”,而是保护条件消失、控制器完成职责、finalizer 自动移除,并且 Kubernetes 对象与后端存储状态一致。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 finalizer 保护存储对象

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通