codership/mysql-galera

MySQL Galera集群Docker镜像

概述

该镜像为支持WSREP（Galera复制协议）的MySQL Docker镜像，用于构建高可用MySQL Galera集群。遵循官方MySQL Docker镜像的使用 conventions（除标签外），提供集群初始化、节点加入、集群版本升级等功能，适用于需要高可用、数据同步和故障转移的MySQL部署场景。

核心功能

• 与官方MySQL Docker镜像兼容（基础使用 conventions一致，标签除外）
• 支持Galera集群初始化：未指定WSREP_JOIN环境变量时自动创建新集群
• 节点加入功能：通过WSREP_JOIN环境变量指定现有集群节点容器名，实现节点加入
• 集群升级支持：提供安全的版本升级流程，确保集群可用性
• 严格的标签管理：集群节点必须使用相同镜像标签，禁止使用latest标签

使用场景

• 生产环境高可用MySQL部署
• 需要跨节点数据实时同步的场景
• 要求自动故障转移能力的数据库集群
• 需支持平滑版本升级的MySQL集群环境

使用方法

基础使用

基础使用遵循官方MySQL Docker镜像的 conventions（标签使用除外），详细参考：https://hub.docker.com/_/mysql

集群配置

前提条件

需创建专用网络（bridge或overlay），例如：

bash
docker network create <some-network>

初始化新集群

未指定WSREP_JOIN环境变量时，容器将初始化新集群：

bash
docker run -d --network <some-network> --name node1 ... <image tag>

加入现有集群

通过WSREP_JOIN环境变量指定现有集群中至少一个运行中的节点容器名（逗号分隔列表），加入集群：

bash
docker run -d --network <some-network> --name node2 -e WSREP_JOIN=node1,node2,node3 ... <image tag>

注：列表中需包含至少一个主配置节点，无需列出所有节点。

集群维护注意事项

• 容器停止（服务崩溃或手动停止）后，禁止重启容器！需删除停止的容器，新建容器加入剩余节点
• 所有集群节点必须使用完全相同的镜像标签，禁止使用latest标签

集群版本升级（切换镜像标签）

1. 向现有集群添加使用新标签的节点，但暂不用于客户端连接
2. 停止并移除所有旧标签节点
3. 此时新标签节点可安全用于客户端连接