MariaDB 10.3 SQL数据库服务器Docker镜像

概述

本容器镜像包含MariaDB 10.3 SQL数据库服务器，适用于OpenShift和一般用途。用户可选择基于RHEL、CentOS或Fedora的镜像版本：RHEL镜像可在Red Hat容器目录获取，CentOS镜像可在Quay.io获取，Fedora镜像可在Fedora Registry获取。生成的镜像可使用podman运行。

注意：本文档示例中使用podman命令，所有此类命令均可替换为docker，参数保持不变。

核心功能与特性

本容器镜像提供MariaDB mysqld守护进程和客户端应用的容器化封装。mysqld服务器守护进程接受客户端连接，并代表客户端提供对MySQL数据库内容的访问。更多关于MariaDB项目的信息可访问官方网站。

使用场景与适用范围

• 开发和测试环境中的数据库服务部署
• OpenShift平台上的数据库服务集成
• 需要快速启动、配置灵活的MySQL兼容数据库场景
• 支持数据持久化存储和自定义配置的生产环境（需合理配置权限和资源）

使用方法与配置说明

基本使用

以下示例基于Red Hat容器目录中的rhel8/mariadb-103镜像。若仅设置必要环境变量且不将数据库存储在主机目录，执行以下命令：

$ docker run -d --name mariadb_database -e MYSQL_USER=user -e MYSQL_PASSWORD=pass -e MYSQL_DATABASE=db -p 3306:3306 rhel8/mariadb-103

此命令将创建名为mariadb_database的容器，运行包含数据库db和用户user:pass的MySQL服务，暴露3306端口并映射到主机。若需数据库在容器重启后持久化，添加-v /host/db/path:/var/lib/mysql/data参数（/host/db/path为主机目录，容器内对应MySQL数据目录）。

首次启动时，若数据目录未初始化，入口脚本将运行mysql_install_db并设置必要的数据库用户和密码；若已初始化，则直接启动mysqld（PID 1）。可通过docker stop mariadb_database停止容器。

环境变量与挂载点

环境变量

通过-e VAR=VALUE参数设置以下环境变量（均为可选，除非特别说明）：

基础配置变量

• MYSQL_USER：要创建的MySQL账户用户名（必填）
• MYSQL_PASSWORD：用户账户密码（必填）
• MYSQL_DATABASE：数据库名称（必填）
• MYSQL_ROOT_PASSWORD：root用户密码（可选，默认无密码，仅允许本地连接）
• MYSQL_CHARSET：默认字符集
• MYSQL_COLLATION：默认排序规则

MySQL配置变量

• MYSQL_LOWER_CASE_TABLE_NAMES：表名存储和比较方式（默认0）
• MYSQL_MAX_CONNECTIONS：最大客户端并发连接数（默认151）
• MYSQL_MAX_ALLOWED_PACKET：单个数据包或生成/中间字符串的最大大小（默认200M）
• MYSQL_FT_MIN_WORD_LEN：FULLTEXT索引包含的最小词长（默认4）
• MYSQL_FT_MAX_WORD_LEN：FULLTEXT索引包含的最大词长（默认20）
• MYSQL_AIO：控制innodb_use_native_aio设置（默认1，原生AIO损坏时可调整）
• MYSQL_TABLE_OPEN_CACHE：所有线程的打开表数量（默认400）
• MYSQL_KEY_BUFFER_SIZE：索引块缓冲区大小（默认32M或可用内存的10%）
• MYSQL_SORT_BUFFER_SIZE：排序使用的缓冲区大小（默认256K）
• MYSQL_READ_BUFFER_SIZE：顺序扫描使用的缓冲区大小（默认8M或可用内存的5%）
• MYSQL_INNODB_BUFFER_POOL_SIZE：InnoDB缓存表和索引数据的缓冲池大小（默认32M或可用内存的50%）
• MYSQL_INNODB_LOG_FILE_SIZE：日志组中每个日志文件的大小（默认8M或可用内存的15%）
• MYSQL_INNODB_LOG_BUFFER_SIZE：InnoDB写入磁盘日志文件的缓冲区大小（默认8M或可用内存的15%）
• MYSQL_DEFAULTS_FILE：替代配置文件路径（默认/etc/my.cnf）
• MYSQL_BINLOG_FORMAT：binlog格式（默认statement，支持row和statement）
• MYSQL_LOG_QUERIES_ENABLED：启用查询日志（默认0，设为1启用）

挂载点

通过-v /host:/container参数设置以下挂载点：

• /var/lib/mysql/data：MySQL数据目录（用于数据持久化）

注意：从主机挂载目录到容器时，需确保挂载目录具有适当权限，且目录的所有者和组与容器内运行的用户UID或名称匹配。

MariaDB自动调优

当使用--memory参数运行镜像且未指定部分配置参数时，其值将基于可用内存自动计算：

• MYSQL_KEY_BUFFER_SIZE：默认10%可用内存
• MYSQL_READ_BUFFER_SIZE：默认5%可用内存
• MYSQL_INNODB_BUFFER_POOL_SIZE：默认50%可用内存
• MYSQL_INNODB_LOG_FILE_SIZE：默认15%可用内存
• MYSQL_INNODB_LOG_BUFFER_SIZE：默认15%可用内存

MySQL root用户

root用户默认无密码，仅允许本地连接。可通过MYSQL_ROOT_PASSWORD环境变量设置密码，允许远程登录（本地连接仍无需密码）。取消设置MYSQL_ROOT_PASSWORD并重启容器可禁用远程root访问。

修改密码

密码属于镜像配置的一部分，仅支持通过修改MYSQL_PASSWORD（普通用户）和MYSQL_ROOT_PASSWORD（root用户）环境变量来更改密码。通过SQL语句或其他方式修改密码会导致环境变量值与实际密码不匹配，容器启动时将重置为环境变量中的值。

默认配置文件

可通过MYSQL_DEFAULTS_FILE环境变量指定替代配置文件路径（默认/etc/my.cnf）。例如，设置MYSQL_DEFAULTS_FILE=/etc/mysql/my.cnf可使用自定义配置文件。

扩展镜像

可通过OpenShift的Source构建策略或独立的source-to-image工具扩展镜像（以下示例基于rhscl/mariadb-103-rhel7镜像，对应OpenShift中的mariadb:10.3镜像流标签）。

示例：构建自定义镜像

通过OpenShift构建：

$ oc new-app mariadb:10.3~[***] \
    --name my-mariadb-rhel7 \
    --context-dir=examples/extend-image \
    --env MYSQL_OPERATIONS_USER=opuser \
    --env MYSQL_OPERATIONS_PASSWORD=oppass \
    --env MYSQL_DATABASE=opdb \
    --env MYSQL_USER=user \
    --env MYSQL_PASSWORD=pass

通过s2i构建：

$ s2i build --context-dir=examples/extend-image [***] rhscl/mariadb-103-rhel7 my-mariadb-rhel7

扩展目录结构

构建时可提供以下目录来自定义镜像：

• mysql-cfg/：存放mysqld配置文件，启动时会执行envsubst以支持环境变量替换
• mysql-pre-init/：存放启动mysqld前执行的Shell脚本（*.sh）
• mysql-init/：存放mysqld本地启动后执行的Shell脚本（*.sh），可使用${mysql_flags}连接本地数据库（如mysql $mysql_flags < dump.sql）

可用变量

脚本中可使用以下变量：

• $mysql_flags：连接本地mysqld的参数
• $MYSQL_RUNNING_AS_MASTER：使用run-mysqld-master命令启动时定义
• $MYSQL_RUNNING_AS_SLAVE：使用run-mysqld-slave命令启动时定义
• $MYSQL_DATADIR_FIRST_INIT：数据目录首次初始化为空时定义

注：启动容器时，可通过-v ./image-configuration/:/opt/app-root/src/挂载本地目录，覆盖镜像内置的自定义配置。

使用SSL加密连接

通过扩展镜像功能配置SSL：

1. 创建SSL证书目录（如sslapp/mysql-certs/），放置证书文件（server-cert-selfsigned.pem、server-key.pem）
2. 在mysql-cfg/中创建配置文件（如ssl.cnf）：

   [mysqld]
   ssl-key=${APP_DATA}/mysql-certs/server-key.pem
   ssl-cert=${APP_DATA}/mysql-certs/server-cert-selfsigned.pem
   

3. 挂载目录（-v ./sslapp:/opt/app-root/src/）或通过s2i构建新镜像。

升级与数据目录版本检查

MariaDB版本格式为X.Y.Z，Z部分变化时数据格式兼容，无需特殊升级；X.Y到X.Y+1需手动升级（参考官方文档），不支持跳过版本或降级（仅允许从5.5升级到10.0）。

升级建议

• 升级前备份数据
• 安全方式：通过mysqldump或mysqldbexport导出数据，导入新初始化的数据库
• 原地升级：启动新版本mysqld后运行mysql_upgrade（仅支持前一版本升级）

数据目录操作变量

通过MYSQL_DATADIR_ACTION变量控制数据目录检查行为（多值用逗号分隔，按顺序执行）：

• upgrade-warn（默认）：数据版本不匹配时警告，首次启动创建mysql_upgrade_info文件
• upgrade-auto：数据为前一版本时自动运行mysql_upgrade，其他版本警告
• upgrade-force：无论数据版本，强制运行mysql_upgrade --force
• optimize：运行mysqlcheck --optimize优化所有表
• analyze：运行mysqlcheck --analyze分析所有表
• disable：不执行数据目录版本检查

修改复制binlog格式

通过MYSQL_BINLOG_FORMAT环境变量设置binlog格式（默认statement，支持row）。例如，设置MYSQL_BINLOG_FORMAT=row后，以run-mysqld-master启动主库时，binlog将记录行数据变更而非SQL语句。

故障排除

mysqld守护进程日志输出到标准输出，可通过以下命令查看容器日志：

podman logs <容器名称或ID>

参见

本容器镜像的Dockerfile及源码可在GitHub仓库获取。仓库中，CentOS的Dockerfile名为Dockerfile，RHEL7为Dockerfile.rhel7，RHEL8为Dockerfile.rhel8，Fedora为Dockerfile.fedora。