1. 项目概述MySQL Group ReplicationMGR是MySQL官方提供的高可用解决方案它基于Paxos协议实现多主复制能够自动处理节点加入/退出、故障检测与恢复等场景。在Ubuntu 24上配置单节点MGR看起来似乎违背了Group的初衷但实际在开发测试环境中非常实用——你可以先验证基础配置的正确性后续再扩展为完整集群。我最近在本地开发环境中就遇到了这样的需求需要测试一个依赖MGR特性的应用但资源有限只能先用单节点验证核心逻辑。通过本文你将掌握从零开始配置单节点MGR的完整流程包括那些官方文档没明确说明的细节参数。2. 环境准备2.1 系统与软件要求推荐使用Ubuntu 24.04 LTS Server版避免图形界面占用资源。MySQL版本选择8.0.34本文以8.0.36为例这是目前最稳定的支持MGR的版本。硬件配置建议至少2核CPU4GB内存50GB存储空间实际需求取决于数据量注意虽然MGR可以在单核机器运行但性能会受严重影响特别是在启用流控的情况下。2.2 MySQL安装使用官方APT仓库安装MySQL# 添加MySQL官方仓库 wget https://dev.mysql.com/get/mysql-apt-config_0.8.29-1_all.deb sudo dpkg -i mysql-apt-config_0.8.29-1_all.deb # 更新并安装 sudo apt update sudo apt install mysql-server mysql-shell -y安装完成后检查服务状态systemctl status mysql3. MGR核心配置3.1 基础参数设置编辑MySQL配置文件通常位于/etc/mysql/mysql.conf.d/mysqld.cnf在[mysqld]段添加# 基础组复制配置 server_id 1 gtid_mode ON enforce_gtid_consistency ON binlog_checksum NONE # 组复制专用配置 transaction_write_set_extraction XXHASH64 group_replication_start_on_boot OFF group_replication_bootstrap_group OFF group_replication_recovery_get_public_key ON group_replication_consistency EVENTUAL # 单节点特殊配置 group_replication_single_primary_mode ON group_replication_enforce_update_everywhere_checks OFF关键参数说明server_id在单节点场景下也必须设置唯一IDgroup_replication_start_on_boot设为OFF防止自动启动导致问题group_replication_consistency设为EVENTUAL获得最佳性能3.2 用户权限配置登录MySQL创建复制专用账户CREATE USER repl% IDENTIFIED BY SecurePass123!; GRANT REPLICATION SLAVE ON *.* TO repl%; GRANT CONNECTION_ADMIN ON *.* TO repl%; FLUSH PRIVILEGES;安全提示实际环境中应使用更复杂的密码并限制访问IP4. 初始化MGR环境4.1 数据目录准备停止MySQL服务后初始化数据目录sudo systemctl stop mysql sudo mv /var/lib/mysql /var/lib/mysql.bak sudo mkdir /var/lib/mysql sudo chown mysql:mysql /var/lib/mysql4.2 初始化数据使用mysqld初始化空数据库sudo mysqld --initialize-insecure --usermysql启动MySQL服务sudo systemctl start mysql4.3 安装组复制插件登录MySQL执行INSTALL PLUGIN group_replication SONAME group_replication.so;验证插件状态SHOW PLUGINS WHERE NAME group_replication;5. 启动单节点MGR5.1 引导组复制在MySQL中执行以下命令序列-- 设置组复制通道 SET GLOBAL group_replication_bootstrap_groupON; START GROUP_REPLICATION; SET GLOBAL group_replication_bootstrap_groupOFF; -- 验证状态 SELECT * FROM performance_schema.replication_group_members;正常情况应该看到类似输出------------------------------------------------------------------------------ | CHANNEL_NAME | MEMBER_ID | MEMBER_HOST | MEMBER_PORT | MEMBER_STATE | ------------------------------------------------------------------------------ | group_replication_applier | ... | your-host | 3306 | ONLINE | ------------------------------------------------------------------------------5.2 创建测试数据验证MGR功能是否正常CREATE DATABASE mgr_test; USE mgr_test; CREATE TABLE test_table (id INT PRIMARY KEY, data VARCHAR(100)); INSERT INTO test_table VALUES (1, MGR单节点测试);6. 运维与监控6.1 常用监控命令查看组状态SELECT * FROM performance_schema.replication_group_members;检查冲突SELECT * FROM performance_schema.replication_group_member_stats;查看应用队列SELECT * FROM performance_schema.replication_applier_status;6.2 性能调优建议对于单节点MGR建议调整以下参数# 优化组通信线程 group_replication_poll_spin_loops 100 group_replication_compression_threshold 131072 # 减少流控影响 group_replication_flow_control_mode DISABLED7. 常见问题解决7.1 启动时报错处理错误示例[ERROR] Plugin group_replication reported: This server is not configured properly to be an active member of the group.解决方案确认所有必选参数已正确设置检查show variables like group_replication%输出确保没有启用只读模式read_onlyOFF7.2 节点无法加入自己这是单节点部署时的特殊问题解决方法-- 先停止组复制 STOP GROUP_REPLICATION; -- 重置元数据 RESET MASTER; -- 重新引导 SET GLOBAL group_replication_bootstrap_groupON; START GROUP_REPLICATION; SET GLOBAL group_replication_bootstrap_groupOFF;8. 扩展为多节点集群虽然本文聚焦单节点配置但了解如何扩展很有必要。要添加第二个节点在新节点上重复安装步骤修改server_id为不同值配置指向第一个节点的group_replication_group_seeds直接执行START GROUP_REPLICATION无需引导添加节点的典型命令-- 在新节点上执行 SET GLOBAL group_replication_group_seedsfirst_node_ip:33061; START GROUP_REPLICATION USERrepl, PASSWORDSecurePass123!;我在实际使用中发现单节点MGR配置虽然看起来简单但有很多隐藏的坑。最大的教训是即使只有一个节点也要像对待生产集群一样严格配置所有参数否则后期扩展时会遇到各种兼容性问题。另外定期执行SELECT * FROM performance_schema.replication_group_member_stats检查应用延迟单节点环境下延迟应该始终为0如果不是则说明有性能问题需要排查。
)
