allworldit/mariadb

![pipeline status]([***]

容器信息

容器源码 - https://github.com/AllWorldIT/containers-mariadb

这是Conarx Containers的MariaDB镜像，提供集成Galera集群支持的MariaDB数据库服务。

额外功能：

• Innodb缓冲大小配置
• 查询缓存配置
• 数据库创建时预加载SQL文件
• 支持可选GTID的Galera集群

镜像仓库

Conarx Containers说明

我们所有的Docker镜像均属于Conarx Containers产品线，通常基于Alpine Linux构建，版本格式为vXX.YY（跟踪Alpine Linux主版本和次版本）。

从源码构建的镜像版本格式为vXX.YY-AA.BB，其中AA.BB为主软件组件版本，同时跟踪Alpine Linux版本。

镜像基于Flexible Docker Containers框架构建，包含以下特性：

• 灵活的容器初始化与启动流程
• 集成单元测试
• 高级多服务健康检查
• 原生IPv6支持
• 调试选项

社区支持

请使用项目Issue追踪器反馈问题。

商业支持

Conarx提供所有Docker镜像的商业支持服务，详情请访问Conarx官网。我们还提供定制Docker镜像的咨询服务，满足您的特定需求。

通用环境变量

额外环境变量可参考：

• Conarx Containers Alpine镜像

环境变量前缀为MYSQL_，以保持与官方MariaDB/MySQL镜像的兼容性。

MYSQL_ROOT_PASSWORD

数据库创建时的可选root密码。若未指定，将自动生成并输出到日志中。

MYSQL_DATABASE

可选创建的数据库名称。

MYSQL_USER

可选创建的数据库用户，将被授予MYSQL_DATABASE的访问权限。

MYSQL_PASSWORD

MYSQL_USER的可选密码。

MYSQL_CHARSET

数据库的可选字符集，默认值为utf8mb4。

MYSQL_COLLATION

数据库的可选排序规则，默认值为uca1400_as_ci。

MYSQL_BUFFER_SIZE

建议设置为可用内存的60%，例如MYSQL_BUFFER_SIZE=200M。

MYSQL_QUERY_CACHE_SIZE

设置查询缓存大小（单位：MB），例如MYSQL_QUERY_CACHE_SIZE=8。

卷挂载

/var/lib/mysql

MariaDB数据存储目录。

数据库创建时预加载SQL

目录：/var/lib/mysql-initdb.d

该目录下所有扩展名为.sql、.sql.gz、.sql.xz或.sql.zst的文件，将在数据库初始化时被加载。

暴露端口

暴露MariaDB默认端口3306。

集群配置

使用集群时，所有节点的数据库凭据必须保持一致。若将首个节点从普通数据库切换为集群模式，需在数据目录创建.create_sst_user文件以生成同步用户：

bash
touch data/var/lib/mysql/.create_sst_user

集群设置

通过环境变量配置集群：

MYSQL_CLUSTER_JOIN

启用集群的关键选项
逗号分隔的集群节点列表，最小配置为MYSQL_CLUSTER_NODE_NAME的值。

MYSQL_SST_PASSWORD

必填选项
必须指定该密码，默认值msyql.sst不安全。

MYSQL_CLUSTER_DEBUG

启用集群调试模式，例如MYSQL_CLUSTER_DEBUG=yes。

MYSQL_CLUSTER_NAME

可选集群名称。

MYSQL_CLUSTER_NODE_NAME

可选节点主机名，默认值为hostname -f的输出。

MYSQL_CLUSTER_NODE_IP

可选节点IP地址，默认值为hostname -i的输出。

MYSQL_CLUSTER_NODE_PORT

可选集群通信端口，默认值为3306。

集群GTID支持

MYSQL_CLUSTER_USE_GTID

启用集群GTID支持。

MYSQL_CLUSTER_GTID_LOCAL_ID

GTID必填选项
全局唯一的节点ID，不可与MYSQL_CLUSTER_GTID_CLUSTER_ID重复。

MYSQL_CLUSTER_GTID_CLUSTER_ID

GTID必填选项
全局唯一的集群ID，不可与MYSQL_CLUSTER_GTID_LOCAL_ID重复。

集群引导

若为首个启动的节点，需创建数据目录并触摸引导文件：

bash
mkdir -p data/var/lib/mysql
touch data/var/lib/mysql/.bootstrap-cluster

这将添加--wsrep-new-cluster参数并设置该节点为主节点。若节点不是最后离开集群但需作为首个启动节点，需额外创建强制引导文件：

bash
touch data/var/lib/mysql/.force-bootstrap-cluster

集群配置示例

节点1

bash
MYSQL_USER=testuser
MYSQL_PASSWORD=testpass
MYSQL_ROOT_PASSWORD=rootpass
MYSQL_DATABASE=testdb
# 集群配置
MYSQL_CLUSTER_NODE_NAME=node1
MYSQL_CLUSTER_JOIN=node1,node2,node3
# 可选GTID支持
MYSQL_CLUSTER_USE_GTID=yes
MYSQL_CLUSTER_GTID_LOCAL_ID=10
MYSQL_CLUSTER_GTID_CLUSTER_ID=100

初始化数据卷并设置强制引导：

bash
mkdir -p data/var/lib/mysql
touch data/var/lib/mysql/bootstrap-cluster

节点2

bash
MYSQL_USER=testuser
MYSQL_PASSWORD=testpass
MYSQL_ROOT_PASSWORD=rootpass
MYSQL_DATABASE=testdb
# 集群配置
MYSQL_CLUSTER_NODE_NAME=node2
MYSQL_CLUSTER_JOIN=node1,node2,node3
# 可选GTID支持
MYSQL_CLUSTER_USE_GTID=yes
MYSQL_CLUSTER_GTID_LOCAL_ID=20
MYSQL_CLUSTER_GTID_CLUSTER_ID=200

初始化数据卷：

bash
mkdir -p data/var/lib/mysql

节点3

bash
MYSQL_USER=testuser
MYSQL_PASSWORD=testpass
MYSQL_ROOT_PASSWORD=rootpass
MYSQL_DATABASE=testdb
# 集群配置
MYSQL_CLUSTER_NODE_NAME=node3
MYSQL_CLUSTER_JOIN=node1,node2,node3
# 可选GTID支持
MYSQL_CLUSTER_USE_GTID=yes
MYSQL_CLUSTER_GTID_LOCAL_ID=30
MYSQL_CLUSTER_GTID_CLUSTER_ID=300

初始化数据卷：

bash
mkdir -p data/var/lib/mysql