容器与云原生 / 系统课时

为 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 实例消失就自动重建一份数据。

StatefulSet 序号、PVC 与扩缩容生命周期

用 volumeClaimTemplates 创建稳定卷

下面的清单同时创建 Headless Service 和 StatefulSet。示例依赖集群已有可动态供给的默认 StorageClass;如果没有默认类,应在 volumeClaimTemplates.spec.storageClassName 中显式填写可用的 StorageClass。

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

selector.matchLabels 必须与 Pod 模板标签匹配,否则 StatefulSet 无法通过 API 校验。whenScaled: Retain 表示缩容时保留被缩掉序号对应的 PVC;whenDeleted: Retain 表示删除 StatefulSet 时也保留其 PVC。两者只决定 StatefulSet 是否清理 PVC,不会把卷内容复制到其他序号。

保存为 statefulset-storage.yaml 后首次应用,并检查 Pod 与 PVC:

bash
kubectl apply -f statefulset-storage.yaml
kubectl rollout status statefulset/storage-demo
kubectl get pod,pvc -l app=storage-demo

预期输出:

text
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 都应继续存在。

bash
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

预期输出:

text
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 恢复后读取标记:

bash
kubectl scale statefulset storage-demo --replicas=3
kubectl rollout status statefulset/storage-demo
kubectl exec storage-demo-2 -- cat /data/marker.txt

预期输出:

text
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 实例。

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

目录与阅读设置

阅读设置

17

记录一个想法

为 StatefulSet 设计持久卷

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

登录哪都通