Docker部署MySQL MGR集群实战指南

1. 为什么选择Docker部署MySQL MGR集群？

在分布式数据库架构设计中，MySQL Group Replication（MGR）作为官方提供的高可用解决方案，近年来在企业级应用中越来越普及。而Docker容器化部署方式，则为MGR集群的搭建提供了前所未有的便利性。这种组合方式特别适合以下场景：

• 开发测试环境快速搭建：传统部署MGR需要准备多台物理机或虚拟机，而Docker可以在单机上快速模拟多节点集群
• 持续集成/交付流程：容器化的MGR节点可以方便地纳入CI/CD流水线
• 资源隔离需求：每个MySQL实例运行在独立的容器中，避免端口冲突和配置文件污染
• 版本一致性保障：通过Docker镜像确保开发、测试、生产环境使用完全相同的MySQL版本

提示：MGR是MySQL 5.7.17版本引入的插件，但在MySQL 8.0中才真正成熟。建议生产环境至少使用8.0.23以上版本以获得完整功能支持。

2. 环境准备与基础配置

2.1 Docker环境搭建

无论使用Windows、macOS还是Linux系统，Docker的安装过程都已高度简化。以下是各平台的注意事项：

Linux系统（以Ubuntu 22.04为例）：

bash复制# 卸载旧版本
sudo apt-get remove docker docker-engine docker.io containerd runc

# 安装依赖
sudo apt-get update
sudo apt-get install \
    ca-certificates \
    curl \
    gnupg \
    lsb-release

# 添加Docker官方GPG密钥
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# 设置稳定版仓库
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 安装Docker引擎
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin

# 验证安装
sudo docker run hello-world

Windows系统注意事项：

1. 需要Windows 10专业版/企业版21H2或更高版本
2. 必须启用Hyper-V和容器功能
3. 建议使用WSL 2作为后端而不是传统Hyper-V
4. 安装后如果遇到"Virtualization support not detected"错误，需进入BIOS启用VT-x/AMD-V虚拟化支持

2.2 系统资源规划

部署三节点MGR集群的最小资源要求：

注意：MGR对网络延迟非常敏感，节点间延迟超过5秒可能导致集群分裂。生产环境建议所有节点位于同一机房或可用区。

3. MySQL 8 MGR集群部署实战

3.1 容器镜像选择

官方MySQL镜像提供了多个变体：

• mysql:8.0 - 标准版
• mysql:8.0-oracle - Oracle优化版
• mysql:8.0-debian - 基于Debian的轻量版

对于MGR集群，建议使用标准版以确保功能完整性：

bash复制docker pull mysql:8.0

3.2 自定义配置文件准备

创建配置文件目录：

bash复制mkdir -p /opt/mysql-mgr/{node1,node2,node3}/conf.d

每个节点需要独立的my.cnf配置，以下是节点1的示例（其他节点需修改server-id和端口）：

ini复制# /opt/mysql-mgr/node1/conf.d/my.cnf
[mysqld]
server-id = 1
binlog_format = ROW
binlog_checksum = NONE
gtid_mode = ON
enforce_gtid_consistency = ON

# MGR特定配置
plugin_load_add = 'group_replication.so'
group_replication_group_name = "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
group_replication_start_on_boot = OFF
group_replication_local_address = "node1:33061"
group_replication_group_seeds = "node1:33061,node2:33061,node3:33061"
group_replication_bootstrap_group = OFF

3.3 使用Docker Compose编排集群

创建docker-compose.yml文件：

yaml复制version: '3.8'

services:
  mysql-node1:
    image: mysql:8.0
    container_name: mysql-mgr-node1
    environment:
      MYSQL_ROOT_PASSWORD: "SecurePass123!"
      MYSQL_DATABASE: "app_db"
    volumes:
      - /opt/mysql-mgr/node1/conf.d:/etc/mysql/conf.d
      - mysql-data-node1:/var/lib/mysql
    ports:
      - "3306:3306"
    networks:
      mysql-mgr-net:
        ipv4_address: 172.20.0.11

  mysql-node2:
    image: mysql:8.0
    container_name: mysql-mgr-node2
    environment:
      MYSQL_ROOT_PASSWORD: "SecurePass123!"
    volumes:
      - /opt/mysql-mgr/node2/conf.d:/etc/mysql/conf.d
      - mysql-data-node2:/var/lib/mysql
    ports:
      - "3307:3306"
    networks:
      mysql-mgr-net:
        ipv4_address: 172.20.0.12

  mysql-node3:
    image: mysql:8.0
    container_name: mysql-mgr-node3
    environment:
      MYSQL_ROOT_PASSWORD: "SecurePass123!"
    volumes:
      - /opt/mysql-mgr/node3/conf.d:/etc/mysql/conf.d
      - mysql-data-node3:/var/lib/mysql
    ports:
      - "3308:3306"
    networks:
      mysql-mgr-net:
        ipv4_address: 172.20.0.13

volumes:
  mysql-data-node1:
  mysql-data-node2:
  mysql-data-node3:

networks:
  mysql-mgr-net:
    driver: bridge
    ipam:
      config:
        - subnet: 172.20.0.0/24

启动集群：

bash复制docker-compose up -d

4. MGR集群初始化与验证

4.1 引导第一个节点

进入节点1容器：

bash复制docker exec -it mysql-mgr-node1 mysql -uroot -pSecurePass123!

执行初始化SQL：

sql复制-- 创建复制用户
SET SQL_LOG_BIN=0;
CREATE USER 'repl'@'%' IDENTIFIED BY 'ReplPass123!';
GRANT REPLICATION SLAVE ON *.* TO 'repl'@'%';
FLUSH PRIVILEGES;
SET SQL_LOG_BIN=1;

-- 配置Group Replication
CHANGE MASTER TO MASTER_USER='repl', MASTER_PASSWORD='ReplPass123!' 
FOR CHANNEL 'group_replication_recovery';

-- 启动引导
SET GLOBAL group_replication_bootstrap_group=ON;
START GROUP_REPLICATION;
SET GLOBAL group_replication_bootstrap_group=OFF;

4.2 添加其他节点

进入节点2容器：

bash复制docker exec -it mysql-mgr-node2 mysql -uroot -pSecurePass123!

执行加入集群命令：

sql复制-- 配置Group Replication
CHANGE MASTER TO MASTER_USER='repl', MASTER_PASSWORD='ReplPass123!' 
FOR CHANNEL 'group_replication_recovery';

-- 加入集群
START GROUP_REPLICATION;

节点3的操作与节点2完全相同。

4.3 集群状态验证

在任何节点执行：

sql复制SELECT * FROM performance_schema.replication_group_members;

正常输出应类似：

code复制+---------------------------+--------------------------------------+-------------+-------------+--------------+
| CHANNEL_NAME              | MEMBER_ID                            | MEMBER_HOST | MEMBER_PORT | MEMBER_STATE |
+---------------------------+--------------------------------------+-------------+-------------+--------------+
| group_replication_applier | d1d82622-9e78-11ec-98e8-0242ac110002 | node1       |        3306 | ONLINE       |
| group_replication_applier | d1d82b86-9e78-11ec-98e8-0242ac110003 | node2       |        3306 | ONLINE       |
| group_replication_applier | d1d82d48-9e78-11ec-98e8-0242ac110004 | node3       |        3306 | ONLINE       |
+---------------------------+--------------------------------------+-------------+-------------+--------------+

5. 生产环境优化与故障处理

5.1 关键参数调优

在my.cnf中添加以下优化参数：

ini复制# 性能优化
group_replication_flow_control_mode = "QUOTA"
group_replication_flow_control_applier_threshold = 25000
group_replication_flow_control_certifier_threshold = 25000
group_replication_transaction_size_limit = 20971520

# 网络优化
group_replication_communication_max_message_size = 10485760
group_replication_member_expel_timeout = 30

5.2 常见问题排查

问题1：节点无法加入集群

检查步骤：

1. 确认所有节点的group_replication_group_name完全相同
2. 验证网络连通性：docker exec -it mysql-mgr-node1 ping 172.20.0.12
3. 检查防火墙设置，确保33061端口互通
4. 查看错误日志：docker logs mysql-mgr-node2

问题2：脑裂（Split Brain）情况处理

当多数节点失联时，可能形成两个独立集群。恢复步骤：

1. 确定哪个分区包含最新数据（通过GTID判断）
2. 在旧分区节点执行：STOP GROUP_REPLICATION;
3. 在新分区主节点执行：RESET MASTER; SET @@GLOBAL.GTID_PURGED='...';
4. 将旧分区节点重新加入集群

5.3 备份与恢复策略

物理备份（推荐）：

bash复制# 在线备份节点1
docker exec mysql-mgr-node1 mysqlbackup -uroot -pSecurePass123! \
  --backup-dir=/tmp/backup --backup-image=/tmp/backup.mbi \
  --host=127.0.0.1 --port=3306 backup-and-apply-log

# 恢复到新节点
docker run --name mysql-restore -v /backup:/backup -e MYSQL_ROOT_PASSWORD=newpass mysql:8.0 \
  mysqlbackup --backup-dir=/backup --datadir=/var/lib/mysql copy-back

逻辑备份：

bash复制docker exec mysql-mgr-node1 mysqldump -uroot -pSecurePass123! \
  --all-databases --single-transaction --triggers --routines > full_backup.sql

6. 监控与运维实践

6.1 关键指标监控

建议监控以下性能指标：

6.2 自动化运维脚本

集群健康检查脚本：

bash复制#!/bin/bash

for node in node1 node2 node3; do
  echo "Checking $node..."
  docker exec mysql-mgr-$node mysql -uroot -pSecurePass123! -e "
    SELECT 
      MEMBER_HOST, 
      MEMBER_STATE, 
      IF(MEMBER_ID = @@global.group_replication_primary_member, 'PRIMARY', 'SECONDARY') AS ROLE,
      COUNT_TRANSACTIONS_IN_QUEUE AS TX_QUEUE
    FROM performance_schema.replication_group_members
    WHERE MEMBER_ID = @@global.server_uuid\G"
done

自动故障转移处理：

python复制import docker
import mysql.connector

client = docker.from_env()

def check_mgr_health():
    try:
        conn = mysql.connector.connect(
            host='node1',
            user='monitor',
            password='MonitorPass123!',
            database='performance_schema'
        )
        cursor = conn.cursor()
        cursor.execute("""
            SELECT COUNT(*) FROM replication_group_members 
            WHERE MEMBER_STATE != 'ONLINE'
        """)
        offline_nodes = cursor.fetchone()[0]
        return offline_nodes == 0
    except Exception as e:
        print(f"Health check failed: {str(e)}")
        return False

if not check_mgr_health():
    print("Cluster unhealthy, attempting recovery...")
    # 执行恢复逻辑

7. 安全加固措施

7.1 网络隔离

建议的Docker网络架构：

yaml复制networks:
  mysql-mgr-net:
    driver: bridge
    internal: true  # 禁止外部访问
    ipam:
      config:
        - subnet: 172.20.0.0/24

通过单独的应用网络连接前端服务：

yaml复制services:
  app-server:
    networks:
      - app-net
      - mysql-mgr-net

networks:
  app-net:
    driver: bridge
  mysql-mgr-net:
    driver: bridge
    internal: true

7.2 加密配置

启用SSL加密通信：

ini复制[mysqld]
ssl_ca = /etc/mysql/certs/ca.pem
ssl_cert = /etc/mysql/certs/server-cert.pem
ssl_key = /etc/mysql/certs/server-key.pem
group_replication_ssl_mode = REQUIRED

生成证书（在宿主机执行）：

bash复制# 创建CA证书
openssl genrsa 2048 > ca-key.pem
openssl req -new -x509 -nodes -days 365000 \
  -key ca-key.pem -out ca.pem

# 创建服务器证书
openssl req -newkey rsa:2048 -days 365000 \
  -nodes -keyout server-key.pem -out server-req.pem
openssl rsa -in server-key.pem -out server-key.pem
openssl x509 -req -in server-req.pem -days 365000 \
  -CA ca.pem -CAkey ca-key.pem -set_serial 01 -out server-cert.pem

8. 性能基准测试

8.1 测试环境配置

使用sysbench进行基准测试：

bash复制docker run --rm --network=mysql-mgr-net \
  severalnines/sysbench sysbench \
  --db-driver=mysql \
  --mysql-host=mysql-mgr-node1 \
  --mysql-port=3306 \
  --mysql-user=root \
  --mysql-password=SecurePass123! \
  --mysql-db=test \
  --tables=10 \
  --table-size=100000 \
  --threads=16 \
  --time=300 \
  --report-interval=10 \
  oltp_read_write prepare

8.2 测试结果分析

典型三节点MGR集群性能指标：

优化建议：

1. 对于写密集型应用，考虑使用读写分离中间件
2. 调整group_replication_flow_control_*参数优化流量控制
3. 增加binlog_group_commit_sync_delay微调提交性能

9. 版本升级策略

MySQL 8.0的MGR功能持续改进，建议升级路线：

1. 原地升级（In-Place Upgrade）：

bash复制# 停止容器
docker stop mysql-mgr-node1

# 使用新镜像启动
docker run --name mysql-mgr-node1-new \
  -v /opt/mysql-mgr/node1/conf.d:/etc/mysql/conf.d \
  -v mysql-data-node1:/var/lib/mysql \
  mysql:8.0.28 \
  --upgrade=FORCE

2. 滚动升级（Rolling Upgrade）：

• 逐个节点停止并升级，确保集群始终有多数节点在线
• 每个节点升级后验证数据一致性

3. 蓝绿部署：

• 搭建全新版本的MGR集群
• 使用MySQL Router或ProxySQL进行流量切换
• 验证无误后下线旧集群

10. 真实案例经验分享

在金融级应用中使用Docker部署MGR集群的几个关键教训：

1. 容器时间同步问题：

   • 发现节点间出现1-2秒时间差导致事务冲突
   • 解决方案：所有容器挂载宿主机/etc/localtime，并运行NTP服务

2. 存储性能瓶颈：

   • 默认的Docker overlay2存储驱动在高IO压力下性能下降
   • 改用direct-lvm存储驱动后性能提升40%

3. 内存溢出问题：

   • 容器内存限制导致OOM Killer终止MySQL进程
   • 设置合理的--memory和--memory-swap参数
   • 配置MySQL的innodb_buffer_pool_size不超过容器内存的70%

4. 网络抖动处理：

   • 云环境网络偶尔抖动导致节点被驱逐
   • 调整group_replication_member_expel_timeout=60减少误判

这些实战经验让我深刻理解到，虽然Docker简化了部署，但生产环境仍需针对MGR的特点进行深度调优。每个参数背后都对应着真实场景中的血泪教训，这也是为什么文档上的"默认值"往往需要根据实际业务特点进行调整。