StatefulSet 是唯一满足固定 Pod 名称、独立 PVC 绑定、有序启停的控制器,依赖 Headless Service 实现稳定 DNS,需严格匹配 serviceName、volumeClaimTemplates 和 podManagementPolicy 三字段。

StatefulSet 是唯一能同时满足「固定 Pod 名称」「独立 PVC 绑定」「有序启停」这三项要求的控制器,Deployment 做不到,DaemonSet 和 Job 更不适用。
必须先创建 Headless Service
StatefulSet 依赖无头服务(spec.clusterIP: None)来生成稳定的 DNS 记录,比如 myapp-0.myapp-svc.default.svc.cluster.local。没这个 Service,Pod 根本拿不到可解析的主机名,Go 应用里用 os.Hostname() 或 hostname -f 拿到的只是空或随机字符串。
- Service 名必须和 StatefulSet 的
spec.serviceName字段严格一致(大小写敏感) - Label selector 必须匹配 StatefulSet 中 Pod template 的 labels,否则 DNS A 记录不会生成
- 不要给该 Service 配置
type: LoadBalancer或NodePort—— 它只用于集群内通信,暴露端口靠另外的 Ingress 或 Service
StatefulSet YAML 中三个关键字段不能漏
缺任意一个,就退化成“伪有状态”:Pod 重建后数据丢失、DNS 不稳定、扩缩容乱序。
-
serviceName:必须指向上面定义的 Headless Service 名,不是随便起的 -
volumeClaimTemplates:不能写成volumes+ 静态 PVC 名 —— 那样所有 Pod 共享同一份存储,数据会互相覆盖 -
podManagementPolicy:默认是OrderedReady,如果改成Parallel,就失去“等前一个 Pod Running+Ready 后再启下一个”的保障,etcd 或 MySQL 主从初始化会失败
示例片段:
spec:
serviceName: "myapp-svc"
replicas: 3
volumeClaimTemplates:
- metadata:
name: data
spec:
accessModes: ["ReadWriteOnce"]
resources:
requests:
storage: 5Gi
template:
spec:
containers:
- name: app
image: myorg/mygo-app:v1.2
env:
- name: POD_NAME
valueFrom:
fieldRef:
fieldPath: metadata.nameGo 应用代码里要主动适配 StatefulSet 约束
很多 Go 服务默认按“无状态”写法开发,直接扔进 StatefulSet 会出问题:比如把状态写死在 /tmp,或用本地内存缓存节点身份,Pod 重启后全失效。
- 读取自身 Pod 名:用
os.Getenv("POD_NAME")(推荐)或os.Hostname(),但后者在某些镜像中不可靠 - 持久化路径必须挂载到 PVC 对应目录,例如
volumeMounts设为/data,代码里就写死/data/state.db,别用./state.db - 启动逻辑要容忍“第一次运行时文件不存在”,比如 etcd 初始化需判断
--initial-cluster-state是new还是existing - HTTP 探针路径(
readinessProbe/livenessProbe)最好带节点标识,例如/ready?node=myapp-0,避免健康检查误判
调试时最常卡住的两个点
90% 的 StatefulSet 部署失败都集中在这两处,不是 YAML 写错,而是环境或权限没对齐。
- PVC 处于
Pending状态:检查 StorageClass 是否存在且 provisioner 可用(如kubectl get sc),NFS 或云盘插件是否已安装;volumeClaimTemplates里的storageClassName字段若为空,会走默认 StorageClass,但默认可能被禁用 - Pod 卡在
ContainerCreating:多半是securityContext权限问题 —— Alpine 镜像默认以非 root 用户运行,但挂载 PVC 后目录属主可能是 root,Go 进程没权限写入;加runAsUser: 65532并确保镜像里有对应用户,或用fsGroup: 65532自动 chgrp
真正难的不是写 YAML,而是让 Go 应用理解自己正跑在一个有身份、有专属磁盘、且兄弟节点随时可能还没起来的环境中 —— 这种认知偏差,比 YAML 缩进错误更难排查。


















