StatefulSet是唯一可行选择,因其提供固定Pod名、独立PVC、有序启停和稳定DNS;Deployment的随机命名、共享存储、无序扩缩容必然导致PVC错绑、数据错乱、GTID复制中断。

必须用 StatefulSet,不能用 Deployment;否则 Pod 重建后 PVC 可能错绑、数据错乱、GTID 复制中断——这不是配置问题,是设计层面的硬约束。
为什么 StatefulSet 是唯一可行选择
MySQL 要求每个实例有固定身份、独立存储、有序启停。Deployment 的 Pod 名随机、PVC 共享或复用、启动无序,直接导致:
-
mysql-0重启后可能挂载mysql-1的 PVC,数据目录混用,mysqld启动失败或静默损坏 - 主从节点无法靠 DNS 名(如
mysql-0.mysql.default.svc.cluster.local)稳定寻址,CHANGE REPLICATION SOURCE配置失效 - 滚动更新时从库可能先于主库启动,复制链路初始化失败
StatefulSet 的 serviceName 字段必须指向一个 Headless Service(clusterIP: None),这是 Pod 间通过 DNS 发现彼此的前提,漏配就无法做主从通信。
StorageClass 和 PVC 模板必须严格隔离
每个 MySQL 实例必须绑定**独占、不可复用**的存储卷。动态供给场景下,volumeClaimTemplates 是唯一安全方式:
- 不要手写多个独立 PVC 清单——无法随
replicas自动扩缩,且易命名冲突 -
storageClassName必须存在且支持ReadWriteOnce(如nfs-client、ceph-rbd),local类型仅限单节点测试,生产禁用 - 模板中
resources.requests.storage建议 ≥20Gi:MySQL 8.0 的 ibdata1、redo log、binlog 默认增长较快,10Gi 容易触发disk full致使主从同步卡死
示例关键片段:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
volumeClaimTemplates:
- metadata:
name: data
spec:
accessModes: ["ReadWriteOnce"]
storageClassName: "nfs-client"
resources:
requests:
storage: 20Gi
ConfigMap 分发配置时必须区分主从角色
MySQL 8.0 主从必须靠 server-id + gtid-mode=ON + enforce-gtid-consistency=1 保障一致性。ConfigMap 里不能只放一个 my.cnf:
- 主库需启用
log-bin、binlog-format=ROW,从库必须设read-only=1和super-read-only - 通过
initContainers或启动脚本判断当前 Pod 序号(hostname为mysql-0还是mysql-1),再挂载对应配置片段(如master.cnf/slave.cnf) - 避免在容器内硬编码
server-id=1—— 若扩容到 3 副本,mysql-2会因 ID 冲突拒绝启动
错误示范:env 中传 SERVER_ID 然后用 sed 替换配置文件——MySQL 8.0 不支持运行时修改 server-id,必须在 mysqld 启动前写死。
Liveness/Readiness 探针不能只依赖 mysqladmin ping
livenessProbe.exec 用 mysqladmin ping 只能判断进程存活,无法发现复制中断、磁盘只读、GTID gap 等“假活”状态:
- 主库 readiness 应检查
SELECT @@global.gtid_executed是否可执行 - 从库 readiness 必须查
SELECT SERVICE_STATE FROM performance_schema.replication_applier_status_by_coordinator和RECEIVED_TRANSACTION_SET = EXECUTED_TRANSACTION_SET - 所有探针的
initialDelaySeconds要 ≥45s:MySQL 8.0 初始化 InnoDB 缓冲池、恢复崩溃日志耗时远超旧版,过早探测会反复 kill restart
最简可用组合:
livenessProbe:
exec:
command: ["sh", "-c", "mysql -uroot -p$$(cat /tmp/password) -e 'SELECT 1' && mysqladmin ping -uroot -p$$(cat /tmp/password)"]
initialDelaySeconds: 45
periodSeconds: 15
真正麻烦的从来不是写完 YAML,而是当 mysql-1 的 PVC 被误删后,K8s 不会自动重建同名 PV,你得手动清理残留的 pv.status.phase 和底层存储中的孤儿文件——这一步没文档,只能翻 kubectl get pv -o yaml 逐字段比对。

















