MySQL 变量与参数说明

本文汇总 mysql_ansible 公开入口里最常改、最容易影响结果的变量，帮助你在部署、备份、恢复与监控接入前快速定位配置入口。

1. 通用变量

文件：playbooks/common_config.yml

说明：

• 公开默认密码遵循 Dbbot_<user>@8888 / Dbbot_<linux_user>@9999 约定；默认 fcs_allow_dbbot_default_passwd: false，因此 Playbook 会在 pre_tasks 阶段拦截公开默认密码。
• fcs_mysql_use_jemalloc 当前默认值是 false，也就是默认走系统内存分配器；只有显式开启时才会处理 jemalloc。
• 当 fcs_mysql_use_jemalloc: true 时，dbbot 会优先尝试系统仓 jemalloc；只有你显式设置 fcs_mysql_allow_bundled_jemalloc_fallback: true，才允许退回仓内旧版 RPM。
• mysql_binlog_format 在通用配置里可改，但 mgr.yml 会强制要求 row。

2. 目录与安装包变量

文件：playbooks/advanced_config.yml

建议：

• 只有在自定义目录布局、离线包命名或恢复到特殊路径时，才建议改这一组变量。
• unsafe_uninstall.yml 的清理范围也依赖这里的目录变量；在当前默认布局下，它会删除实例数据目录和日志目录。

3. 主从与 MHA 变量

文件：

• playbooks/vars/var_master_slave.yml
• playbooks/vars/var_mha.yml

说明：

• master_ip、slave_ips 必须和 inventory 中的主机一致。
• manager_ip 不能与 master_ip 相同，通常放在从库节点上。
• 当前实际变量名是 slave_ips，不是 replica_ips。

4. MGR 变量

文件：playbooks/vars/var_mgr.yml

说明：

• greatsql_* 变量只在 db_type: greatsql 场景生效。
• mgr.yml 默认交付结果是单主模式。

5. InnoDB Cluster 与 Router 变量

文件：

• playbooks/vars/var_innodb_cluster.yml
• playbooks/vars/var_innodb_cluster_router.yml

InnoDB Cluster 变量：

Router 变量：

说明：

• router_ha_nodes 只有在 router_enable_ha: true 时才有意义。
• router_ports.http.port 默认是 8443，后续 mysqlrouter_exporter 也默认从这个 REST API 取数。

6. Exporter 变量

文件：

• playbooks/vars/var_exporter_install.yml
• playbooks/vars/var_router_exporter_install.yml

端口自动计算规则：

• 当 mysqld_exporter_port: auto 时，端口按 9104 + mysql_port - 3306 计算。
• mysqlrouter_exporter 默认依赖 Router REST API；如果你修改了 Router 的 http 端口或绑定地址，这里也要同步调整。

7. MySQL 8.4 clone 备份变量

文件：playbooks/vars/var_backup_script_8.4.yml

说明：

• backup_scope=selected 时，backup_preferred_host 必须显式填写。
• backup_cron 目前会在 pre_tasks 中做 5 段 cron 格式校验。

8. MySQL 8.4 PITR 恢复变量

文件：playbooks/vars/var_restore_pitr_8.4.yml

恢复前约束：

1. enable_pitr: true 时，pitr_target_time 与 pitr_target_gtid 必须二选一。
2. restore_pitr_8.4.yml 只支持 db_type: mysql 且 mysql_version: 8.4.x。

9. 5.7 备份脚本与卸载说明

backup_script.yml 和 unsafe_uninstall.yml 没有单独的 vars/*.yml 参数文件，主要依赖以下配置来源：

• 5.7 备份脚本依赖 common_config.yml 与 advanced_config.yml
• 是否自动创建备份账号由 fcs_backup_script_create_backup_user 控制
• 卸载剧本删除的目录范围，来自 advanced_config.yml 中的 datadir、tmpdir、binlog_dir、relaylog_dir、redolog_dir

补充说明：

• 当前 backup_script.yml 面向 MySQL 5.7，备份保留策略主要写在 role 模板里，而不是公开变量文件里。
• 当前 unsafe_uninstall.yml 会保留软件基目录、Linux 用户和 my.cnf，但删除范围仍由 advanced_config.yml 决定；在当前默认布局下，它会删除实例数据目录和日志目录。执行前仍要求人工确认。

10. 推荐阅读顺序

1. MySQL 主从部署快速开始
2. MySQL 自定义目录布局
3. MySQL 8.4 备份与恢复
4. MySQL InnoDB Cluster 部署说明
5. MySQL MHA 部署说明