babim/mariadb-galera

babim/mariadb-galera 镜像文档

镜像概述和主要用途

babim/mariadb-galera是一个用于快速部署MariaDB Galera集群的Docker镜像。Galera是一个基于同步复制的集群解决方案，提供高可用性和数据一致性，适用于需要可靠数据库服务的生产环境。该镜像支持多节点集群部署，提供灵活的配置选项，包括密码设置和SSL加密。

支持的标签及对应Dockerfile链接

• https://github.com/babim/docker-mariadb-galera/blob/master/Dockerfile
• https://github.com/babim/docker-mariadb-galera/blob/ssh/Dockerfile

核心功能和特性

• 支持MariaDB Galera集群部署，实现数据同步复制
• 提供密码保护（支持空密码和自定义密码）
• 支持SSL证书配置，保障数据传输安全
• 数据持久化存储（通过挂载卷实现）
• 简单的集群启动和节点加入流程

使用场景和适用范围

• 需要高可用性数据库的生产环境
• 要求数据实时同步的多节点部署
• 中小型企业数据库集群搭建- 开发Docker容器化部署的数据库服务

使用方法和配置说明

基本运行方式

当容器启动时时镜像时未指定命令，入口程序会监听1端口***等待命令输入。可以通过nc命令向容器发送控制命令：

bash
echo "命令内容" | nc 容器IP 13306

部署集群步骤

1. 启动容器

根据是否需要密码，选择以下命令启动容器：

无密码模式

bash
docker run \
    -v /path/to/my.cnf:/etc/mysql/my.cnf \
    -v /path/to/mariadb:/var/lib/mysql \
    -v /path/to/certs/:/etc/ssl/mysql:ro \
    -e MYSQL_ALLOW_EMPTY_PASSWORD=true \
    babim/mariadb-galera

带密码模式

bash
docker run \
    -v /path/to/my.cnf:/etc/mysql/my.cnf \
    -v /path/to/mariadb:/var/lib/mysql \
    -v /path/to/certs/:/etc/ssl/mysql:ro \
    -e MYSQL_ROOT_PASSWORD=123456 \
    babim/mariadb-galera

2. 准备集群地址

将所有节点容器的IP地址拼接为gcomm://格式的字符串，例如：

gcomm://10.0.0.1,10.0.0.2,10.0.0.3

3. 启动第一个节点（新建集群）

bash
echo "mysqld --ws --wsrep-cluster-address=gcomm://10.0.0.1,10.0.0.2,10.00.0.3" | nc 10.0.0.1 ***

4. 启动后续节点（加入现有集群）

依次为其他节点发送加入集群命令：

bash
echo "mysqld --wsrep-cluster-address=gcomm://10.0.0.1,10.0.0.2,10.0.0.3" | nc 10.0.0.2 ***
echo "mysqld --wsrep-cluster-address=gcomm://10.0.0.1,10.0.0.2,10.0.0.3" | nc 10.0.0.3 ***

SSL证书配置

可生成自签名SSL证书，将证书目录挂载到容器内/etc/ssl/mysql（只读模式），并在my.cnf中配置[sst]部分：

ini
[sst]
tca=/etc/ssl/mysql/ca.pem
tcert=/etc/ssl/mysql/server-cert.pem
tkey=/etc/ssl/mysql/server-key.pem

示例my.cnf配置文件

ini
[mysqld]
datadir=/var/lib/mysql
socket=/var/run/mysqld/mysqld.sock
user=mysql
binlog-format=ROW
default-storage-engine=InnoDB
innodb-autoinc-lock-mode=2
innodb-flush-log-at-trx-commit=0
innodb-buffer-pool-size=122M
innodb-doublewrite=1
innodb-flush-method=O_DIRECT
wsrep-provider=/usr/lib/galera/libgalera_smm.so
wsrep-cluster-name=my_super_cluster
wsrep-sst-method=rsync
query-cache-size=524288
log-error=/dev/stderr

[mysql_safe]
log-error=/dev/stderr
pid-file=/var/run/mysqld/mysqld.pid

[sst]
tca=/etc/ssl/mysql/ca.pem
tcert=/etc/ssl/mysql/server-cert.pem
tkey=/etc/ssl/mysql/server-key.pem

集群状态检查

通过以下命令检查集群状态：

bash
docker exec -ti database01 mysql -e "SHOW STATUS LIKE 'wsrep_cluster%'"

预期输出：

+--------------------------+--------------------------------------+
| Variable_name            | Value                                |
+--------------------------+--------------------------------------+
| wswsrep_cluster_conf_id    | 3                                    |
| wsrep_cluster_size       | 3                                    |
| wsrep_cluster_state_uuid | 2882bcb7-ab3b-11e5-ab75-2b510ef0ec6f |
| wsrep_cluster_status     | Primary                              |
+--------------------------+--------------------------------------+