MariaDB Docker镜像

该容器镜像包含MariaDB server 10.0，适用于OpenShift和一般用途。

环境变量和卷

初始化环境变量

镜像支持以下环境变量，可在初始化时通过-e VAR=VALUE参数传递给Docker run命令：

影响配置文件的可选环境变量

以下环境变量会影响MySQL配置文件，均为可选：

卷挂载点

可通过-v /host:/container标志设置以下挂载点：

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

使用方法

假设使用fedora/mariadb镜像。若仅设置必要环境变量且不将数据库存储在主机目录中，执行以下命令：

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

此命令会创建一个名为mariadb_database的容器，运行MySQL数据库db，用户凭据为user:pass，并暴露3306端口映射到主机。若要使数据库在容器执行间持久化，添加-v /host/db/path:/var/lib/mysql/data参数，该路径将作为MySQL数据目录。

如果数据库目录未初始化，入口脚本会先运行mysql_install_db并设置必要的数据库用户和密码。数据库初始化后（或已存在），mysqld将作为PID 1运行。可通过docker stop mariadb_database停止后台容器。

MariaDB自动调优

当使用--memory参数运行MySQL镜像且未指定某些参数时，其值会根据可用内存自动计算：

MySQL root用户

root用户默认无密码，仅允许本地连接。可通过MYSQL_ROOT_PASSWORD环境变量设置密码，允许远程登录。本地连接仍无需密码。

要禁用远程root访问，只需取消设置MYSQL_ROOT_PASSWORD并重启容器。

更改密码

数据库用户（MYSQL_USER）和root用户的密码仅支持通过环境变量MYSQL_PASSWORD和MYSQL_ROOT_PASSWORD分别更改。

通过SQL语句或其他方式更改密码会导致环境变量中存储的值与实际密码不匹配。数据库容器启动时会将密码重置为环境变量中存储的值。

默认my.cnf文件

通过环境变量可自定义多种MySQL引导配置参数。若要使用自定义配置文件，可通过MYSQL_DEFAULTS_FILE环境变量指定文件完整路径。例如，默认位置为/etc/my.cnf，可通过设置MYSQL_DEFAULTS_FILE=/etc/mysql/my.cnf更改为/etc/mysql/my.cnf。

更改复制binlog格式

某些应用（如基于变更数据捕获的应用）可能需要使用row二进制日志格式。默认复制/二进制日志格式为statement，可通过MYSQL_BINLOG_FORMAT环境变量更改。例如，设置MYSQL_BINLOG_FORMAT=row。

当以主复制模式运行数据库（即设置Docker/容器cmd为run-mysqld-master）时，二进制日志将输出更改行的实际数据，而非导致更改的语句（如数据操纵语言DML，如insert...）。