容器与云原生 / 系统课时

理解 PVC 与 PV 状态迁移

理解 PVC 与 PV 状态迁移

PVC 与 PV 都有 status.phase,但两者的状态集合和含义并不相同。本课把 phase、双向引用和事件放在同一条证据链上,帮助你判断卷是尚未绑定、已经释放、回收失败,还是绑定完成后卡在更下游。

学习目标

  • 区分 PVC 与 PV 的常见 phase,避免混淆 Released、Failed 与 Lost。
  • 用 kubectl 同时检查 phase、volumeName、claimRef 和事件。
  • 根据 Pending、Released、Failed 等现象切换到正确的排障边界。

先分清两套状态

PVC 常见 phase 为 Pending、Bound 和 Lost;PV 常见 phase 为 Available、Bound、Released 和 Failed。因此,Released 与 Failed 是 PV 状态,不是 PVC 状态;Lost 则属于 PVC。

对象 phase 含义
PVC Pending 尚未完成与某个 PV 的绑定
PVC Bound 已与 PV 建立控制面绑定
PVC Lost 曾经绑定,但对应 PV 已不存在或无法再找到
PV Available 可供 Claim 绑定
PV Bound 已绑定到 Claim
PV Released 原 Claim 已删除,但卷尚未完成回收或重新可用
PV Failed 自动回收流程失败

PVC 与 PV 状态迁移及引用关系

用 kubectl 建立状态快照

先从 PVC 找到它引用的 PV,再检查 PV 是否反向指回同一个 Claim。下面把 <PVC> 替换为实际名称;如果 PVC 不在当前命名空间,为 PVC 和事件命令补上 -n <NAMESPACE>。

bash
kubectl get pvc "<PVC>" \
  -o custom-columns='PVC:.metadata.name,PHASE:.status.phase,PV:.spec.volumeName,SC:.spec.storageClassName'

PV_NAME="$(kubectl get pvc "<PVC>" -o jsonpath='{.spec.volumeName}')"
if [ -n "$PV_NAME" ]; then
  kubectl get pv "$PV_NAME" \
    -o custom-columns='PV:.metadata.name,PHASE:.status.phase,CLAIM_NS:.spec.claimRef.namespace,CLAIM:.spec.claimRef.name,RECLAIM:.spec.persistentVolumeReclaimPolicy'
fi

已正常绑定时,预期结果应同时看到 PVC 与 PV 为 Bound,且 PVC 的 volumeName 与 PV 名称一致,PV 的 claimRef 反向指回同一个 Claim。

text
PVC    PHASE   PV          SC
<PVC>  Bound   <PV_NAME>   <STORAGECLASS>

PV         PHASE   CLAIM_NS     CLAIM   RECLAIM
<PV_NAME>  Bound   <NAMESPACE>  <PVC>   <POLICY>

如果 PVC 仍为 Pending,spec.volumeName 往往为空;此时不要猜测 PV 名称,而应继续检查 PVC 事件、StorageClass 和调度条件。

用事件解释为什么没有继续迁移

phase 只能告诉你“现在在哪”,事件更适合回答“为什么停在这里”。PVC 绑定与动态供应问题优先看 PVC 事件;使用 WaitForFirstConsumer 时,还要看消费该 PVC 的 Pod 事件,因为调度器需要先确定可行节点与存储拓扑。

bash
kubectl describe pvc "<PVC>"
kubectl get events \
  --field-selector "involvedObject.kind=PersistentVolumeClaim,involvedObject.name=<PVC>" \
  --sort-by=.metadata.creationTimestamp

预期结果可能表现为等待消费者、动态供应进行中或供应失败。Reason 与 Source 会随 Kubernetes 版本、external-provisioner 和 CSI 驱动实现变化,应重点阅读 Message,而不是依赖固定事件名。

text
TYPE     REASON                     OBJECT                         MESSAGE
Normal   <WAIT_OR_PROVISIONING>     persistentvolumeclaim/<PVC>    <DETAIL>
Warning  <BIND_OR_PROVISION_FAIL>   persistentvolumeclaim/<PVC>    <ERROR_DETAIL>

没有可匹配 PV 时,检查容量、访问模式和 StorageClass;动态供应失败时继续检查 external-provisioner 与 CSI Controller;WaitForFirstConsumer 长期等待时,确认是否存在消费 Pod,并核对 Pod 的节点选择、亲和性和拓扑约束。

从引用关系判断 Released 与 Lost

PVC 为 Bound 时,两条引用应互相吻合:PVC 的 spec.volumeName 指向 PV,PV 的 spec.claimRef 指回 PVC。PV 进入 Released 后,旧 claimRef 通常仍保留,用来避免另一个 Claim 在数据处置完成前直接接管该卷。

Retain 策略下,删除 PVC 后看到 PV 停在 Released 往往是预期行为。管理员应先确认后端数据是保留、迁移还是删除,再决定删除并重建 PV,或在确认安全后执行受控复用。不要只为了改变状态就直接清除 claimRef。

PVC 的 Lost 是另一类信号:Claim 认为自己曾绑定过卷,但对应 PV 已不存在。此时先确认 PV 是否被误删,以及是否发生控制面恢复或迁移问题,再处理数据恢复;手工修改 PVC 的 status.phase 不能修复真实引用关系。

按状态切换排障边界

Pending 是绑定阶段最常见的阻塞状态。先看 PVC 事件,再检查 StorageClass、可匹配 PV 与消费 Pod,不要直接跳到节点 mount 链路。

Released 主要检查 PV 的 persistentVolumeReclaimPolicy 与 claimRef。Retain 下通常需要人工处置数据;如果预期 Delete 却长时间不消失,再检查供应器、CSI Controller、后端删除操作及阻止删除的保护机制。

Failed 表示 PV 自动回收失败,不是“Pod 挂载失败”的同义词。此时应查看 PV 事件,再结合存储供应器或 CSI Controller 日志定位后端回收错误。

修复后再次执行前面的状态快照命令,确认 phase 与两端引用符合预期;如果 PVC 与 PV 已为 Bound 但 Pod 仍不可用,应立即把排障边界切换到调度、attach 和 mount 链路。

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

目录与阅读设置

阅读设置

17

记录一个想法

理解 PVC 与 PV 状态迁移

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

登录哪都通