mobiletech/mariadb-galera

MariaDB Galera Cluster Docker容器

镜像概述和主要用途

该Docker镜像提供MariaDB Galera Cluster的容器化部署方案，支持构建高可用、多主复制的数据库集群。Galera Cluster是基于同步复制的MySQL/MariaDB集群解决方案，确保所有节点数据实时一致，适用于需要高可用性和数据可靠性的生产环境。

核心功能和特性

• 支持Galera Cluster集群配置与管理
• 提供garbd仲裁服务，增强集群可用性
• 支持数据持久化存储
• 包含完整的集群引导、节点加入及故障恢复流程
• 可通过环境变量灵活配置集群参数

使用场景和适用范围

• 构建高可用数据库集群
• 生产环境中的关键业务数据库部署
• 需要数据实时同步的多节点数据库架构
• 对数据库服务可用性要求高的应用场景

使用方法和配置说明

环境参数

运行Garbd仲裁服务

该镜像包含garbd仲裁服务，可通过指定garbd命令启动：

bash
docker run -d --net host --name galera-garbd \
  -e WSREP_CLUSTER_ADDRESS=$WSREP_CLUSTER_ADDRESS \
  mobiletech/mariadb-galera \
    garbd

引导集群

节点1（初始节点）

初始化集群的第一个节点，需使用--wsrep-new-cluster参数：

bash
docker run -d --net host --name galera \
  -e WSREP_NODE_ADDRESS=$WSREP_NODE_ADDRESS \  # 节点自身IP/域名
  -e WSREP_CLUSTER_ADDRESS=$WSREP_CLUSTER_ADDRESS \  # 集群所有节点列表
  -e MYSQL_ROOT_PASSWORD=your_secure_password \  # 设置root密码
  -p 3306:3306 \  # MySQL服务端口
  -p 4567:4567/udp \  # Galera复制端口(udp)
  -p 4567-4568:4567-4568 \  # Galera复制端口(tcp)
  -p 4444:4444 \  # SST端口
  -v /mnt/data/galera.service/mysql:/var/lib/mysql:Z \  # 数据持久化目录
  mobiletech/mariadb-galera \
    mysqld \
    --wsrep-new-cluster

节点2至N（加入集群）

1. 创建空MySQL目录以跳过数据库初始化：

   bash
   mkdir -p /mnt/data/galera.service/mysql/mysql
   

2. 正常启动容器（无需--wsrep-new-cluster参数）：

   bash
   docker run -d --net host --name galera \
     -e WSREP_NODE_ADDRESS=$WSREP_NODE_ADDRESS \  # 当前节点IP/域名
     -e WSREP_CLUSTER_ADDRESS=$WSREP_CLUSTER_ADDRESS \  # 集群所有节点列表
     -p 3306:3306 \
     -p 4567:4567/udp \
     -p 4567-4568:4567-4568 \
     -p 4444:4444 \
     -v /mnt/data/galera.service/mysql:/var/lib/mysql:Z \
     mobiletech/mariadb-galera \
       mysqld
   

集群恢复（当失去仲裁时）

恢复步骤：

1. 停止所有节点（以Systemd服务为例）：

   bash
   systemctl stop galera.service
   

2. 启动数据最完整的节点作为新集群：

   bash
   docker run -d --net host --name galera-init \
     -e WSREP_NODE_ADDRESS=$WSREP_NODE_ADDRESS \  # 该节点IP/域名
     -e WSREP_CLUSTER_ADDRESS=$WSREP_CLUSTER_ADDRESS \  # 集群节点列表
     -e MYSQL_ROOT_PASSWORD=$MYSQL_ROOT_PASSWORD \  # root密码
     -p 3307:3306 \  # 可使用不同端口临时启动
     -p 4567:4567/udp \
     -p 4567-4568:4567-4568 \
     -p 4444:4444 \
     -v /mnt/data/galera.service/mysql:/var/lib/mysql:Z \
     mobiletech/mariadb-galera \
       mysqld \
       --wsrep-new-cluster
   

3. 正常启动其他节点（以Systemd服务为例）：

   bash
   systemctl start galera.service