容器与云原生 / 系统课时
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。这使其他组件能够按固定身份访问特定实例。

创建 Headless Service 与 StatefulSet
下面的清单使用 Nginx 模拟有状态实例。每个 Pod 启动时把自己的主机名写入独立 PVC,因此既能观察稳定名称,也能验证存储不会因 Pod 重建而丢失。
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: 1GiserviceName 必须指向用于稳定网络标识的 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。
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 名称会因环境而不同。
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 挂载回来。
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预期输出如下。
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 的回收策略。