aerzas/mariadb

MariaDB

镜像概述和主要用途

MariaDB Docker容器镜像，无需特定用户或root权限即可运行，提供便捷的MariaDB数据库部署方案。

核心功能和特性

• 无特权运行：无需特定用户或root权限即可正常启动和运行
• 环境变量配置：支持通过环境变量灵活配置数据库参数及服务设置
• 配置文件模板：挂载的.tmpl格式配置文件会自动替换其中的环境变量
• 数据持久化：支持通过命名卷或本地文件夹挂载实现数据持久化存储
• 自动初始化：首次运行时，若数据库不存在，将使用环境变量自动初始化数据库（创建数据库、用户及密码）
• 健康检查：内置健康检查脚本，支持配置检查间隔、超时等参数
• TLS支持：可通过环境变量配置TLS版本及相关证书（SSL证书、密钥、CA证书）

使用场景和适用范围

• 开发环境：快速部署独立的MariaDB实例，用于应用开发和单元测试
• 测试环境：隔离的数据库环境，确保测试过程不影响其他服务
• 低权限场景：需满足容器以非root用户运行的安全合规要求
• 自定义配置需求：需要灵活调整MariaDB服务参数（如连接数、缓存大小、字符集等）的场景

使用方法和配置说明

Docker Compose配置示例

yaml
version: '3.5'
services:
    mariadb:
        image: aerzas/mariadb:11-latest
        environment:
            MYSQL_DATABASE: sampledb          # 初始化数据库名称
            MYSQL_ROOT_PASSWORD: 3x@mplE      # root用户密码
            MYSQL_USER: sampledb              # 普通用户名
            MYSQL_USER_PASSWORD: sampledb     # 普通用户密码
        ports:
            - '3306:3306'                     # 映射数据库端口
        volumes:
            - database:/var/lib/mysql         # 数据持久化卷
        healthcheck:
            test: ["CMD", "/scripts/docker-healthcheck.sh"]  # 健康检查命令
            interval: 30s                     # 检查间隔
            timeout: 1s                       # 超时时间
            retries: 3                        # 重试次数
            start_period: 30s                 # 启动等待时间
volumes:
    database:                                 # 命名卷定义

Docker Run命令示例

bash
docker run -d \
  --name mariadb \
  -e MYSQL_DATABASE=sampledb \
  -e MYSQL_ROOT_PASSWORD=3x@mplE \
  -e MYSQL_USER=sampledb \
  -e MYSQL_USER_PASSWORD=sampledb \
  -p 3306:3306 \
  -v database:/var/lib/mysql \
  --health-cmd "/scripts/docker-healthcheck.sh" \
  --health-interval 30s \
  --health-timeout 1s \
  --health-retries 3 \
  --health-start-period 30s \
  aerzas/mariadb:11-latest

数据持久化

数据库数据默认存储在容器内/var/lib/mysql目录，可通过以下方式实现持久化：

• 命名卷：如示例中定义database卷，由Docker管理存储路径
• 本地文件夹挂载：使用-v /path/on/host:/var/lib/mysql挂载主机目录（需确保目录权限正确）

额外配置文件

可将自定义配置文件挂载到/etc/mysql/my.cnf.d/目录，补充或覆盖默认配置：

• 普通配置文件（如custom.cnf）将直接生效
• .tmpl格式文件（如custom.cnf.tmpl）会自动替换其中的环境变量后生效

数据库初始化

首次运行时，若/var/lib/mysql目录为空（无数据库），将执行以下初始化操作：

1. 使用MYSQL_DATABASE创建指定名称的数据库
2. 使用MYSQL_ROOT_PASSWORD设置root用户密码（未提供时自动生成随机密码）
3. 使用MYSQL_USER和MYSQL_USER_PASSWORD创建普通用户，并授予该用户对MYSQL_DATABASE的全部权限

环境变量

client

database

mariadb

mysqld

mysqldump