容器与云原生 / 系统课时
为 StatefulSet 设计持久卷
为 StatefulSet 设计持久卷
StatefulSet 的关键不是简单“给每个 Pod 挂一块盘”,而是让固定 Pod 序号与固定 PVC 身份长期对应。本课用一个可运行示例验证 volumeClaimTemplates 的命名规则、缩扩容复用和 PVC 保留策略,区分“重建 Pod”和“删除数据”这两类操作。
学习目标
- 解释 StatefulSet Pod 序号、
volumeClaimTemplates与 PVC 名称之间的稳定对应关系。 - 预测扩容、缩容和删除 StatefulSet 时 PVC 的保留行为。
- 通过写入标记、缩容、扩容和回读验证同一序号会复用原 PVC。
先理解 Pod 身份与 PVC 身份
StatefulSet 的 Pod 名称由工作负载名和序号组成,例如 storage-demo-0、storage-demo-1。volumeClaimTemplates 会为每个序号创建独立 PVC,名称通常为 <模板名>-<StatefulSet名>-<序号>;模板名为 data 时,对应 PVC 就是 data-storage-demo-0、data-storage-demo-1。
Pod 可以被删除并重新创建,但只要序号不变,新的 Pod 仍会挂载该序号对应的 PVC。PVC 是独立 API 对象;缩容不会把序号 2 的数据迁移给序号 1,也不会因为某次 Pod 实例消失就自动重建一份数据。

用 volumeClaimTemplates 创建稳定卷
下面的清单同时创建 Headless Service 和 StatefulSet。示例依赖集群已有可动态供给的默认 StorageClass;如果没有默认类,应在 volumeClaimTemplates.spec.storageClassName 中显式填写可用的 StorageClass。
apiVersion: v1
kind: Service
metadata:
name: storage-demo
spec:
clusterIP: None
selector:
app: storage-demo
ports:
- name: peer
port: 80
---
apiVersion: apps/v1
kind: StatefulSet
metadata:
name: storage-demo
spec:
serviceName: storage-demo
replicas: 3
selector:
matchLabels:
app: storage-demo
persistentVolumeClaimRetentionPolicy:
whenDeleted: Retain
whenScaled: Retain
template:
metadata:
labels:
app: storage-demo
spec:
containers:
- name: app
image: busybox:1.36
command: ["sh", "-c", "while true; do sleep 3600; done"]
volumeMounts:
- name: data
mountPath: /data
volumeClaimTemplates:
- metadata:
name: data
labels:
app: storage-demo
spec:
accessModes: ["ReadWriteOnce"]
resources:
requests:
storage: 1Giselector.matchLabels 必须与 Pod 模板标签匹配,否则 StatefulSet 无法通过 API 校验。whenScaled: Retain 表示缩容时保留被缩掉序号对应的 PVC;whenDeleted: Retain 表示删除 StatefulSet 时也保留其 PVC。两者只决定 StatefulSet 是否清理 PVC,不会把卷内容复制到其他序号。
保存为 statefulset-storage.yaml 后首次应用,并检查 Pod 与 PVC:
kubectl apply -f statefulset-storage.yaml
kubectl rollout status statefulset/storage-demo
kubectl get pod,pvc -l app=storage-demo预期输出:
service/storage-demo created
statefulset.apps/storage-demo created
statefulset rolling update complete 3 pods at revision <ID>...
NAME READY STATUS RESTARTS AGE
pod/storage-demo-0 1/1 Running 0 <TIME>
pod/storage-demo-1 1/1 Running 0 <TIME>
pod/storage-demo-2 1/1 Running 0 <TIME>
NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS AGE
persistentvolumeclaim/data-storage-demo-0 Bound <ID> 1Gi RWO <VALUE> <TIME>
persistentvolumeclaim/data-storage-demo-1 Bound <ID> 1Gi RWO <VALUE> <TIME>
persistentvolumeclaim/data-storage-demo-2 Bound <ID> 1Gi RWO <VALUE> <TIME><ID>、<TIME> 与 <VALUE> 会随集群而变化,rollout status 也可能在最终成功行之前出现等待信息。如果 Pod 长时间 Pending,先检查对应 PVC 是否 Pending、默认 StorageClass 是否存在,以及 CSI 驱动能否在目标拓扑供给卷。
用缩容和扩容验证 PVC 复用
先在序号 2 的卷写入标记,再把副本数缩到 1。由于 whenScaled: Retain,序号 1 和 2 的 Pod 会被删除,但三个 PVC 都应继续存在。
kubectl exec storage-demo-2 -- sh -c 'echo ordinal-2 > /data/marker.txt'
kubectl scale statefulset storage-demo --replicas=1
kubectl get pvc -l app=storage-demo预期输出:
statefulset.apps/storage-demo scaled
NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS AGE
data-storage-demo-0 Bound <ID> 1Gi RWO <VALUE> <TIME>
data-storage-demo-1 Bound <ID> 1Gi RWO <VALUE> <TIME>
data-storage-demo-2 Bound <ID> 1Gi RWO <VALUE> <TIME>再扩回 3 个副本,等待序号 2 的 Pod 恢复后读取标记:
kubectl scale statefulset storage-demo --replicas=3
kubectl rollout status statefulset/storage-demo
kubectl exec storage-demo-2 -- cat /data/marker.txt预期输出:
statefulset.apps/storage-demo scaled
statefulset rolling update complete 3 pods at revision <ID>...
ordinal-2看到 ordinal-2 说明重新出现的 storage-demo-2 复用了 data-storage-demo-2,而不是为同一序号重新供给一块空卷。
明确删除策略再做自动清理
如果业务确认缩容后的数据不再需要,可以把 whenScaled 设为 Delete;如果删除整个 StatefulSet 时也应清理其 PVC,可以把 whenDeleted 设为 Delete。自动清理会放大误操作影响,因此生产环境应先明确备份、恢复演练和数据保留要求。
StatefulSet 的稳定性来自“序号身份”和“PVC 身份”一一对应。设计时先决定缩容或删除后是否保留数据,再选择 Retain 或 Delete;验证时用写入标记、缩容、扩容和回读证明数据跟随 PVC 身份,而不是跟随某次 Pod 实例。