容器与云原生 / 系统课时

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 被替换而拿错数据。

StatefulSet 副本与独立 PVC 的稳定绑定关系

创建带 volumeClaimTemplates 的 StatefulSet

下面示例假设集群存在默认 StorageClass,并支持动态创建 ReadWriteOnce 卷。将配置保存为 statefulset.yaml。Headless Service 用于 StatefulSet 的稳定网络身份,PVC 模板名为 data。

yaml
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: 1Gi

volumeClaimTemplates 不是“一个模板对应一个共享卷”,而是控制器按每个 Pod 序号各创建一份 PVC。申请的容量、访问模式和 StorageClass 选择会被复制到这些 PVC 上。

部署并检查每个副本的 PVC

应用资源后,等待 StatefulSet 的两个副本全部就绪,再直接查看 Pod 与 PVC 的名称和状态。

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

预期输出

text
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 重新出现并就绪,最后读取原来的文件。

bash
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

预期输出

text
pod "web-0" deleted
pod/web-0 condition met
keep-me

看到 keep-me 说明数据存放在 PVC 对应的持久卷中,而不是旧 Pod 的可写层。实际删除和重建耗时会因镜像拉取、调度与存储挂载而不同。

理解扩缩容与删除边界

缩容 StatefulSet 时,被移除序号的 PVC 默认不会跟着自动删除;之后再次扩容到相同序号,通常会继续使用原 PVC。删除 StatefulSet 也不等于删除它创建的全部 PVC,这种默认行为是为了降低误删有状态数据的风险。

如果确实希望在缩容或删除 StatefulSet 时联动清理 PVC,应显式评估并配置 persistentVolumeClaimRetentionPolicy,同时确认备份和回收策略。对生产数据而言,先保留 PVC、确认无用后再清理,通常比自动删除更安全。

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

目录与阅读设置

阅读设置

17

记录一个想法

StatefulSet 持久化实践

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

登录哪都通