qoopido/mariadb

MariaDB 容器文档

镜像概述和主要用途

本镜像是一个独立运行的MariaDB容器，专注于简化数据库管理流程。它提供自动SQL备份导入/导出功能，便于通过Git或SVN进行数据版本控制，同时支持自定义配置和启动/停止脚本，适用于开发环境和小型项目的数据库需求。

核心功能和特性

• 独立运行：无需复杂依赖，可直接部署使用
• 自动备份管理：首次运行创建初始备份，停止时自动导出最新备份，启动时自动导入现有备份
• 灵活配置：支持通过外部目录覆盖默认MariaDB配置
• 自定义脚本支持：可通过up.sh和down.sh实现启动/停止时的自定义操作
• 数据持久化：通过卷挂载确保数据和配置持久化存储

使用场景和适用范围

• 开发环境中的数据库服务
• 需要版本控制数据库结构和初始数据的项目
• 小型应用的独立数据库部署
• 需要简化数据库备份和迁移流程的场景

详细使用方法和配置说明

推荐目录结构

建议采用以下统一目录结构，以保持配置和数据的可维护性：

项目根目录
  - docker_compose.yaml  # Docker Compose配置文件
  - config               # 配置目录
    - mariadb
      - conf.d           # MariaDB配置文件目录
        - ...            # 自定义配置文件
  - data                 # 数据目录
    - mariadb
      - logs             # 日志目录
      - database         # 数据库文件目录
        - dump.sql       # SQL备份文件

Docker Compose配置示例

创建docker_compose.yaml文件，内容如下：

yaml
db:
  image: qoopido/mariadb:latest
  ports:
   - "3306:3306"  # 端口映射，主机端口:容器端口
  volumes:
   - ./config:/app/config  # 配置目录挂载
   - ./data/mariadb:/app/data  # 数据目录挂载

手动启动容器

使用以下命令手动启动容器：

bash
docker run -d -P -t -i -p 3306:3306 \
    -v [本地配置路径]:/app/config \  # 替换为本地配置目录的绝对路径
    -v [本地数据路径]:/app/data \    # 替换为本地数据目录的绝对路径
    --name db qoopido/mariadb:latest

访问凭证

• root用户：仅允许本地访问，无密码
• admin用户：用于常规访问，默认密码为fyoDBafo

数据库导入/导出机制

• 首次运行：容器会在/app/data/database目录下创建dump.sql文件（初始备份）
• 停止容器：容器停止时会自动导出最新数据到dump.sql
• 再次启动：如果dump.sql文件已存在，容器启动时会自动导入该备份

注意：对于大型数据库，需在相关命令中增加超时时间参数（默认10秒后Docker会强制终止容器），例如：

• docker-compose up -t 600
• docker stop -t 600 [容器名]
• docker-compose stop -t 600

配置说明

自定义MariaDB配置

/app/config目录下的所有文件会通过符号链接到容器内的/etc/mysql目录，可用于覆盖默认配置。例如，创建config/mariadb/conf.d/my.cnf文件来自定义数据库配置。

自定义启动/停止脚本

如需在容器启动或停止时执行自定义操作（如设置符号链接），可创建以下脚本：

• /app/config/up.sh：容器启动时执行
• /app/config/down.sh：容器停止时执行