chagridsada/galera-mariadb

MariaDB 10.2 Docker镜像（Galera集群）

目录

1. 概述
2. 要求
3. 镜像说明
4. 运行容器
5. 构建镜像
6. 发现服务
7. 已知限制
8. 开发

概述

该镜像支持运行MariaDB 10.2（内置Galera集群组件），可通过Docker Swarm Mode、Kubernetes等编排工具部署，需依赖etcd服务实现节点自动发现，也可在单机环境运行。

要求

需具备健康的etcd集群（单机或集群模式均可）。可参考Severalnines的博客文章了解配置方法。

镜像说明

拉取镜像命令：

bash
docker pull severalnines/mariadb

镜像包含以下组件：

• MariaDB 10.2（Galera就绪）
• MariaDB客户端包
• Percona Xtrabackup备份工具
• jq JSON处理工具
• report_status.sh（定期向etcd报告集群状态）
• healthcheck.sh（健康检查脚本）

运行容器

参数说明

• 必填：MYSQL_ROOT_PASSWORD（数据库root密码）
• 可选：XTRABACKUP_PASSWORD（xtrabackup用户密码）
• 发现服务：DISCOVERY_SERVICE（etcd地址列表，逗号分隔）、CLUSTER_NAME（集群名称）
• 手动集群：CLUSTER_JOIN（现有节点IP列表，空值创建新集群）
• 状态报告：TTL（默认10秒，节点定期向etcd更新状态）

Docker Swarm Mode部署

临时存储集群

bash
docker service create \
--name mariadb-galera \
--replicas 3 \
-p 3306:3306 \
--network galera-net \
--env MYSQL_ROOT_PASSWORD=mypassword \
--env DISCOVERY_SERVICE=192.168.55.111:2379,192.168.55.112:2379,192.168.55.113:2379 \
--env XTRABACKUP_PASSWORD=mypassword \
--env CLUSTER_NAME=my_wsrep_cluster \
severalnines/mariadb

持久化存储集群

bash
docker service create \
--name mariadb-galera \
--replicas 3 \
-p 3306:3306 \
--network galera-net \
--mount type=volume,source=galera-vol,destination=/var/lib/mysql \
--env MYSQL_ROOT_PASSWORD=mypassword \
--env DISCOVERY_SERVICE=192.168.55.111:2379,192.168.55.112:2379,192.168.55.113:2379 \
--env XTRABACKUP_PASSWORD=mypassword \
--env CLUSTER_NAME=my_wsrep_cluster \
severalnines/mariadb

自定义配置

bash
docker service create \
--name mariadb-galera \
--replicas 3 \
-p 3306:3306 \
--network galera-net \
--mount type=volume,source=galera-vol,destination=/var/lib/mysql \
--mount type=bind,src=/mnt/docker/mysql-config,dst=/etc/my.cnf.d \
--env MYSQL_ROOT_PASSWORD=mypassword \
--env DISCOVERY_SERVICE=192.168.55.111:2379,192.168.55.112:2379,192.168.55.113:2379 \
--env XTRABACKUP_PASSWORD=mypassword \
--env CLUSTER_NAME=my_wsrep_cluster \
severalnines/mariadb

无编排工具部署

单机节点：

bash
docker run -d \
-p 3306 \
--name=galera \
-e MYSQL_ROOT_PASSWORD=mypassword \
-e DISCOVERY_SERVICE=192.168.55.111:2379,192.168.55.112:2379,192.168.55.113:2379 \
-e CLUSTER_NAME=my_wsrep_cluster \
-e XTRABACKUP_PASSWORD=mypassword \
severalnines/mariadb

三节点集群：

bash
for i in 1 2 3; 
do \
docker run -d \
-p 3306 \
--name=galera${i} \
-e MYSQL_ROOT_PASSWORD=mypassword \
-e DISCOVERY_SERVICE=192.168.55.111:2379,192.168.55.112:2379,192.168.55.113:2379 \
-e CLUSTER_NAME=my_wsrep_cluster \
-e XTRABACKUP_PASSWORD=mypassword \
severalnines/mariadb;
done

构建镜像

bash
git clone https://github.com/severalnines/galera-docker-mariadb
cd galera-docker-mariadb
docker build -t --rm=true severalnines/mariadb .

发现服务

节点通过etcd维护集群状态，默认TTL 30秒。查看集群状态：

bash
curl -s "http://192.168.55.111:2379/v2/keys/galera/my_wsrep_cluster?recursive=true" | python -m json.tool

已知限制

• 脑裂场景需手动恢复：选择最先进节点执行set global wsrep_provider_option="pc.bootstrap=1"
• etcd注册信息需手动清理：curl http://etcd-ip:2379/v2/keys/galera/cluster-name?recursive=true -XDELETE

开发

反馈问题可通过https://github.com/severalnines/galera-docker-mariadb%E6%88%96%E6%94%AF%E6%8C%81%E6%B8%A0%E9%81%93%E3%80%82