容器与云原生 / 系统课时

StatefulSet 有状态应用

StatefulSet 有状态应用

本课用一个三副本 StatefulSet 展示稳定 Pod 名称、固定 DNS、顺序创建以及 PVC 一对一绑定机制,并通过删除 Pod 后重新读取文件,验证实例重建后网络身份和持久化数据仍可延续。

学习目标

  • 说明 StatefulSet 与 Deployment 在实例身份和存储管理上的关键差异
  • 配置 Headless Service、StatefulSet 与 volumeClaimTemplates
  • 验证 Pod 顺序、稳定名称和 PVC 重绑定行为

StatefulSet 解决什么问题

Deployment 适合可以互换的无状态副本,而数据库、消息队列和分片服务常需要区分实例。StatefulSet 为每个 Pod 分配连续序号,例如 stateful-web-0、stateful-web-1,实例重建后仍使用相同名称。

StatefulSet 通常与 Headless Service 配合。Service 的 clusterIP: None 不提供统一虚拟 IP,而是为各 Pod 生成可解析的 DNS 记录,例如 stateful-web-0.stateful-web。这使其他组件能够按固定身份访问特定实例。

StatefulSet 稳定身份、顺序与存储绑定关系

创建 Headless Service 与 StatefulSet

下面的清单使用 Nginx 模拟有状态实例。每个 Pod 启动时把自己的主机名写入独立 PVC,因此既能观察稳定名称,也能验证存储不会因 Pod 重建而丢失。

yaml
apiVersion: v1
kind: Service
metadata:
  name: stateful-web
spec:
  clusterIP: None
  selector:
    app: stateful-web
  ports:
    - name: http
      port: 80
---
apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: stateful-web
spec:
  serviceName: stateful-web
  replicas: 3
  podManagementPolicy: OrderedReady
  selector:
    matchLabels:
      app: stateful-web
  template:
    metadata:
      labels:
        app: stateful-web
    spec:
      containers:
        - name: nginx
          image: nginx:1.26-alpine
          command: ["/bin/sh", "-c"]
          args:
            - echo "$(hostname)" > /usr/share/nginx/html/index.html && exec nginx -g 'daemon off;'
          ports:
            - containerPort: 80
          readinessProbe:
            httpGet:
              path: /
              port: 80
            periodSeconds: 3
          volumeMounts:
            - name: data
              mountPath: /usr/share/nginx/html
  volumeClaimTemplates:
    - metadata:
        name: data
      spec:
        accessModes:
          - ReadWriteOnce
        resources:
          requests:
            storage: 1Gi

serviceName 必须指向用于稳定网络标识的 Service。volumeClaimTemplates 会按“卷模板名-StatefulSet 名-序号”创建 PVC;这里对应 data-stateful-web-0 到 data-stateful-web-2。清单未指定 storageClassName,因此依赖集群默认 StorageClass。

部署并观察顺序

将清单保存为 stateful-web.yaml 后执行以下命令。默认的 OrderedReady 会先等待 stateful-web-0 就绪,再创建 stateful-web-1,最后创建 stateful-web-2。

bash
kubectl apply -f stateful-web.yaml
kubectl rollout status statefulset/stateful-web
kubectl get pods -l app=stateful-web
kubectl get pvc
kubectl exec stateful-web-0 -- cat /usr/share/nginx/html/index.html

预期输出的关键部分如下,AGE、卷 ID 和 StorageClass 名称会因环境而不同。

text
service/stateful-web created
statefulset.apps/stateful-web created
statefulset rolling update complete 3 pods at revision stateful-web-<ID>
NAME             READY   STATUS    RESTARTS   AGE
stateful-web-0   1/1     Running   0          <AGE>
stateful-web-1   1/1     Running   0          <AGE>
stateful-web-2   1/1     Running   0          <AGE>
NAME                  STATUS   VOLUME   CAPACITY   ACCESS MODES   STORAGECLASS   AGE
data-stateful-web-0   Bound    <ID>     1Gi        RWO            <CLASS>        <AGE>
data-stateful-web-1   Bound    <ID>     1Gi        RWO            <CLASS>        <AGE>
data-stateful-web-2   Bound    <ID>     1Gi        RWO            <CLASS>        <AGE>
stateful-web-0

如果 Pod 长时间停在 Pending,先查看 PVC 是否也为 Pending。最常见原因是集群没有默认 StorageClass、请求的访问模式不受支持,或动态供给器不可用。

验证重建后的持久化

先在 0 号实例的 PVC 中写入标记,再删除该 Pod。StatefulSet 会重新创建同名 Pod,并把原来的 data-stateful-web-0 挂载回来。

bash
kubectl exec stateful-web-0 -- sh -c 'echo persistent-marker > /usr/share/nginx/html/marker.txt'
kubectl delete pod stateful-web-0
kubectl rollout status statefulset/stateful-web --timeout=180s
kubectl exec stateful-web-0 -- cat /usr/share/nginx/html/marker.txt

预期输出如下。

text
pod "stateful-web-0" deleted
statefulset rolling update complete 3 pods at revision stateful-web-<ID>
persistent-marker

这里稳定的是实例身份与卷绑定,不是 Pod 进程本身。Pod 的 UID 和 IP 在重建后通常会变化,但名称、序号、DNS 规则和对应 PVC 保持一致。

顺序管理与删除边界

默认策略下,扩容按序号递增,缩容按序号递减;滚动更新也通常从最大序号向最小序号推进。只有前一个实例达到 Ready,后一个实例才继续创建,因此错误的探针可能阻塞整个扩容或更新过程。

未显式配置 persistentVolumeClaimRetentionPolicy 时,删除 StatefulSet 默认不会删除已经创建的 PVC,这是为了避免误删数据。确认数据不再需要后,应单独审查并删除 PVC;底层存储是否保留还取决于 PersistentVolume 的回收策略。

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

目录与阅读设置

阅读设置

17

记录一个想法

StatefulSet 有状态应用

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

登录哪都通