容器与云原生 / 系统课时
StatefulSet 持久化实践
StatefulSet 持久化实践
StatefulSet 的关键不只是让 Pod 名称带序号,而是让每个序号绑定自己的持久化存储。本节用 volumeClaimTemplates 创建两个独立 PVC,并通过删除重建 Pod 验证数据仍由原序号继续使用。
学习目标
- 理解 StatefulSet、Pod 序号与 PVC 之间的稳定绑定关系。
- 使用
volumeClaimTemplates为每个副本自动创建独立 PVC。 - 通过重建 Pod 验证卷不会随着 Pod 生命周期一起消失。
稳定身份为什么需要独立存储
普通 Deployment 的副本通常可以互换,但有状态应用往往要求“实例身份”和“实例数据”一一对应。StatefulSet 会按 web-0、web-1 这样的序号创建 Pod;volumeClaimTemplates 则以同一序号生成 PVC,例如 data-web-0、data-web-1。
当 web-0 因故障或人工删除而重建时,新 Pod 仍然叫 web-0,并重新挂载 data-web-0。这样数据库分片、本地索引或需要固定磁盘的服务就不会因为 Pod 被替换而拿错数据。

创建带 volumeClaimTemplates 的 StatefulSet
下面示例假设集群存在默认 StorageClass,并支持动态创建 ReadWriteOnce 卷。将配置保存为 statefulset.yaml。Headless Service 用于 StatefulSet 的稳定网络身份,PVC 模板名为 data。
apiVersion: v1
kind: List
items:
- 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: 2
selector:
matchLabels:
app: web
template:
metadata:
labels:
app: web
spec:
containers:
- name: nginx
image: nginx:1.27-alpine
ports:
- containerPort: 80
volumeMounts:
- name: data
mountPath: /data
volumeClaimTemplates:
- metadata:
name: data
spec:
accessModes:
- ReadWriteOnce
resources:
requests:
storage: 1GivolumeClaimTemplates 不是“一个模板对应一个共享卷”,而是控制器按每个 Pod 序号各创建一份 PVC。申请的容量、访问模式和 StorageClass 选择会被复制到这些 PVC 上。
部署并检查每个副本的 PVC
应用资源后,等待 StatefulSet 的两个副本全部就绪,再直接查看 Pod 与 PVC 的名称和状态。
kubectl apply -f statefulset.yaml
kubectl wait --for=jsonpath='{.status.readyReplicas}'=2 statefulset/web --timeout=180s
kubectl get pod web-0 web-1 -o custom-columns='NAME:.metadata.name,STATUS:.status.phase'
kubectl get pvc data-web-0 data-web-1 -o custom-columns='NAME:.metadata.name,STATUS:.status.phase'预期输出
service/web created
statefulset.apps/web created
statefulset.apps/web condition met
NAME STATUS
web-0 Running
web-1 Running
NAME STATUS
data-web-0 Bound
data-web-1 Bound如果 PVC 长时间处于 Pending,优先检查默认 StorageClass 是否存在、动态供应器是否正常,以及它是否支持所申请的访问模式;此时 StatefulSet 本身通常不是根因。
删除 Pod 验证数据是否保留
先向 web-0 的卷写入一个标记文件,再删除这个 Pod。删除命令完成后等待同名 Pod 重新出现并就绪,最后读取原来的文件。
kubectl exec web-0 -- sh -c 'echo keep-me > /data/marker'
kubectl delete pod web-0
until kubectl get pod web-0 >/dev/null 2>&1; do sleep 2; done
kubectl wait --for=condition=Ready pod/web-0 --timeout=180s
kubectl exec web-0 -- cat /data/marker预期输出
pod "web-0" deleted
pod/web-0 condition met
keep-me看到 keep-me 说明数据存放在 PVC 对应的持久卷中,而不是旧 Pod 的可写层。实际删除和重建耗时会因镜像拉取、调度与存储挂载而不同。
理解扩缩容与删除边界
缩容 StatefulSet 时,被移除序号的 PVC 默认不会跟着自动删除;之后再次扩容到相同序号,通常会继续使用原 PVC。删除 StatefulSet 也不等于删除它创建的全部 PVC,这种默认行为是为了降低误删有状态数据的风险。
如果确实希望在缩容或删除 StatefulSet 时联动清理 PVC,应显式评估并配置 persistentVolumeClaimRetentionPolicy,同时确认备份和回收策略。对生产数据而言,先保留 PVC、确认无用后再清理,通常比自动删除更安全。