sapk/mariadb-swarm

MariaDB Galera集群镜像

镜像概述

本Docker镜像基于官方mariadb:10.1镜像构建，兼容Docker Swarm Mode（1.12+）、Kontena等自动调度系统，也支持通过手动指定环境变量的docker run方式部署。核心特点是利用DNS解析实现节点自动发现，无需显式指定节点地址，适用于构建高可用的MariaDB Galera集群。

核心功能

• 多启动模式：支持seed（初始化新集群）、node（加入现有集群）、no-galera（禁用Galera用于维护）、sleep（仅启动容器不运行服务）等模式。
• 自动节点发现：通过DNS服务发现（如Docker Swarm的tasks域名）自动解析集群节点地址。
• 集群恢复：处理多种故障场景（如集群异常 shutdown），通过--wsrep-recovery及节点间通信自动选择最优节点引导集群。
• 健康检查：内置Go语言实现的健康检查服务，暴露8080端口（用于Docker HEALTHCHECK）和8081端口（集群状态查询）。
• 灵活扩展：支持自定义启动脚本（/usr/local/lib/startup.sh）及节点地址配置（NODE_ADDRESS）。

使用场景

• Docker Swarm Mode下快速部署高可用数据库集群。
• 手动调度部署Galera集群进行测试或小规模生产环境。
• 执行数据库维护任务（如mysql_upgrade、重置root密码）。
• 通过docker exec进行容器内调试（使用sleep模式）。

配置说明

环境变量

• 必填变量：XTRABACKUP_PASSWORD（XtraBackup密码）
• 可选通用变量：
  • SYSTEM_PASSWORD：默认基于XTRABACKUP_PASSWORD生成哈希值。
  • CLUSTER_NAME：集群名称。
  • NODE_ADDRESS：节点地址（默认优先ethwe接口，其次eth0；可指定接口名或IP匹配模式，如^10.0.1.*）。
• seed模式额外变量：MYSQL_ROOT_PASSWORD、MYSQL_DATABASE、MYSQL_USER、MYSQL_PASSWORD（初始化数据库用）。
• node模式额外变量：GCOMM_MINIMUM（启动前需解析的最小节点数，默认2）。

Docker Swarm Mode部署示例

bash
# 创建seed节点初始化集群
docker service create --name galera-seed --replicas 1 [OPTIONS] sapk/mariadb-swarm seed
# 创建2个node节点加入集群
docker service create --name galera --replicas 2 [OPTIONS] sapk/mariadb-swarm node tasks.galera-seed,tasks.galera
# 删除seed节点
docker service rm galera-seed
# 扩展集群至3个节点
docker service scale galera=3

维护操作示例

• 强制引导新集群：在node模式下，创建/var/lib/mysql/wsrep-new-cluster文件可强制节点引导新集群。
• 提升主组件：执行docker exec -i <container> mysql -p /primary-component.sql可将运行中的节点提升为新的主组件。
• 维护模式：使用no-galera模式可执行mysql_upgrade等维护任务。