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:
| Pod | PVC | 卷 |
|---|---|---|
| web-0 | data-web-0 | 独立的 1Gi 卷 |
| web-1 | data-web-1 | 独立的 1Gi 卷 |
| web-2 | data-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 + 它的数据」。
扩缩容失败场景:卷是慢环节
有状态扩缩容的失败往往发生在卷环节:
| 症状 | 根因 |
|---|---|
| 扩容卡在 Pending | PVC 未绑定(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 的影响:
- 扩容卡住的常见原因:PVC 一直 Pending(StorageClass 配额不足、后端不可用),Pod 因「卷未就绪」挂起。
- 有序创建 + 异步供给叠加:web-0 的 PVC 还没 Bound,web-0 就起不来,web-1 跟着卡——序控制把供给延迟也串行化了。
- 延迟绑定(WaitForFirstConsumer):某些 StorageClass 让卷在「第一个 Pod 调度时」才供给——这能改善局部性,但也让「卷就绪」进一步依赖「调度成功」。
有状态应用的扩容 = 卷供给 + Pod 就绪的双重等待。排障时先确认 PVC 状态(Pending/Bound),再查 Pod——缺卷时 Pod 状态通常停在 ContainerCreating。
缩容的回收策略:三种选择
缩容后 PVC 保留(前面已说),但「最终回收」有三种路径:
| 回收方式 | 做法 | 适用 |
|---|---|---|
| 手动删除 | kubectl delete pvc data-web-3 | 确认数据不要了 |
| StorageClass 的 reclaimPolicy=Delete | PV 释放时自动删卷 | 测试/无价值数据 |
| reclaimPolicy=Retain | 卷保留在存储后端 | 需要人工归档 |
回收决策的考量:
- 缩容 ≠ 删数据:PVC 保留是「默认安全」——数据可能还有用。
- 自动删除的风险:reclaimPolicy=Delete 下,删 PVC 即删卷,数据无法恢复——用之前要确认「数据真的不要了」。
- 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:按序逐个删除——缩容时「最大序号先下」的顺序(卷保留是其伴生语义)。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。