Kubernetes StatefulSet 实战从创建到运维的完整指南一、前言StatefulSet 实战核心目标本文围绕StatefulSet 的创建、验证、扩容缩容、更新、删除五大核心操作结合完整命令与输出示例帮你掌握如何快速搭建 StatefulSet Headless Service 环境验证 StatefulSet 的三大核心特性稳定网络、持久存储、有序操作生产环境常用运维操作扩容、缩容、版本更新、删除关键配置更新策略、分区发布的实操落地。二、核心前提StatefulSet 依赖组件StatefulSet 运行必须满足两个核心依赖Headless Service提供稳定网络标识DNS 解析clusterIP: NonePersistentVolumePV通过volumeClaimTemplates自动创建保障数据持久化。三、实战步骤 1创建 StatefulSet 与 Headless Service3.1 配置文件web.yaml--- # Headless Service提供稳定网络标识 apiVersion: v1 kind: Service metadata: name: nginx labels: app: nginx spec: ports: - port: 80 name: web clusterIP: None # 关键无集群 IP仅提供 DNS 解析 selector: app: nginx --- # StatefulSet 配置2 个副本 1Gi 持久存储 apiVersion: apps/v1beta1 kind: StatefulSet metadata: name: web spec: serviceName: nginx # 关联 Headless Service replicas: 2 template: metadata: labels: app: nginx spec: containers: - name: nginx image: gcr.io/google_containers/nginx-slim:0.8 ports: - containerPort: 80 name: web volumeMounts: - name: www # 与 volumeClaimTemplates 名称一致 mountPath: /usr/share/nginx/html # 持久存储模板自动为每个 Pod 创建 PVC volumeClaimTemplates: - metadata: name: www spec: accessModes: [ ReadWriteOnce ] # 单节点读写 resources: requests: storage: 1Gi3.2 执行创建命令打开两个终端窗口终端 1监控 Pod 状态kubectl get pods -w -l appnginx终端 2执行创建操作kubectl create -f web.yaml # 输出 # service nginx created # statefulset web created验证创建结果# 查看 Headless Service kubectl get service nginx # 输出NAME CLUSTER-IP EXTERNAL-IP PORT(S) AGE # nginx None 80/TCP 12s # 查看 StatefulSet kubectl get statefulset web # 输出NAME DESIRED CURRENT AGE # web 2 2 30s3.3 关键现象有序创建 Pod终端 1 监控到的 Pod 创建顺序web-0 0/1 Pending 0 0s web-0 1/1 Running 0 19s # 先启动 web-0 web-1 0/1 Pending 0 0s web-1 1/1 Running 0 18s # web-0 就绪后启动 web-1核心特性StatefulSet 按0→1→N-1顺序创建 Pod前一个就绪后才启动下一个。四、实战步骤 2验证 StatefulSet 核心特性4.1 验证稳定网络标识每个 Pod 拥有固定主机名和 DNS 地址# 1. 查看 Pod 主机名固定为 statefulset 名称-序号 for i in 0 1; do kubectl exec web-$i -- sh -c hostname; done # 输出 # web-0 # web-1 # 2. 验证集群内 DNS 解析使用 dnsutils 容器 kubectl run -i --tty --image busybox dns-test --restartNever --rm /bin/sh # 执行 nslookup nslookup web-0.nginx # 输出Address 1: 10.244.1.6 web-0.nginx.default.svc.cluster.local nslookup web-1.nginx # 输出Address 1: 10.244.2.6 web-1.nginx.default.svc.cluster.local关键结论即使 Pod 重建主机名和 DNS 地址不变仅 IP 可能更新。4.2 验证稳定持久存储数据不随 Pod 重建丢失# 1. 向每个 Pod 的存储写入主机名模拟业务数据 for i in 0 1; do kubectl exec web-$i -- sh -c echo $(hostname) /usr/share/nginx/html/index.html; done # 2. 验证数据写入成功 for i in 0 1; do kubectl exec -it web-$i -- curl localhost; done # 输出 # web-0 # web-1 # 3. 删除所有 Pod观察重建后数据是否保留 kubectl delete pod -l appnginx # 等待 Pod 重建完成后再次验证 for i in 0 1; do kubectl exec -it web-$i -- curl localhost; done # 输出仍为 web-0、web-1数据未丢失核心特性每个 Pod 绑定独立 PV删除 Pod 后 PV 不删除重建后自动挂载。五、实战步骤 3常用运维操作扩容 / 缩容 / 更新 / 删除5.1 扩容 StatefulSet从 2 到 5 个副本# 终端 1 监控 Pod 状态kubectl get pods -w -l appnginx # 终端 2 执行扩容 kubectl scale sts web --replicas5 # 输出statefulset web scaled关键现象按2→3→4顺序创建 Pod每个 Pod 就绪后才启动下一个。5.2 缩容 StatefulSet从 5 到 3 个副本# 终端 1 监控 Pod 状态 # 终端 2 执行缩容 kubectl patch sts web -p {spec:{replicas:3}} # 输出web patched关键现象按4→3反向顺序删除 Pod前一个 Pod 完全终止后才删除下一个。5.3 更新 StatefulSet镜像版本升级StatefulSet 支持两种更新策略实操如下策略 1OnDelete默认手动触发更新# 1. 修改镜像版本从 0.8 到 0.7 kubectl patch statefulset web --typejson -p[{op: replace, path: /spec/template/spec/containers/0/image, value:gcr.io/google_containers/nginx-slim:0.7}] # 2. 手动删除 Pod触发更新仅删除的 Pod 会更新 kubectl delete pod web-0 web-1 web-2 # 3. 验证更新结果 kubectl get pod -l appnginx -o jsonpath{range .items[*]}{.metadata.name}{t}{.spec.containers[0].image}{n}{end} # 输出所有 Pod 镜像已更新为 0.7策略 2RollingUpdate自动滚动更新# 1. 配置滚动更新策略 kubectl patch statefulset web -p {spec:{updateStrategy:{type:RollingUpdate}}} # 2. 修改镜像版本从 0.7 回滚到 0.8 kubectl patch statefulset web --typejson -p[{op: replace, path: /spec/template/spec/containers/0/image, value:gcr.io/google_containers/nginx-slim:0.8}] # 3. 监控更新过程反向顺序web-2→web-1→web-0 kubectl get po -l appnginx -w高级操作分区更新金丝雀发布仅更新序号 ≥ partition 的 Pod# 1. 配置分区仅更新序号 ≥2 的 Pod即 web-2 kubectl patch statefulset web -p {spec:{updateStrategy:{type:RollingUpdate,rollingUpdate:{partition:2}}}} # 2. 修改镜像版本仅 web-2 会更新 kubectl patch statefulset web --typejson -p[{op: replace, path: /spec/template/spec/containers/0/image, value:gcr.io/google_containers/nginx-slim:0.7}] # 3. 验证结果仅 web-2 为 0.7其余为 0.8 kubectl get pod -l appnginx -o jsonpath{range .items[*]}{.metadata.name}{t}{.spec.containers[0].image}{n}{end}5.4 删除 StatefulSet方式 1非级联删除仅删 StatefulSet保留 Pod 和 PVkubectl delete statefulset web --cascadefalse # 验证Pod 仍运行PV 保留 kubectl get pods -l appnginx kubectl get pvc -l appnginx方式 2级联删除删 StatefulSet Pod保留 PVkubectl delete statefulset web # 验证Pod 按反向顺序删除PV 仍存在 kubectl get pods -l appnginx # 无输出 kubectl get pvc -l appnginx # 仍显示绑定状态 # 手动删除 Headless Service级联删除不会删 Service kubectl delete service nginx六、关键配置与生产实践总结操作类型核心命令 / 配置关键注意事项创建kubectl create -f web.yaml必须先创建 Headless Service扩容 / 缩容kubectl scale sts plicasN有序扩容、反向缩容依赖前驱 Pod 就绪版本更新RollingUpdate/OnDelete生产环境优先用RollingUpdate支持回滚金丝雀发布partition: N仅更新序号 ≥N 的 Pod适合灰度验证删除--cascadefalse/ 默认PV 永远不会自动删除需手动清理无用 PV数据持久化volumeClaimTemplates确保 StorageClass 已配置避免 PVC Pending七、核心结论StatefulSet 的核心价值是稳定标识 持久存储 有序操作专为数据库、缓存等有状态服务设计运维关键牢记「有序创建 / 缩容 / 更新」特性避免强制终止 Pod 导致数据不一致存储管理删除 StatefulSet 后需手动清理无用 PV避免存储资源浪费更新策略生产环境优先使用RollingUpdate partition实现安全的灰度发布和版本回滚。通过本文实操可快速掌握 StatefulSet 从部署到运维的全流程直接复用命令和配置到生产环境。