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

镜像概述

该容器镜像包含MariaDB 10.1 SQL数据库服务器，适用于OpenShift和通用使用场景。用户可选择基于RHEL或CentOS的镜像版本：

• RHEL版本：可从Red Hat Container Catalog获取，镜像名为registry.access.redhat.com/rhscl/mariadb-101-rhel7
• CentOS版本：可从Docker Hub获取，镜像名为centos/mariadb-101-centos7

核心功能与特性

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

使用场景

适用于需要部署MariaDB 10.1数据库服务器的场景，包括开发、测试和生产环境，支持OpenShift平台及通用Docker环境，满足中小型应用的数据库服务需求。

使用方法

以下示例基于Red Hat Container Catalog的MariaDB 10.1镜像rhscl/mariadb-101-rhel7。

基本运行示例

若仅设置必要环境变量且不使用主机目录存储数据库，执行以下命令：

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

此命令将创建名为mariadb_database的容器，运行MySQL数据库db，用户凭据为user:pass，并映射主机3306端口到容器。

持久化数据目录

若需数据库在容器重启后持久化，添加-v /host/db/path:/var/lib/mysql/data参数（/host/db/path为主机目录）：

$ docker run -d --name mariadb_database -e MYSQL_USER=user -e MYSQL_PASSWORD=pass -e MYSQL_DATABASE=db -v /host/db/path:/var/lib/mysql/data -p 3306:3306 rhscl/mariadb-101-rhel7

说明：首次运行时，若数据目录未初始化，入口脚本将执行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_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
• 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：二进制日志格式，支持row和statement，默认statement
• MYSQL_LOG_QUERIES_ENABLED：启用查询日志，设为1启用，默认0

卷挂载点

通过-v /host:/container挂载以下目录：

• /var/lib/mysql/data：MySQL数据目录

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

MariaDB自动调优

当容器使用--memory参数指定内存且未手动设置部分参数时，其值将基于可用内存自动计算：

• MYSQL_KEY_BUFFER_SIZE：默认可用内存的10%（key_buffer_size）
• MYSQL_READ_BUFFER_SIZE：默认可用内存的5%（read_buffer_size）
• MYSQL_INNODB_BUFFER_POOL_SIZE：默认可用内存的50%（innodb_buffer_pool_size）
• MYSQL_INNODB_LOG_FILE_SIZE：默认可用内存的15%（innodb_log_file_size）
• MYSQL_INNODB_LOG_BUFFER_SIZE：默认可用内存的15%（innodb_log_buffer_size）

MySQL root用户

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

更改密码

数据库用户（MYSQL_USER）和root用户的密码仅支持通过环境变量MYSQL_PASSWORD和MYSQL_ROOT_PASSWORD修改。通过SQL语句或其他方式修改会导致环境变量与实际密码不匹配，容器重启后将重置为环境变量值。

默认配置文件

默认配置文件路径为/etc/my.cnf，可通过MYSQL_DEFAULTS_FILE环境变量指定替代配置文件，如MYSQL_DEFAULTS_FILE=/etc/mysql/my.cnf。

扩展镜像

使用s2i构建自定义镜像

通过source-to-image扩展镜像，示例命令：

$ s2i build ~/image-configuration/ rhscl/mariadb-101-rhel7 my-mariadb-rhel7

自定义目录结构

构建目录可包含以下子目录，文件将复制到镜像的/opt/app-root/src：

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

脚本可用变量

• $mysql_flags：连接本地mysqld的mysql工具参数
• $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安全连接

1. 创建SSL证书目录（如sslapp/mysql-certs/），存放证书：

   • server-cert-selfsigned.pem（服务器证书）
   • server-key.pem（服务器密钥）

2. 在mysql-cfg/中添加SSL配置文件（如ssl.cnf）：

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

3. 通过-v挂载目录或s2i构建新镜像应用配置。

升级与数据目录版本检查

版本兼容性

• Z版本升级（如5.6.23→5.6.24）：数据格式兼容，无需特殊步骤
• Y版本升级（如10.0→10.1）：需手动升级，参考官方文档
• 不支持：跨版本升级（如10.0→10.2）或降级，例外：MariaDB 5.5→10.0

升级方式

1. 数据导出导入：mysqldump/mysqldbexport导出，新数据库导入
2. 原地升级：启动新版本mysqld后执行mysql_upgrade，仅支持前一版本升级

数据目录操作控制

通过MYSQL_DATADIR_ACTION变量控制升级行为（多值用逗号分隔）：

• upgrade-warn（默认）：版本不匹配时警告，首次初始化创建版本文件
• upgrade-auto：仅前一版本数据自动执行mysql_upgrade，其他版本警告
• upgrade-force：强制执行mysql_upgrade --force，无视版本
• optimize：执行mysqlcheck --optimize优化表
• analyze：执行mysqlcheck --analyze分析表
• disable：不执行版本检查相关操作

故障排除

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

docker logs <container>

参见

镜像Dockerfile及源码：[***]