Kubernetes 存储与 StatefulSet 实战:从 PV/PVC 到生产级 MySQL 主从集群 原创

温馨提示:
本文最后更新于 2026-11-18,已超过 0 天没有更新。 若文章内的图片失效(无法正常加载),请留言反馈或直接 联系我。

Kubernetes 网络方案选型后,存储是下一个必须攻克的难关。无状态应用可以随时重建,但数据库、消息队列等有状态服务需要持久化存储和稳定的网络标识。本文从 PV/PVC 绑定机制讲起,深入 StatefulSet 的扩缩容语义,最后给出一个生产可用的 MySQL 主从集群部署示例。

一、PV 与 PVC:解耦存储供给与消费

PersistentVolume(PV)是集群级别的存储资源,PersistentVolumeClaim(PVC)是用户对存储的请求。这种解耦让运维人员可以提前规划存储池,而开发者只需声明所需容量和访问模式。

# 创建一个 NFS 类型的 PV
apiVersion: v1
kind: PersistentVolume
metadata:
  name: nfs-pv-01
spec:
  capacity:
    storage: 10Gi
  accessModes:
    - ReadWriteMany
  persistentVolumeReclaimPolicy: Retain
  nfs:
    server: 192.168.1.100
    path: "/exports/data"
---
# PVC 请求存储
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: app-data-pvc
spec:
  accessModes:
    - ReadWriteMany
  resources:
    requests:
      storage: 5Gi

关键字段说明:

  • accessModes:ReadWriteOnce(单节点读写)、ReadOnlyMany(多节点只读)、ReadWriteMany(多节点读写)
  • persistentVolumeReclaimPolicy:Retain(保留数据)、Delete(自动删除)、Recycle(已废弃)
  • storageClassName:指定动态供给的存储类,留空则使用默认 StorageClass

二、StorageClass 与动态供给

静态 PV 需要预先创建,动态供给通过 StorageClass 自动创建 PV。以 AWS EBS 为例:

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: fast-ssd
provisioner: ebs.csi.aws.com
parameters:
  type: gp3
  iops: "3000"
  throughput: "125"
volumeBindingMode: WaitForFirstConsumer
allowVolumeExpansion: true

volumeBindingMode: WaitForFirstConsumer 是关键优化:延迟绑定直到 Pod 被调度到具体节点,避免跨可用区挂载失败。

三、StatefulSet:有状态应用的核心控制器

Deployment 适合无状态应用,StatefulSet 则为有状态应用提供三大保证:

特性 Deployment StatefulSet
Pod 名称 随机哈希 固定序号(web-0, web-1)
网络标识 随机 稳定的 DNS 记录
存储 共享或临时 每个 Pod 独立 PVC
扩缩容顺序 无序 有序(0→N,N→0)

四、实战:MySQL 主从集群 StatefulSet 部署

以下示例展示一个 1 主 2 从的 MySQL 集群,使用 StatefulSet + Headless Service + ConfigMap 初始化脚本。

# Headless Service:为每个 Pod 提供稳定 DNS
apiVersion: v1
kind: Service
metadata:
  name: mysql-headless
spec:
  clusterIP: None
  selector:
    app: mysql
  ports:
    - port: 3306
---
# ConfigMap:主从配置差异
apiVersion: v1
kind: ConfigMap
metadata:
  name: mysql-config
data:
  my.cnf: |
    [mysqld]
    server-id=1
    log-bin=mysql-bin
    binlog_format=ROW
    gtid_mode=ON
    enforce_gtid_consistency=ON
    relay-log=relay-bin
    read-only=0
---
# StatefulSet:MySQL 主从
apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: mysql
spec:
  serviceName: mysql-headless
  replicas: 3
  selector:
    matchLabels:
      app: mysql
  template:
    metadata:
      labels:
        app: mysql
    spec:
      initContainers:
        - name: init-mysql
          image: busybox:1.36
          command:
            - sh
            - -c
            - |
              # 根据 Pod 序号设置 server-id
              idx=$(hostname | sed 's/.*-//')
              cat /etc/mysql/my.cnf > /mnt/my.cnf
              echo "server-id=$((idx+1))" >> /mnt/my.cnf
              if [ "$idx" -gt 0 ]; then
                echo "read-only=1" >> /mnt/my.cnf
                echo "relay-log=relay-bin" >> /mnt/my.cnf
              fi
          volumeMounts:
            - name: config
              mountPath: /etc/mysql
            - name: config-volume
              mountPath: /mnt
      containers:
        - name: mysql
          image: mysql:8.0
          env:
            - name: MYSQL_ROOT_PASSWORD
              valueFrom:
                secretKeyRef:
                  name: mysql-secret
                  key: root-password
          ports:
            - containerPort: 3306
          volumeMounts:
            - name: data
              mountPath: /var/lib/mysql
            - name: config-volume
              mountPath: /etc/mysql/conf.d
          livenessProbe:
            exec:
              command: ["mysqladmin", "ping", "-uroot", "-p${MYSQL_ROOT_PASSWORD}"]
            initialDelaySeconds: 30
            periodSeconds: 10
          readinessProbe:
            exec:
              command: ["mysql", "-uroot", "-p${MYSQL_ROOT_PASSWORD}", "-e", "SELECT 1"]
            initialDelaySeconds: 5
            periodSeconds: 5
  volumeClaimTemplates:
    - metadata:
        name: data
      spec:
        accessModes: ["ReadWriteOnce"]
        storageClassName: fast-ssd
        resources:
          requests:
            storage: 20Gi

关键设计点:

  • volumeClaimTemplates:每个 Pod 自动创建独立 PVC,Pod 重建后数据不丢失
  • initContainers:根据 Pod 序号动态生成配置,0 号为主库,其余为只读从库
  • Headless Service:提供 mysql-0.mysql-headless.default.svc.cluster.local 形式的稳定 DNS

五、扩缩容与故障恢复

StatefulSet 的扩缩容是有序且优雅的:

# 扩容:按序号增加(mysql-3, mysql-4)
kubectl scale statefulset mysql --replicas=5

# 缩容:逆序删除(mysql-4 先删,mysql-3 后删)
kubectl scale statefulset mysql --replicas=3

# 滚动更新:逆序更新(从最大序号到 0)
kubectl rollout restart statefulset mysql

故障场景处理:

  • Pod 崩溃:StatefulSet 自动重建同名 Pod,重新挂载原 PVC,数据恢复
  • 节点故障:需手动删除 Pod 或等待节点恢复,Kubernetes 不会自动强制迁移
  • PVC 损坏:从备份恢复或删除 PVC 让 StatefulSet 重新创建

六、生产环境检查清单

检查项 命令/方法 预期结果
PVC 绑定状态 kubectl get pvc Bound
Pod 启动顺序 kubectl get pods -l app=mysql -w 0→1→2 有序启动
DNS 解析 nslookup mysql-0.mysql-headless 返回 Pod IP
存储扩容 kubectl edit pvc data-mysql-0 允许扩容(需 StorageClass 支持)
备份验证 定期快照 + 恢复测试 数据可完整恢复

Kubernetes 存储的核心在于理解「声明式」思维:你描述想要什么(容量、访问模式、持久性),而不是如何创建。StatefulSet 在此基础上为分布式有状态应用提供了确定性,是数据库、消息队列、分布式协调服务上 K8s 的必备工具。