容器与云原生 / 系统课时

StatefulSet 持久存储

StatefulSet 持久存储

本课解决“多个有状态副本如何各自绑定稳定存储”的问题。你将使用 volumeClaimTemplates 为 StatefulSet 的每个 Pod 自动创建独立 PVC,并验证 Pod 重建后仍挂载原有数据。

学习目标

  • 解释 StatefulSet 副本、固定序号、PVC 与 PV 的一一对应关系
  • 使用 volumeClaimTemplates 声明每副本独立存储
  • 验证 Pod 重建、缩容和删除场景下的数据保留行为

稳定身份与存储绑定

StatefulSet 的 Pod 名称包含固定序号,例如 web-0、web-1。volumeClaimTemplates 会按“模板名-StatefulSet 名-序号”创建 PVC,因此每个副本拥有独立卷,Pod 被重建后仍会按相同名称找回原 PVC。

StatefulSet 副本与独立持久卷绑定关系

这里的稳定性来自名称和控制器规则,而不是 Pod 本身永久存在。Pod 可以被删除或迁移,但相同序号的新 Pod 会继续声明并挂载原来的 PVC。

创建带持久卷的 StatefulSet

下面的清单包含 Headless Service 与 StatefulSet。示例复用上一课的 app-gp3 StorageClass;若你的集群使用其他动态供给类,请修改 storageClassName。

yaml
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 后执行:

bash
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'

预期输出:

text
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>   2Gi

PVC 和 PV 的实际 ID、创建时间及 Pod 启动顺序可能不同。关键验收点是三个 Pod 均运行,且三个 PVC 分别处于 Bound 状态。

验证 Pod 重建后数据仍在

先读取 web-1 保存的身份,再删除该 Pod。StatefulSet 会重建同名 Pod,并重新挂载 data-web-1。

bash
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

预期输出:

text
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 通常还会删除后端卷。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

StatefulSet 持久存储

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通