容器与云原生 / 系统课时

部署有状态基础组件

部署有状态基础组件

本课用 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 名称。

StatefulSet、Headless Service 与 PVC 的绑定关系

Headless Service 的 clusterIP: None 不提供统一虚拟 IP,而是让 DNS 直接返回后端 Pod 地址。它特别适合需要成员发现、主从拓扑或固定节点名称的中间件。

编写 Headless Service 与 StatefulSet

下面示例启用 Redis AOF 持久化。将内容保存为 redis-stateful.yaml。示例依赖集群存在默认 StorageClass;如果没有默认 StorageClass,需要在 PVC 模板中显式填写可用的 storageClassName。

yaml
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: 1Gi

spec.serviceName 指向负责该 StatefulSet 网络身份的 Headless Service。每个副本会生成独立 PVC,默认命名规则是 <claim-name>-<statefulset-name>-<ordinal>,因此这里会得到 data-redis-0 和 data-redis-1。

创建资源并验证稳定身份

应用清单即可独立创建本课所需 Namespace、Headless Service 和 StatefulSet:

bash
kubectl apply -f redis-stateful.yaml

预期输出(首次创建):

text
namespace/microservices created
service/redis created
statefulset.apps/redis created

若 Namespace 已存在,它可能显示 unchanged,不会影响后续资源创建。

等待两个副本就绪后检查 StatefulSet:

bash
kubectl get statefulset redis -n microservices \
  -o jsonpath='{.status.readyReplicas}/{.spec.replicas}{"\n"}'

预期输出:

text
2/2

检查固定 Pod 名称和 PVC 绑定:

bash
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

预期输出:

text
pod/redis-0
pod/redis-1
data-redis-0   Bound
data-redis-1   Bound

再从 redis-0 通过稳定 DNS 访问 redis-1:

bash
kubectl exec -n microservices redis-0 -- \
  redis-cli -h redis-1.redis.microservices.svc.cluster.local PING

预期输出:

text
PONG

这同时验证了 Headless Service 的成员发现路径和目标 Pod 的 Redis 端口可达。

验证数据不会随 Pod 重建丢失

先向 redis-0 写入一个键:

bash
kubectl exec -n microservices redis-0 -- redis-cli SET course statefulset

预期输出:

text
OK

删除这个 Pod,让 StatefulSet 自动重建同名副本并等待它重新 Ready:

bash
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

预期输出:

text
pod "redis-0" deleted
pod/redis-0 condition met

重新读取数据:

bash
kubectl exec -n microservices redis-0 -- redis-cli GET course

预期输出:

text
statefulset

能够读回原值,说明新建容器重新挂载了 data-redis-0 对应的持久卷,而不是依赖原 Pod 的临时文件系统。

PVC Pending 时沿存储依赖排查

如果 StatefulSet 一直无法就绪,先检查 PVC 状态和 StorageClass:

bash
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 尚未制备,预期结果类似:

text
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 等组件仍需结合自身高可用协议设计拓扑与恢复流程。

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

目录与阅读设置

阅读设置

17

记录一个想法

部署有状态基础组件

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

登录哪都通