《Kubernetes 分布式系统原理深入解析》9.2 volumeClaimTemplates 与有序扩缩

有状态应用的存储是『一 Pod 一卷』:StatefulSet 的 volumeClaimTemplates 为每个 Pod 生成独立的 PVC,Pod 序号与卷一一对应。扩缩容因此有了存储语义——扩容要为新 Pod 申请卷,缩容后卷默认保留(可回收)。本节解剖 volumeClaimTemplates 与有序扩缩容的联动。lab 用 statefulset 验证序控制下的扩缩容路径。

9.2 volumeClaimTemplates 与有序扩缩

Deployment 的所有副本共享同一个 volume(或都无状态)。StatefulSet 不一样:每个 Pod 有自己的卷,由 volumeClaimTemplates 为每个序号生成独立的 PVC。本节解剖这层「一 Pod 一卷」的存储语义与有序扩缩的联动。

volumeClaimTemplates:按模板给每个 Pod 发卷

volumeClaimTemplates 是 StatefulSet 特有字段:

volumeClaimTemplates:
  - metadata: {name: data}
    spec:
      accessModes: [ReadWriteOnce]
      resources:
        requests: {storage: 1Gi}

作用:为每个 Pod 按模板生成一个独立 PVC:

PodPVC卷
web-0data-web-0独立的 1Gi 卷
web-1data-web-1独立的 1Gi 卷
web-2data-web-2独立的 1Gi 卷

PVC 名字 = 模板名 + Pod 名(data-web-0)。Pod 序号与卷一一对应,Pod 重建后挂载同一个卷(名字不变)。

为什么必须「一 Pod 一卷」

有状态应用的存储不是共享的:

  • 数据库:每个节点的数据独立(主库的数据 ≠ 从库的数据)。
  • 消息队列:每个分片的日志独立。
  • 分布式存储:每个节点的 chunk 独立。

如果所有 Pod 共享一个卷,写冲突、锁竞争、数据隔离都无从谈起。「一 Pod 一卷」是数据独立性的存储表达。这也是 STS 与 Deployment 在存储上的本质区别:Deployment 可以用共享卷(所有副本挂同一个),STS 必须一 Pod 一卷。

扩容的存储语义:先卷后 Pod

扩容(加副本)时,StatefulSet 控制器不只创建 Pod,还要为它创建 PVC:

扩容到 4
  → 为 web-3 创建 PVC data-web-3
  → 创建 Pod web-3
  → web-3 挂载 data-web-3

顺序很重要:PVC 要在 Pod 创建前就绪,否则 Pod 挂载会等待。PVC 依赖 StorageClass 动态供给(没有现成 PV 时按需创建)。所以扩容的实际等待 = PVC 绑定 + Pod 就绪,两者叠加。

缩容的存储语义:卷默认保留

缩容(减副本)时,StatefulSet 的行为值得注意:Pod 删除后,PVC 默认保留。

缩容到 2
  → 删 Pod web-3(有序:最大序号先删)
  → PVC data-web-3 保留(不自动删除)

为什么保留?数据不随 Pod 消失。web-3 的数据是有价值的(可能只是暂时下线,将来扩容回来还要用它)。若自动删 PVC,数据就没了。

保留的后果与选择:

  • 缩容后 PVC 仍在,将来扩容回来复用同一卷(数据还在)。
  • 若要彻底清理,需手动删 PVC(或配置 persistentVolumeReclaimPolicy=Delete 的 StorageClass)。
  • 与 Deployment 缩容(Pod 删了就删了)对比,STS 缩容是「暂停服务、保留数据」。

有序扩缩与卷的生命周期联动

把 9.1 节的序控制与卷结合起来,完整的扩缩流程:

扩容(1 → 3):

创建 web-0 的 PVC → 创建 web-0 → web-0 就绪
创建 web-1 的 PVC → 创建 web-1 → web-1 就绪(依赖 web-0 就绪)
创建 web-2 的 PVC → 创建 web-2 → web-2 就绪(依赖 web-1 就绪)

缩容(3 → 1):

删 web-2(最大序号)→ web-2 的 PVC 保留
删 web-1 → web-1 的 PVC 保留
(web-0 保留,作为核心节点)

每步都是「卷 + Pod」一起操作:创建时先卷后 Pod,删除时先 Pod 后留卷。这是有状态扩缩容与无状态的本质差异——无状态扩缩只动 Pod,有状态扩缩动「Pod + 它的数据」。

扩缩容失败场景:卷是慢环节

有状态扩缩容的失败往往发生在卷环节:

症状根因
扩容卡在 PendingPVC 未绑定(StorageClass 不可用/配额不足)
Pod 挂载超时卷供给慢,Pod 等挂载
缩容卡住Pod 优雅终止慢(应用拒绝退出)

诊断方向(8.3 节的方法论):先看 PVC 状态(Pending/Bound),再看 Pod 事件。有状态应用扩缩容慢,一半原因在存储供给。

PVC 供给的异步性:卷不是「建个对象」就有的

PVC 对象创建成功,不等于卷可用。它的生命周期(2.1 节两级 owner 之外的第三级):

PVC 状态含义谁推动
Pending已声明,等供给存储插件(CSI provisioner)
Bound绑定到 PV存储插件/调度器
Lost绑定的 PV 丢失存储插件

供给是异步的:PVC 创建后,CSI provisioner 在存储后端真正创建卷、生成 PV 对象、绑定 PVC。这中间可能几十秒到几分钟。

对 STS 的影响:

  1. 扩容卡住的常见原因:PVC 一直 Pending(StorageClass 配额不足、后端不可用),Pod 因「卷未就绪」挂起。
  2. 有序创建 + 异步供给叠加:web-0 的 PVC 还没 Bound,web-0 就起不来,web-1 跟着卡——序控制把供给延迟也串行化了。
  3. 延迟绑定(WaitForFirstConsumer):某些 StorageClass 让卷在「第一个 Pod 调度时」才供给——这能改善局部性,但也让「卷就绪」进一步依赖「调度成功」。

有状态应用的扩容 = 卷供给 + Pod 就绪的双重等待。排障时先确认 PVC 状态(Pending/Bound),再查 Pod——缺卷时 Pod 状态通常停在 ContainerCreating。

缩容的回收策略:三种选择

缩容后 PVC 保留(前面已说),但「最终回收」有三种路径:

回收方式做法适用
手动删除kubectl delete pvc data-web-3确认数据不要了
StorageClass 的 reclaimPolicy=DeletePV 释放时自动删卷测试/无价值数据
reclaimPolicy=Retain卷保留在存储后端需要人工归档

回收决策的考量:

  1. 缩容 ≠ 删数据:PVC 保留是「默认安全」——数据可能还有用。
  2. 自动删除的风险:reclaimPolicy=Delete 下,删 PVC 即删卷,数据无法恢复——用之前要确认「数据真的不要了」。
  3. Retain 的成本:卷留在存储后端,占空间、要运维处理——适合「有合规要求的归档」。

有状态运维的核心纪律:卷的生命周期与 Pod 分离管理。删 Pod 是「暂停服务」,删 PVC 是「放弃数据」——两个动作的破坏级别完全不同。

三个常见误解

  • 「缩容会删掉数据」——默认不会。PVC 保留,数据在卷里;彻底清理需手动删 PVC。
  • 「所有副本共享一个卷」——错误。volumeClaimTemplates 为每个 Pod 生成独立 PVC。
  • 「有状态应用也可以用 Deployment 加存储」——共享卷 + 随机 Pod 名 + 无顺序 = 有状态应用不可用。必须用 STS。

本节 lab

本节验证序控制下的扩缩容路径(卷语义是其延伸):

cd private/labs/k8s-ctrl-lab
go test ./controller -run 'TestStatefulSetOrderedCreate|TestStatefulSetOrderedDelete' -v
  • TestStatefulSetOrderedCreate:按序逐个创建——扩容时「一个就绪再下一个」的节奏(卷供给就发生在这个节奏里)。
  • TestStatefulSetOrderedDelete:按序逐个删除——缩容时「最大序号先下」的顺序(卷保留是其伴生语义)。

继续阅读

探索更多技术文章

浏览归档,发现更多关于系统设计、工具链和工程实践的内容。

全部文章 返回首页

「books」更多文章

  1. 《大规模分布式计算深入解析》15.3 落地:从 Neo4j 到自研图引擎
  2. 《大规模分布式计算深入解析·图计算与图数据库内核》 · 目录与学习路径(45 篇)
  3. 《大规模分布式计算深入解析》15.2 十一卷主线:从切分到图