derekyle/mariadb-galera

MariaDB Galera集群镜像文档

镜像概述

本镜像为适用于MariaDB Galera集群的专用镜像，支持在Kubernetes/OpenShift环境中部署，提供自动节点发现、集群配置及数据库初始化功能，简化Galera集群的部署与管理流程。

核心功能与特性

• 自动构建配置：构建时通过脚本创建数据及配置目录并设置正确权限
• 集群环境适配：支持Kubernetes/OpenShift环境，通过POD_NAMESPACE环境变量自动检测集群环境
• 节点自动发现：集成peer-finder工具，自动发现集群中的其他节点
• Galera配置生成：根据节点信息自动生成Galera集群配置文件/etc/my.cnf.d/galera.cnf
• 数据库初始化：首次运行时自动执行数据库初始化，创建用户、表结构等
• 就绪探针支持：内置就绪探针脚本，用于检测容器是否就绪

使用场景与适用范围

• 需要部署MariaDB Galera集群的场景
• Kubernetes/OpenShift容器编排环境中的数据库集群部署
• 自动化程度要求高、需减少手动配置的数据库集群环境

构建过程

构建镜像时，会调用脚本/usr/libexec/container-setup.sh，该脚本执行以下操作：

• 创建数据目录和配置目录
• 设置目录权限，确保容器运行时具有正确的访问权限

运行流程

容器运行时，入口脚本为/usr/bin/container-entrypoint.sh，执行流程如下：

1. 集群环境检测：

   • 检查POD_NAMESPACE环境变量是否存在（标识Kubernetes/OpenShift环境）
   • 若存在，运行/usr/bin/peer-finder工具查找集群中的其他节点
   • peer-finder调用/usr/share/container-scripts/mysql/configure-galera.sh生成Galera配置文件/etc/my.cnf.d/galera.cnf

2. 数据库初始化检测：

   • 检查/var/lib/mysql/mysql目录是否存在
   • 若不存在，调用/usr/share/container-scripts/mysql/configure-mysql.sh进行首次配置
   • 该脚本创建初始用户、表结构及必要的数据库配置

3. 启动数据库：

   • 调用mysqld并传入正确参数启动MariaDB服务

就绪探针

就绪探针脚本位于/usr/share/container-scripts/mysql/readiness-probe.sh，功能如下：

• 脚本退出码为0时，表示容器已就绪
• 非0退出码表示容器未就绪，Kubernetes/OpenShift会等待容器就绪后再将流量路由至该容器

peer-finder工具

peer-finder是用于查找服务所有Pod的Go二进制工具，源码地址：https://github.com/kubernetes/contrib/tree/master/peer-finder

编译方法

bash
$ go get -v
$ CGO_ENABLED=0 go build -a -installsuffix cgo --ldflags '-w' ./peer-finder.go

使用示例

Docker Run命令（Kubernetes环境）

bash
docker run -d \
  -e POD_NAMESPACE=my-galera-namespace \
  -v /path/to/mysql/data:/var/lib/mysql \
  --name galera-node-1 \
  docker.xuanyuan.run/mariadb-galera-image

环境变量说明