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 的必备工具。