StatefulSet是唯一能正确部署MySQL 8.0主从集群的控制器,因其提供固定DNS(如mysql-0.mysql.default.svc.cluster.local)、专属PVC绑定和严格启停顺序,而Deployment的随机Pod名、共享存储与无序扩缩容必然导致PVC错绑、GTID复制中断及主从连接失败。

StatefulSet 是唯一能正确部署 MySQL 8.0 主从集群的控制器 —— 用 Deployment 必然导致 PVC 错绑、GTID 复制中断、主从连接失败,且问题常静默发生,日志里只显示 Can't start server: Bind on unix socket 或 error connecting to master。
为什么必须用 StatefulSet 而不是 Deployment
MySQL 实例依赖三个不可替代的稳定属性:mysql-0.mysql.default.svc.cluster.local 这类固定 DNS 名、专属 PVC 绑定、严格启停顺序。这些 Deployment 全都不提供:
-
Deployment的 Pod 名是随机哈希(如mysql-7d8f9b4c6-xyz12),重建后 DNS 记录失效,CHANGE REPLICATION SOURCE TO SOURCE_HOST='mysql-0'直接解析失败 - 所有副本共享同一组 label,Service 无法区分主从角色,也无法做基于序号的配置分发
- 无序启停:
mysql-1可能在mysql-0尚未就绪时就尝试连接,START SLAVE报错ERROR 2003 (HY000) - 不支持
volumeClaimTemplates,无法为每个 Pod 自动生成带序号的 PVC(如data-mysql-0)
serviceName 和 Headless Service 必须严格配对
volumeClaimTemplates 能否生效、Pod 是否能获得稳定 DNS,全看 StatefulSet.spec.serviceName 是否与一个 clusterIP: None 的 Headless Service 的 metadata.name 完全一致。漏写、拼错或大小写不匹配,后果立现:
- PVC 卡在
Pending,事件报错:No persistent volumes available for this claim - Pod 启动后挂载失败,
/var/lib/mysql为空,MySQL 进程退出,日志反复出现Can't start server: Bind on unix socket - 从库执行
SHOW REPLICA STATUS\G显示IO_Running: No,错误为error connecting to master
正确写法示例(关键字段对齐):
apiVersion: v1
kind: Service
metadata:
name: mysql # ← 必须和 StatefulSet 的 serviceName 完全一致
spec:
clusterIP: None
selector:
app: mysql
apiVersion: apps/v1
kind: StatefulSet
metadata:
name: mysql
spec:
serviceName: mysql # ← 必须和上面 Service 的 name 完全一致
volumeClaimTemplates:
- metadata:
name: data # 生成 PVC 名:data-mysql-0、data-mysql-1
spec:
accessModes: ["ReadWriteOnce"]
resources:
requests:
storage: 10Gi
storageClassName: mysql-sc
server-id 和 auto_increment 必须动态注入,不能硬编码
主从节点若共用相同 server-id(比如都写死为 1),会导致 GTID 冲突、双主写入、START SLAVE 报 ERROR 3021 (HY000),甚至数据静默覆盖。靠启动后 SQL 设置(如 SET GLOBAL server_id = 1)也不行 —— Pod 重建后清空。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 用
hostname解析序号:hostname | sed 's/mysql-//' | sed 's/\..*$//'得到0或1 -
auto_increment_offset和auto_increment_increment必须写在[mysqld]段内:主库设为1,2,从库设为2,2 - ConfigMap 静态挂载
my.cnf不够用;必须用initContainer在主容器启动前生成带正确参数的临时配置文件,再复制到/etc/mysql/conf.d/
示例 initContainer 片段(busybox):
initContainers:
- name: config-init
image: busybox:1.35
command: ['sh', '-c']
args:
- hostname | grep -oE '[0-9]+' > /tmp/ordinal && \
if [ "$(cat /tmp/ordinal)" = "0" ]; then \
cp /config/master.cnf /mnt/config/my.cnf; \
else \
cp /config/slave.cnf /mnt/config/my.cnf; \
fi
volumeMounts:
- name: config
mountPath: /config
- name: generated-config
mountPath: /mnt/config
readinessProbe 必须校验复制状态,不能只 ping
livenessProbe 用 mysqladmin ping -h localhost 足够,但 readinessProbe 若只检查 MySQL 进程是否存活,会过早将从库标记为就绪,导致上层服务读到未同步数据。
- 主库 readinessProbe 可简化为连通性检查
- 从库 readinessProbe 必须等待两个条件同时满足:
Slave_IO_Running: Yes且Slave_SQL_Running: Yes - 命令示例:
mysql -u root -p$MYSQL_ROOT_PASSWORD -e "SHOW REPLICA STATUS\G" | grep -q "Slave_IO_Running: Yes" && mysql -u root -p$MYSQL_ROOT_PASSWORD -e "SHOW REPLICA STATUS\G" | grep -q "Slave_SQL_Running: Yes"
最容易被忽略的是:这个检查必须在 MySQL 已启动、且复制线程已成功启动之后才开始 —— 所以 initialDelaySeconds 建议设为 60 秒以上,避免 probe 频繁失败触发重启循环。










