Ansible自动化部署数据库集群需按角色分组（mysql_masters/mysql_slaves）、动态生成唯一server-id、Jinja2模板差异化配置my.cnf、严格管控初始化权限与用户、幂等化主从配置。
用 Ansible 自动化部署数据库集群，关键不在“装上”，而在让每台节点按角色精准就位、配置不偏不倚、初始化稳如磐石。手动部署常因 server-id 重复、read_only 漏设、my.cnf 权限错误或复制账号未创建，导致 Seconds_Behind_Master: NULL 或 ERROR 2003 连不上——这些问题必须在自动化中前置拦截。
严格按角色分组定义 inventory
Ansible 不识别逻辑主从，只认 inventory 中的组名。不能用单个 [dbservers] 统管所有节点再靠 when 判断，否则扩容改主机名就得同步改几十处条件语句。
- 硬性拆分为 [mysql_masters]（仅 1 台，写入 + 生成 binlog）、[mysql_slaves]（多台，只读 + 拉取 relay log），MGR 场景可加 [mysql_arbiters]
- server-id 必须全局唯一：master 固定为 100，slave 用 201、202 等递增数值，避免硬编码进 vars，应通过 group_names 或 hostvars 动态计算
- 所有后续任务、模板、handlers 都基于 group_names 判断，例如 {% if 'mysql_masters' in group_names %}，逻辑清晰且可扩展
用 Jinja2 模板动态生成差异化配置
my.cnf 不是复制粘贴，是角色驱动的声明式输出。主库和从库的关键参数必须由模板自动开关，不能靠人工修改或启动后 set。
- 主库必须包含：log-bin = /data/mysql/binlog/mysql-bin、binlog-format = ROW、skip-slave-start = 1
- 从库必须包含：read_only = ON、relay-log = /data/mysql/relaylog/relay-bin、skip-slave-start = 0
- /etc/my.cnf 目标文件权限必须设为 0644，否则 mysqld 启动直接拒绝读取，日志仅报 “Failed to open config file”
初始化阶段严控用户、路径与权限
MySQL 8.0 起弃用 mysql_install_db，改用 mysqld --initialize-insecure，但该命令对属主和目录权限极其敏感。
- 执行前确保 /data/mysql 目录属主为 mysql 用户，且 mysql 用户对数据目录有完全读写权限
- 初始化命令需以 mysql 用户身份运行，不能用 root 直接执行再 chown，否则可能触发安全校验失败
- 初始化后首次启动前，必须确认 socket 文件路径、pid-file 路径在 my.cnf 中正确声明，且对应目录存在并可写
主从关系建立必须代码化、幂等化
CHANGE MASTER TO 不是手动敲一次就完事，它要嵌入 Playbook，且具备幂等判断——避免重复执行报错 “The slave I/O thread is running”。
- 用 register 捕获 SHOW SLAVE STATUS 输出，判断 Slave_IO_Running 和 Slave_SQL_Running 是否均为 Yes
- 结合 when 条件跳过已同步状态的任务，确保多次运行 Playbook 不引发冲突
- 复制账号（如 repl_user）需在主库提前创建，并显式授权 REPLICATION SLAVE，密码统一由 vars 加密管理
