容器与云原生 / 系统课时

StatefulSet 有状态应用

StatefulSet 有状态应用

StatefulSet 解决的是“Pod 可以重建,但身份和数据不能随之漂移”的问题。本节通过一个三副本示例观察固定序号、Headless Service、按序创建与独立 PVC 的关系,并验证单个 Pod 重建后哪些信息保持稳定。

学习目标

  • 解释 StatefulSet Pod 的稳定名称、DNS 标识和默认有序管理行为。
  • 使用 serviceName 与 Headless Service 建立稳定网络身份。
  • 使用 volumeClaimTemplates 为每个副本创建独立持久卷声明,并验证 Pod 重建后仍关联原 PVC。

稳定身份由哪些对象共同提供

Deployment 更关注“始终有若干等价副本”,而 StatefulSet 把每个副本视为有序成员。副本名称按 <statefulset>-<ordinal> 生成,例如 db-0、db-1、db-2;默认 OrderedReady 策略会按序创建,终止时反向处理。

网络身份依赖 serviceName 指向的 Headless Service。这样每个 Pod 不只拥有稳定名称,还可以形成类似 db-0.db 的可解析服务内 DNS 名称。存储则由 volumeClaimTemplates 为每个序号生成独立 PVC,使 Pod 被重新调度后仍能回到自己的卷。

StatefulSet 稳定身份与持久卷关联

最小 StatefulSet 配置

下面的配置假设集群已有默认 StorageClass。Headless Service 的 clusterIP: None 不提供单一虚拟 IP,而是让客户端能够发现各个 StatefulSet Pod;serviceName: db 把 StatefulSet 的网络身份与该 Service 关联。

yaml
apiVersion: v1
kind: Service
metadata:
  name: db
spec:
  clusterIP: None
  selector:
    app: db
  ports:
    - name: http
      port: 80
---
apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: db
spec:
  serviceName: db
  replicas: 3
  selector:
    matchLabels:
      app: db
  template:
    metadata:
      labels:
        app: db
    spec:
      containers:
        - name: web
          image: nginx:1.25-alpine
          ports:
            - containerPort: 80
          volumeMounts:
            - name: data
              mountPath: /usr/share/nginx/html
  volumeClaimTemplates:
    - metadata:
        name: data
        labels:
          app: db
      spec:
        accessModes:
          - ReadWriteOnce
        resources:
          requests:
            storage: 1Gi

将内容保存为 stateful-demo.yaml 后应用。若集群没有默认 StorageClass,PVC 会保持 Pending,此时应为模板指定实际可用的 storageClassName。

bash
# 创建 Headless Service 和 StatefulSet,并等待有序发布完成
kubectl apply -f stateful-demo.yaml
kubectl rollout status statefulset/db --timeout=180s

# 用稳定列观察 Pod 序号和每个副本生成的 PVC
kubectl get pods -l app=db -o custom-columns=NAME:.metadata.name,PHASE:.status.phase
kubectl get pvc -l app=db -o custom-columns=NAME:.metadata.name,STATUS:.status.phase,VOLUME:.spec.volumeName

预期输出

text
service/db created
statefulset.apps/db created
statefulset rolling update complete 3 pods at revision <ID>
NAME   PHASE
db-0   Running
db-1   Running
db-2   Running
NAME        STATUS   VOLUME
data-db-0   Bound    <ID>
data-db-1   Bound    <ID>
data-db-2   Bound    <ID>

<ID> 表示集群实际生成的 StatefulSet 修订或存储卷标识,实际值可能不同;如果对象此前已经存在,kubectl apply 也可能显示 configured 或 unchanged。

重建 Pod 观察不变部分

删除 db-1 后,StatefulSet 会重新创建同名 Pod。下面先记录 data-db-1 当前绑定的卷,再删除 Pod,待其恢复后再次读取卷标识。

bash
# 记录卷标识,删除中间序号 Pod,再确认同名 Pod 恢复
BEFORE=$(kubectl get pvc data-db-1 -o jsonpath='{.spec.volumeName}')
kubectl delete pod db-1
kubectl wait --for=condition=Ready pod/db-1 --timeout=180s
AFTER=$(kubectl get pvc data-db-1 -o jsonpath='{.spec.volumeName}')
echo before=$BEFORE
echo after=$AFTER

预期输出

text
pod "db-1" deleted
pod/db-1 condition met
before=<ID>
after=<ID>

两处 <ID> 应相同,说明 Pod 的运行实例可以被替换,但 db-1 的序号身份和 data-db-1 的存储关联仍被保留。若应用本身还要求主从选举、分片成员变更或数据复制,StatefulSet 只提供稳定身份与编排基础,这些一致性逻辑仍需由数据库或应用自身负责。

有序行为的边界

默认有序创建要求前一个序号达到 Ready 后才继续,因此某个低序号 Pod 长时间不就绪时,后续副本也可能被阻塞。生产环境还应关注 PVC 回收策略、StorageClass 能力、PodDisruptionBudget 与应用自己的成员变更规则,避免把“Pod 名称稳定”误认为“业务状态天然一致”。

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

目录与阅读设置

阅读设置

17

记录一个想法

StatefulSet 有状态应用

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

登录哪都通