mysql
mysql
用于快速部署 mysql 集群
支持以下几种集群模式:
- 基于 GTID 的主从复制
- 默认开启 Semi-Sync 增强半同步
- 基于 MHA 架构的主从复制
- MGR 单主模式(默认)
- MGR 多主模式
- ReplicaSet 复制集
支持的 MySQL 发行版本:
- Oracle 官方 MySQL Community Server
- 万里开源 GreatSQL
- Percona Percona Server for MySQL
环境要求
- Centos 7+
- Ansible 2.9+
- MySQL 8.0+
变量
| 变量名 | 类型 | 默认值 | 变量说明 |
|---|---|---|---|
| mysql_version | string | 8.0.23 | mysql 版本 |
| mysql_upgrade | bool | false | 是否需要执行版本升级操作 |
| mysql_download_url | string | 免安装压缩包下载地址 | |
| mysql_inventory_group | string | mysql | Ansible 主机清单中的组名， 默认为 mysql |
| mysql_basedir | string | /usr/local/mysql | 安装目录 |
| mysql_datadir | string | /data/mysql | 数据文件存放目录 |
| mysql_logdir | string | /var/log/mysqld | 日志存放目录 |
| mysql_pidfile | string | /var/run/mysqld/mysqld.pid | PID 文件位置 |
| mysql_socket | string | /var/run/mysqld/mysqld.sock | Socket 文件位置 |
| mysql_port | int | 3306 | 监听端口 |
| mysql_bind_address | string | 0.0.0.0 | 监听地址 |
| mysql_interface | string | "" | 指定网卡，默认使用除 lo 外的第一张网卡 |
| mysql_default_time_zone | string | +8:00 | 指定时区 |
| mysql_character_set_server | string | utf8mb4 | 默认字符集 |
| mysql_collation_server | string | utf8mb4_general_ci | 默认字符序 |
| mysql_max_connections | int | 1005 | 最大连接数 |
| mysql_max_user_connections | int | 1000 | 用户最大连接数，必须比 mysql_max_connections 小，需要给管理员预留几个连接用于处理异常情况 |
| mysql_interactive_timeout | int | 28800 | 服务器关闭交互式连接前等待活动的秒数 |
| mysql_wait_timeout | int | 28800 | 服务器关闭非交互连接之前等待活动的秒数 |
| mysql_max_connect_errors | int | 200 | 最大错误连接数 |
| mysql_root_password | string | "" | root 账号的密码 |
| mysql_cluster_type | string | mgr | 集群类型(默认 mgr) 可选 mgr(Mysql Group Replication)/ms(Master-Slave) |
| mysql_cluster_name | string | default | 集群的名称， 适用于 InnodbCluster/ReplicaSet |
| mysql_mha_enabled | bool | false | 是否开启基于 mha 主从高可用 |
| mysql_mha_config_dir | string | /etc/mha | MHA 配置文件目录 |
| mysql_mha_manager_workdir | string | /var/log/mha | MHA 工作目录，存放日志及状态信息 |
| mysql_mha_user | string | mha | 用于连接管理 mysql 的用户，需要有 ALL 权限 |
| mysql_mha_password | string | "" | mysql 管理密码 |
| mysql_mha_repl_user | string | repl | 用于 mysql 主从复制的账号 |
| mysql_mha_repl_password | string | "" | 用于 mysql 主从复制的密码 |
| mysql_mha_ssh_user | string | root | 节点间通信的 ssh 账号 |
| mysql_mha_ssh_port | int | 22 | 节点间通信的 ssh 端口 |
| mysql_mha_ping_interval | int | 2 | master 节点状态心跳间隔 |
| mysql_mha_vip | string | "" | 用于绑定到 master 节点的 VIP |
| mysql_mha_wechat_token | string | "" | 企业微信机器人的 Key, 用于发送报警通知 |
| mysql_mha_proxy | string | "" | 用于发送报警通知(send_report)脚本使用的代理 |
| mysql_repl_user | string | repl | 用于主从/组复制的账号 |
| mysql_repl_password | string | 用于主从/组复制的账号的密码 | |
| mysql_group_replication_name | uuid | "" | 组复制集群名,在 mysql 中使用SELECT UUID()或 shell 中使用uuidgen生成 |
| mysql_group_replication_single_primary_mode | bool | true | MGR 集群是否为单主模式 |
| mysql_innodb_cluster_enable | bool | true | 是否开启 Innodb Cluster |
| mysql_innodb_cluster_username | string | ic | 用于创建和管理 Innodb Cluster 的账号，需要具备 ALL WITH GRANT OPTION 权限 |
| mysql_innodb_cluster_password | string | "" | 管理密码 |
| mysql_proxysql_config | bool | false | 是否使用 proysql 做为代理层 |
| mysql_proxysql_monitor_username | string | monitor | proxysql 监控 mgr 状态的账号 |
| mysql_proxysql_monitor_password | string | "" | proxysql 监控 mgr 状态的密码 |
| mysql_databases | array | [] | 需要创建的业务数据库 |
| mysql_users | array | [] | 需要创建的用户 |
依赖
collections:
示例
安装
ansible-galaxy collection install -r requirements.yml
使用
- hosts: servers
roles:
- { role: mysql, mysql_version: 8.0.20 }
已知问题
- mysql_user 模块对于 mysql8.0 以上的版本，给用户授权
ALL权限的时候会出现幂等性问题 Idempotence all grant
待办
- 主从模式下支持半同步复制
- 完善 MHA 下 side-effect 测试
- 支持版本更新
- 支持节点重建
- MGR 集群中极端情况下所有节点都宕机后，需要找到 gtid 最大的实例为做 primary 节点重新引导集群
集群异常修复
MGR 集群异步宕机后恢复
取并集，select RECEIVED_TRANSACTION_SET from performance_schema.replication_connection_status + show variables like 'gtid_executed ，然后选主最大的，作为 primary