toughiq/mariadb-cluster

docker-mariadb-cluster（V2版本）

Docker化的自动化MariaDB Galera集群镜像，适用于Docker 1.12.1+ Swarm模式。V2为高级分支，标记为latest；旧版V1.0可通过docker pull toughiq/mariadb-cluster:1.0获取。

注意：此镜像为POC（概念验证）版本，非生产就绪系统！

镜像概述

本项目旨在创建自动化、完全临时的MariaDB Galera集群，无需静态绑定或持久卷，数据跨集群节点复制，节点故障时可自动拉起新节点并初始化数据。

核心功能

• 自动集群引导：单节点启动时自动进入引导模式
• 节点扩容支持：通过Swarm服务扩容实现集群节点添加
• 数据复制：类似磁盘RAID的跨节点数据同步
• 环境变量配置：支持设置root密码、创建数据库及用户等
• Swarm模式适配：专为Docker Swarm设计，利用Swarm网络与负载均衡

使用场景

• 开发/测试环境的高可用数据库集群快速部署
• 学习MariaDB Galera集群原理的实验环境
• 轻量级非生产环境的数据库高可用方案验证

配置说明

1. 初始化Swarm集群

• Swarm主节点：执行docker swarm init
• 添加Swarm节点：在其他节点执行docker swarm join <主节点IP>:2377 --token <join-token>（可通过docker swarm join-token manager/worker获取token）

2. 创建数据库网络

bash
docker network create -d overlay mydbnet

3. 引导数据库集群

启动单节点服务以引导集群：

bash
docker service create --name dbcluster \
--network mydbnet \
--replicas=1 \
--env DB_SERVICE_NAME=dbcluster \
toughiq/mariadb-cluster

可选配置：设置数据库参数（如root密码、初始数据库等）：

bash
docker service create --name dbcluster \
--network mydbnet \
--replicas=1 \
--env DB_SERVICE_NAME=dbcluster \
--env MYSQL_ROOT_PASSWORD=rootpass \
--env MYSQL_DATABASE=mydb \
--env MYSQL_USER=mydbuser \
--env MYSQL_PASSWORD=mydbpass \
toughiq/mariadb-cluster

注意：--name指定的服务名需与DB_SERVICE_NAME环境变量值一致。

4. 扩容集群节点

待首个节点运行后，执行扩容命令：

bash
docker service scale dbcluster=3

可通过docker service ps dbcluster查看节点状态。

5. 部署MaxScale代理服务（可选）

MaxScale提供额外的数据库流量负载均衡功能，可通过以下命令部署：

bash
docker service create --name maxscale \
--network mydbnet \
--env DB_SERVICE_NAME=dbcluster \
--env ENABLE_ROOT_USER=1 \
--publish 3306:3306 \
toughiq/maxscale

说明：ENABLE_ROOT_USER=1开启MaxScale的root访问（默认关闭），可通过--publish暴露端口供外部访问。

验证集群状态

通过MaxScale查看集群状态：

bash
docker exec -it maxscale.<SLOT>.<ID> maxadmin -pmariadb list servers

（<SLOT>和<ID>可通过docker service ps maxscale获取）