容器与云原生 / 系统课时
部署有状态基础组件
部署有状态基础组件
本课用 Redis 演示 Kubernetes 中有状态组件的最小部署闭环:StatefulSet 提供稳定 Pod 身份,Headless Service 提供稳定 DNS,PVC 保存数据,并通过删除 Pod 验证数据不会随容器重建而丢失。
学习目标
- 理解 StatefulSet、Headless Service、Pod 固定序号与 PVC 的对应关系。
- 编写可持久化的 StatefulSet,并让每个副本获得独立存储。
- 验证稳定 DNS、PVC 绑定状态和 Pod 重建后的数据持久性。
先建立有状态对象关系
有状态组件不仅需要“有几个副本”,还要知道“这是哪个副本”以及“它原来使用哪块存储”。StatefulSet 会创建带固定序号的 Pod,例如 redis-0、redis-1;volumeClaimTemplates 为每个序号生成独立 PVC;Headless Service 则让这些 Pod 获得可预测的 DNS 名称。

Headless Service 的 clusterIP: None 不提供统一虚拟 IP,而是让 DNS 直接返回后端 Pod 地址。它特别适合需要成员发现、主从拓扑或固定节点名称的中间件。
编写 Headless Service 与 StatefulSet
下面示例启用 Redis AOF 持久化。将内容保存为 redis-stateful.yaml。示例依赖集群存在默认 StorageClass;如果没有默认 StorageClass,需要在 PVC 模板中显式填写可用的 storageClassName。
apiVersion: v1
kind: Namespace
metadata:
name: microservices
---
apiVersion: v1
kind: Service
metadata:
name: redis
namespace: microservices
spec:
# Headless Service 不分配 ClusterIP,用于稳定成员发现。
clusterIP: None
selector:
app: redis
ports:
- name: redis
port: 6379
targetPort: redis
---
apiVersion: apps/v1
kind: StatefulSet
metadata:
name: redis
namespace: microservices
spec:
# StatefulSet 使用该 Service 形成稳定的 Pod DNS 名称。
serviceName: redis
replicas: 2
selector:
matchLabels:
app: redis
template:
metadata:
labels:
app: redis
spec:
containers:
- name: redis
image: redis:7.4-alpine
args:
- redis-server
- --appendonly
- "yes"
- --dir
- /data
ports:
- name: redis
containerPort: 6379
readinessProbe:
exec:
command:
- redis-cli
- ping
initialDelaySeconds: 3
periodSeconds: 5
resources:
requests:
cpu: 100m
memory: 128Mi
limits:
cpu: 500m
memory: 256Mi
# AOF 数据写到 PVC,而不是写进容器临时文件系统。
volumeMounts:
- name: data
mountPath: /data
# 每个固定序号 Pod 都会由模板获得独立 PVC。
volumeClaimTemplates:
- metadata:
name: data
labels:
app: redis
spec:
accessModes:
- ReadWriteOnce
resources:
requests:
storage: 1Gispec.serviceName 指向负责该 StatefulSet 网络身份的 Headless Service。每个副本会生成独立 PVC,默认命名规则是 <claim-name>-<statefulset-name>-<ordinal>,因此这里会得到 data-redis-0 和 data-redis-1。
创建资源并验证稳定身份
应用清单即可独立创建本课所需 Namespace、Headless Service 和 StatefulSet:
kubectl apply -f redis-stateful.yaml预期输出(首次创建):
namespace/microservices created
service/redis created
statefulset.apps/redis created若 Namespace 已存在,它可能显示 unchanged,不会影响后续资源创建。
等待两个副本就绪后检查 StatefulSet:
kubectl get statefulset redis -n microservices \
-o jsonpath='{.status.readyReplicas}/{.spec.replicas}{"\n"}'预期输出:
2/2检查固定 Pod 名称和 PVC 绑定:
kubectl get pod -n microservices -l app=redis -o name
kubectl get pvc -n microservices -l app=redis \
-o custom-columns=NAME:.metadata.name,STATUS:.status.phase --no-headers预期输出:
pod/redis-0
pod/redis-1
data-redis-0 Bound
data-redis-1 Bound再从 redis-0 通过稳定 DNS 访问 redis-1:
kubectl exec -n microservices redis-0 -- \
redis-cli -h redis-1.redis.microservices.svc.cluster.local PING预期输出:
PONG这同时验证了 Headless Service 的成员发现路径和目标 Pod 的 Redis 端口可达。
验证数据不会随 Pod 重建丢失
先向 redis-0 写入一个键:
kubectl exec -n microservices redis-0 -- redis-cli SET course statefulset预期输出:
OK删除这个 Pod,让 StatefulSet 自动重建同名副本并等待它重新 Ready:
kubectl delete pod redis-0 -n microservices
# 等待控制器重新创建同名 Pod,避免直接 wait 时遇到 NotFound。
until kubectl get pod redis-0 -n microservices >/dev/null 2>&1; do sleep 1; done
kubectl wait --for=condition=Ready pod/redis-0 -n microservices --timeout=120s预期输出:
pod "redis-0" deleted
pod/redis-0 condition met重新读取数据:
kubectl exec -n microservices redis-0 -- redis-cli GET course预期输出:
statefulset能够读回原值,说明新建容器重新挂载了 data-redis-0 对应的持久卷,而不是依赖原 Pod 的临时文件系统。
PVC Pending 时沿存储依赖排查
如果 StatefulSet 一直无法就绪,先检查 PVC 状态和 StorageClass:
kubectl get pvc data-redis-0 -n microservices \
-o custom-columns=NAME:.metadata.name,STATUS:.status.phase,STORAGECLASS:.spec.storageClassName
kubectl get storageclass \
-o custom-columns=NAME:.metadata.name,PROVISIONER:.provisioner若故障点确实是 PVC 尚未制备,预期结果类似:
NAME STATUS STORAGECLASS
data-redis-0 Pending <VALUE>
NAME PROVISIONER
<VALUE> <ID><VALUE> 和 <ID> 是集群相关的动态值。此时再用 kubectl describe pvc data-redis-0 -n microservices 查看 Events,常见根因包括没有默认 StorageClass、访问模式不受支持、容量无法满足或动态制备器异常。修复存储供给后,PVC 应进入 Bound,StatefulSet 才能继续启动对应副本。
StatefulSet 提供稳定身份和存储绑定,但不会自动设计数据库复制、故障选主或数据一致性策略。本例的两个 Redis 副本彼此独立,只用于演示 Kubernetes 有状态部署机制;生产中的 Redis、MySQL、Kafka 等组件仍需结合自身高可用协议设计拓扑与恢复流程。