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。
• fcs_run_post_deploy_checks 默认开启；若需临时跳过部署后验收，可显式传入 -e fcs_run_post_deploy_checks=false。
• 当前自动验收已覆盖 single_node.yml、master_slave.yml、mgr.yml、innodb_cluster.yml、innodb_cluster_router.yml、mha_go.yml、mha.yml、exporter 安装入口和 unsafe_uninstall.yml；备份与恢复入口暂不在这组自动验收范围内。
• 主从 post-deploy 验收默认要求复制延迟为 0 秒；dbbot_post_check_replication_max_lag_seconds 仅用于临时放宽验收阈值。
• MySQL Server 安装包元数据会在探测目标 OS 后由 dbbotctl support 解析。可用 dbbotctl support packages 查询指定版本 / OS 对应的包名、下载地址和 checksum。
• MySQL 9.7.x 不支持 CentOS/RHEL 7 系列；这类系统请使用 MySQL 8.4.x。

2. 目录与安装包变量

文件：playbooks/advanced_config.yml

建议：

• 只有在自定义目录布局或恢复到特殊路径时，才建议修改目录变量。安装包元数据通常应来自 dbbotctl support；离线部署时，请把文件名与 support 矩阵一致的安装包放到 mysql_packages_dir。
• 临时测试未纳入 support 矩阵的 MySQL Server 包时，显式设置 fcs_allow_custom_mysql_package: true 并在 advanced_config.yml 中填写 mysql_custom_package。该能力适用于所有包含 MySQL Server 部署的入口，不只限于单机部署；它只覆盖 Server 主包名，mysql_version、目标 OS、拓扑支持判断以及 MySQL Shell / Router 包名仍来自 support 矩阵。
• unsafe_uninstall.yml 的清理范围也依赖这里的目录变量；在当前默认布局下，它会删除实例数据目录和日志目录，但保留实例 my.cnf。

3. 主从、传统 MHA 与 MHA-Go 变量

文件：

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

说明：

• master_ip、slave_ips 必须和 inventory 中的主机一致。
• 传统 Perl MHA 的 manager_ip 仍建议放在从库节点上，且不能与 master_ip 相同。
• MHA-Go 的 manager_ip 可以是 master_ip 或 slave_ips 中任一节点，当前默认是 master_ip。
• 当前实际变量名是 slave_ips，不是 replica_ips。
• net_work_interface 的默认值只是示例网卡名。启用传统 MHA VIP 或 MHA-Go VIP 写入口前，请先用 ip route 或 ip addr 确认真实网卡；dbbot 192.168.161.* 默认测试 inventory 中的样例环境通常是 enp1s0，但具体网卡随测试 profile 变化。

4. MGR 变量

文件：playbooks/vars/var_mgr.yml

说明：

• greatsql_* 变量只在 db_type: greatsql 场景生效。
• greatsql_net_work_interface 需要按真实网卡名覆盖；dbbot 192.168.161.* 默认测试 inventory 中的样例环境通常是 enp1s0，但具体网卡随测试 profile 变化。
• 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_net_work_interface 需要按 Router 节点真实网卡名覆盖；dbbot 192.168.161.* 默认测试 inventory 中的样例环境通常是 enp1s0，但具体网卡随测试 profile 变化。
• router_linux_glibc_tag: auto 下，Router 9.7.x 使用 glibc2.28，Router 8.4.x 使用 glibc2.17；如需固定包名，可显式指定 glibc 标签。
• router_ports.http.port 默认是 8443，后续 mysqlrouter_exporter 也默认从这个 REST API 取数。

6. Exporter 变量

文件：

• playbooks/vars/var_node_exporter_install.yml
• playbooks/vars/var_mysqld_exporter_install.yml
• playbooks/vars/var_router_exporter_install.yml

端口自动计算规则：

• 当 mysqld_exporter_port: auto 时，端口按 9104 + mysql_port - 3306 计算。
• 当 mysqld_exporter_topology: auto 时，dbbot 会自动检查 performance_schema.replication_group_members，有成员就按 mgr 处理，否则按 ms 处理。
• mysqlrouter_exporter 默认依赖 Router REST API；如果你修改了 Router 的 http 端口或绑定地址，这里也要同步调整。
• mysqlrouter_exporter_install_type: dbbot 使用发行包内置二进制；package 则按 mysqlrouter_exporter_url 下载独立项目 release 包。

6.1 依赖链速记

Router 链路：

• innodb_cluster.yml
• innodb_cluster_router.yml
• router_exporter_install.yml
• dbbotctl exporter register -t router
• router_unsafe_uninstall.yml（需要清理 Router 时）

MHA 链路：

• mha.yml
• mha_unsafe_uninstall.yml（需要同时清理传统 MHA 和 MySQL 实例时）
• mha_go.yml
• mha_go_unsafe_uninstall.yml（需要同时清理 MHA-Go 和 MySQL 实例时）

MySQL exporter 链路：

• single_node.yml / master_slave.yml / mgr.yml
• node_exporter_install.yml
• mysqld_exporter_install.yml
• dbbotctl exporter register -t node
• dbbotctl exporter register -t mysql

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
• 卸载目标实例本身，由 common_config.yml 当前生效的 mysql_port 决定

补充说明：

• 当前 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 部署说明