MariaDB Docker镜像文档

镜像概述与主要用途

概述

本镜像基于CentOS7构建，提供MariaDB数据库服务。其构建参考了Stephen Tweedie的MariaDB Dockerfile，旨在通过容器化方式快速部署MariaDB环境。

重要提示

该镜像已过时（Deprecated），官方推荐使用替代镜像：centos/mariadb-101-centos7。建议现有用户迁移至推荐镜像以获取更好的兼容性和安全性支持。

主要用途

适用于开发或测试环境中快速搭建MariaDB数据库服务，不推荐用于生产环境。

核心功能与特性

• 基础环境：基于CentOS7系统构建，兼容CentOS7依赖生态。
• 数据持久化：支持通过数据卷（Volume）分离存储/var/lib/mysql目录，避免容器更新导致数据丢失（推荐生产环境使用）。
• 环境变量配置：可通过环境变量灵活配置数据库参数，包括root密码、额外数据库、用户、字符集及排序规则等。

使用场景与适用范围

适用场景

• 开发环境：快速部署独立的MariaDB实例，用于本地开发调试。
• 测试环境：临时搭建数据库服务，验证应用与数据库的交互逻辑。

不适用场景

• 生产环境：该镜像已过时，存在潜在稳定性和安全性风险，建议迁移至官方推荐的centos/mariadb-101-centos7镜像。

使用方法与配置说明

前提条件

• 已安装Docker引擎（推荐版本≥1.13.0），可通过docker version命令验证。

1. 构建镜像

从源码构建镜像（需先获取Dockerfile）：

docker build --rm --tag <yourname>/mariadb55 .

构建完成后，通过docker images命令确认镜像存在。

2. 启动容器

2.1 快速启动（不推荐生产环境）

直接启动容器，数据存储于容器内部（容器删除后数据丢失）：

docker run --name=mariadb -d -p 3306:3306 -e MYSQL_ROOT_PASSWORD=<password> <yourname>/mariadb55

• --name=mariadb：指定容器名称为mariadb。
• -d：后台运行容器。
• -p 3306:3306：映射容器3306端口至主机3306端口（主机端口可自定义）。
• -e MYSQL_ROOT_PASSWORD=<password>：设置MariaDB root用户密码（必填）。

2.2 推荐启动（数据卷持久化）

通过数据卷容器分离存储数据，确保容器更新或删除后数据不丢失。

步骤1：创建数据卷容器

数据卷容器仅用于挂载数据卷，无需运行：

docker run --name=mariadb-data -v /var/lib/mysql <yourname>/mariadb55 true

• --name=mariadb-data：指定数据卷容器名称。
• -v /var/lib/mysql：将容器内/var/lib/mysql目录定义为数据卷（持久化存储数据库文件）。

步骤2：启动MariaDB容器（挂载数据卷）

docker run --name=mariadb -d -p 3306:3306 \
  --volumes-from=mariadb-data \  # 挂载数据卷容器中的数据卷
  -e MYSQL_ROOT_PASSWORD=<password> \  # 必选：设置root密码
  [ -e MYSQL_DATABASE=<dbname> ] \  # 可选：创建额外数据库
  [ -e MYSQL_USER=<username> ] \  # 可选：创建额外用户（需配合MYSQL_PASSWORD使用，原文未提及，建议补充密码变量）
  [ -e MYSQL_CHARSET=<charset> ] \  # 可选：指定数据库字符集（如utf8mb4）
  [ -e MYSQL_COLLATION=<collation> ] \  # 可选：指定数据库排序规则（如utf8mb4_general_ci）
  <yourname>/mariadb55

3. 环境变量说明

4. 连接与使用数据库

4.1 连接数据库

通过mysql客户端工具连接容器内MariaDB（需确保主机3306端口已映射）：

mysql --protocol=tcp -u root -p<password>

• -u root：使用root用户登录（或指定MYSQL_USER创建的用户）。
• -p<password>：指定密码（-p与密码间无空格）。

4.2 修改初始密码

建议首次登录后修改root密码（若通过MYSQL_ROOT_PASSWORD设置了自定义密码，可跳过此步骤）：

mysqladmin --protocol=tcp -u root -p<old_password> password <new_password>

4.3 示例：创建数据库表

登录数据库后，可执行标准SQL命令操作，例如创建测试表：

CREATE TABLE test (
  name VARCHAR(10),
  owner VARCHAR(10),
  species VARCHAR(10),
  birth DATE,
  death DATE
);

注意事项

1. 已过时提醒：本镜像已不再维护，强烈建议迁移至官方推荐镜像centos/mariadb-101-centos7。
2. 数据安全：生产环境必须使用数据卷（Volume）或绑定挂载（Bind Mount）持久化数据，避免容器删除导致数据丢失。
3. 密码管理：MYSQL_ROOT_PASSWORD为必填项，请勿使用弱密码，建议通过环境变量文件或密钥管理工具注入密码，避免明文暴露。