容器与云原生 / 系统课时
StatefulSet 持久存储
StatefulSet 持久存储
本课解决“多个有状态副本如何各自绑定稳定存储”的问题。你将使用 volumeClaimTemplates 为 StatefulSet 的每个 Pod 自动创建独立 PVC,并验证 Pod 重建后仍挂载原有数据。
学习目标
- 解释 StatefulSet 副本、固定序号、PVC 与 PV 的一一对应关系
- 使用
volumeClaimTemplates声明每副本独立存储 - 验证 Pod 重建、缩容和删除场景下的数据保留行为
稳定身份与存储绑定
StatefulSet 的 Pod 名称包含固定序号,例如 web-0、web-1。volumeClaimTemplates 会按“模板名-StatefulSet 名-序号”创建 PVC,因此每个副本拥有独立卷,Pod 被重建后仍会按相同名称找回原 PVC。

这里的稳定性来自名称和控制器规则,而不是 Pod 本身永久存在。Pod 可以被删除或迁移,但相同序号的新 Pod 会继续声明并挂载原来的 PVC。
创建带持久卷的 StatefulSet
下面的清单包含 Headless Service 与 StatefulSet。示例复用上一课的 app-gp3 StorageClass;若你的集群使用其他动态供给类,请修改 storageClassName。
apiVersion: v1
kind: Service
metadata:
name: web
spec:
clusterIP: None
selector:
app: web
ports:
- name: http
port: 80
---
apiVersion: apps/v1
kind: StatefulSet
metadata:
name: web
spec:
serviceName: web
replicas: 3
selector:
matchLabels:
app: web
template:
metadata:
labels:
app: web
spec:
containers:
- name: app
image: busybox:1.36
command:
- sh
- -c
- |
test -f /data/identity.txt || hostname > /data/identity.txt
while true; do sleep 3600; done
volumeMounts:
- name: data
mountPath: /data
volumeClaimTemplates:
- metadata:
name: data
labels:
app: web
spec:
accessModes:
- ReadWriteOnce
storageClassName: app-gp3
resources:
requests:
storage: 2Gi模板只写一次,控制器会为三个副本分别创建 PVC。ReadWriteOnce 表示卷通常只允许在一个节点上以读写方式挂载,但不代表同一 Pod 内只能有一个容器访问该卷。
将内容保存为 stateful-web.yaml 后执行:
kubectl apply -f stateful-web.yaml
kubectl rollout status statefulset/web --timeout=300s >/dev/null
kubectl get pod -l app=web -o custom-columns='NAME:.metadata.name,READY:.status.containerStatuses[0].ready,PHASE:.status.phase'
kubectl get pvc -l app=web -o custom-columns='NAME:.metadata.name,STATUS:.status.phase,VOLUME:.spec.volumeName,CAPACITY:.status.capacity.storage'预期输出:
service/web created
statefulset.apps/web created
NAME READY PHASE
web-0 true Running
web-1 true Running
web-2 true Running
NAME STATUS VOLUME CAPACITY
data-web-0 Bound pvc-<ID> 2Gi
data-web-1 Bound pvc-<ID> 2Gi
data-web-2 Bound pvc-<ID> 2GiPVC 和 PV 的实际 ID、创建时间及 Pod 启动顺序可能不同。关键验收点是三个 Pod 均运行,且三个 PVC 分别处于 Bound 状态。
验证 Pod 重建后数据仍在
先读取 web-1 保存的身份,再删除该 Pod。StatefulSet 会重建同名 Pod,并重新挂载 data-web-1。
kubectl exec web-1 -- cat /data/identity.txt
kubectl delete pod web-1
kubectl wait --for=condition=Ready pod/web-1 --timeout=180s >/dev/null
kubectl exec web-1 -- cat /data/identity.txt预期输出:
web-1
pod "web-1" deleted
web-1两次读取结果一致,说明数据位于持久卷而不是容器可写层。若 Pod 一直处于 Pending,应检查 PVC Events、卷所在拓扑、节点可用区和 CSI 挂载错误。
生命周期边界
默认情况下,缩容或删除 StatefulSet 不会自动删除已有 PVC,这可以防止误删数据,但也可能留下闲置卷并持续计费。正式环境应建立明确的备份、回收与人工确认流程,再决定是否删除 PVC。
扩容时,新序号会创建新 PVC;重新扩回已存在的序号时,控制器会复用原 PVC。不要让多个副本共享同一个 ReadWriteOnce PVC,否则调度和挂载可能冲突,也会破坏副本数据隔离。
删除测试资源前,先确认数据可以丢弃,再执行 kubectl delete -f stateful-web.yaml 和 kubectl delete pvc data-web-0 data-web-1 data-web-2。当 StorageClass 使用 Delete 回收策略时,删除 PVC 通常还会删除后端卷。