muccg/mariadb-galera

MariaDB Galera集群镜像文档

镜像概述

本镜像基于官方MariaDB Docker镜像构建，保留了官方容器的基本行为（包括初始化流程、用户管理、密码配置等），并新增了Galera集群支持。适用于需要部署高可用MariaDB集群的场景，通过简单配置即可实现数据库节点间的同步复制与故障转移。

核心功能与特性

• 兼容官方行为：完全保留官方MariaDB容器的基础功能，包括数据初始化、用户创建、密码设置等核心操作。
• Galera集群支持：集成Galera集群功能，支持多节点间的数据同步复制，实现高可用架构。
• 灵活配置方式：通过/etc/mysql/conf.d卷挂载实现集群配置，用户可自定义.cnf配置文件。
• 示例配置提供：包含用于集群引导的示例配置文件cluster.cnf，简化初始部署流程。
• 集群端口暴露：除标准MariaDB端口外，额外暴露Galera集群通信所需端口。

使用场景

• 生产环境中需要高可用数据库服务的场景
• 要求数据冗余和自动故障转移的企业级应用
• 需要跨节点数据同步的分布式系统
• 对数据库服务可用性有严格要求的业务系统

使用方法与配置说明

基本使用前提

1. 确保所有集群节点网络互通，特别是Galera集群所需端口
2. 准备集群配置文件（可基于提供的cluster.cnf示例修改）
3. 为每个节点规划持久化存储路径

配置文件准备

1. 创建集群配置文件（如galera.cnf），示例内容：

ini
[mysqld]
binlog_format=ROW
default-storage-engine=InnoDB
innodb_autoinc_lock_mode=2
bind-address=0.0.0.0

# Galera配置
wsrep_on=ON
wsrep_provider=/usr/lib/galera/libgalera_smm.so
wsrep_cluster_name="my_galera_cluster"
wsrep_cluster_address="gcomm://node1_ip,node2_ip,node3_ip"
wsrep_node_name="node1"
wsrep_node_address="node1_ip"
wsrep_sst_method=rsync

2. 将配置文件保存到宿主机目录（如/path/to/conf.d）

启动集群节点

引导集群（第一个节点）

bash
docker run -d \
  --name mariadb-galera-node1 \
  -p 3306:3306 \
  -p 4567:4567 \
  -p 4568:4568 \
  -p 4444:4444 \
  -v /path/to/conf.d:/etc/mysql/conf.d \
  -v /path/to/data:/var/lib/mysql \
  -e MYSQL_ROOT_PASSWORD=your_root_password \
  your-image-name \
  --wsrep-new-cluster

加入集群（后续节点）

bash
docker run -d \
  --name mariadb-galera-node2 \
  -p 3306:3306 \
  -p 4567:4567 \
  -p 4568:4568 \
  -p 4444:4444 \
  -v /path/to/conf.d:/etc/mysql/conf.d \
  -v /path/to/data:/var/lib/mysql \
  -e MYSQL_ROOT_PASSWORD=your_root_password \
  your-image-name

关键参数说明

• 卷挂载：/etc/mysql/conf.d为配置文件卷，/var/lib/mysql为数据持久化卷
• 暴露端口：
  • 3306：MariaDB服务端口
  • 4567：Galera集群通信端口（UDP/TCP）
  • 4568：IST（增量状态传输）端口
  • 4444：SST（全量状态传输）端口
• 环境变量：MYSQL_ROOT_PASSWORD设置root用户密码，其他官方MariaDB环境变量同样适用
• 集群引导参数：--wsrep-new-cluster仅在初始化集群第一个节点时使用

集群管理参考

集群的详细管理操作（如节点添加/移除、状态监控、故障恢复等）请参考Galera官方文档。