MariaDB Docker镜像文档

镜像概述

本镜像是基于CentOS7构建的MariaDB容器化解决方案，用于简化MariaDB数据库的部署与管理。通过Docker容器化技术，实现MariaDB服务的快速启动、配置与扩展，同时支持数据持久化存储，确保数据库内容在镜像更新时不丢失。

核心功能与特性

• 数据持久化：支持通过数据卷容器分离存储目录/var/lib/mysql，实现数据与应用分离，便于镜像更新与维护
• 灵活配置：通过环境变量自定义数据库参数，包括：
  • 数据库root密码（MYSQL_ROOT_PASSWORD）
  • 初始化数据库（MYSQL_DATABASE）
  • 额外数据库用户（MYSQL_USER）
  • 数据库字符集（MYSQL_CHARSET）
  • 数据库排序规则（MYSQL_COLLATION）
• 环境适应性：兼容开发环境快速部署与生产环境稳定运行需求
• 简化部署：提供标准化启动流程，支持一键构建与启动

使用场景

• 开发环境：快速搭建独立的MariaDB测试环境，避免本地环境配置冲突
• 生产环境：通过数据卷持久化确保数据安全，配合环境变量配置实现个性化部署
• CI/CD流程：作为自动化测试中的数据库服务组件，实现环境一致性

使用方法

前提条件

确保已安装Docker环境，可通过以下命令检查Docker版本：

bash
# docker version

镜像构建

1. 克隆或获取Dockerfile后，执行构建命令：

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

2. 验证镜像构建结果：

bash
# docker images

启动MariaDB服务

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

直接启动容器，将数据库存储于容器内部（镜像更新时数据会丢失）：

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

推荐启动（生产环境）

通过数据卷容器分离存储目录，实现数据持久化：

1. 创建数据卷容器（仅用于引用数据卷，无需运行）：

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

2. 启动MariaDB服务容器（关联数据卷容器）：

bash
# docker run --name=mariadb -d -p 3306:3306 --volumes-from=mariadb-data -e MYSQL_ROOT_PASSWORD=<password> <yourname>/mariadb55

环境变量配置

启动容器时可通过以下环境变量自定义数据库配置：

示例：创建名为testdb的数据库，用户testuser，字符集utf8mb4：

bash
# docker run --name=mariadb -d -p 3306:3306 --volumes-from=mariadb-data -e MYSQL_ROOT_PASSWORD=<password> -e MYSQL_DATABASE=testdb -e MYSQL_USER=testuser -e MYSQL_CHARSET=utf8mb4 <yourname>/mariadb55

数据库使用

连接数据库

通过mysql客户端连接容器内的MariaDB服务：

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

修改初始密码

若未通过环境变量设置密码，初始默认密码为mysqlPassword，建议启动后立即修改：

bash
# mysqladmin --protocol=tcp -u root -pmysqlPassword password <new_password>

数据库操作示例

创建测试表：

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