minionscloud/mariadb Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

MariaDB-MinIO增强版Docker镜像文档

镜像概述

本镜像基于官方MariaDB镜像构建，额外集成了Minio客户端工具，提供与Minio对象存储的无缝集成能力，专注于简化数据库备份、启动配置及数据恢复流程，适用于需要可靠数据持久化与远程存储的场景。

核心功能与特性

• 原生MariaDB功能：完整继承官方MariaDB镜像的全部功能，包括数据库服务、用户管理、权限控制等
• Minio集成：内置Minio客户端（mc），支持与Minio对象存储进行数据交互
• 备份自动化：支持配置定时备份策略，自动将数据库数据备份至Minio存储
• 启动恢复机制：启动时可自动从Minio存储恢复指定备份数据
• 轻量级设计：在官方镜像基础上最小化增加体积，保持高效运行

使用场景

• 开发/测试环境：快速搭建带有自动备份能力的MariaDB服务
• 中小型生产环境：需要低成本成本实现数据远程备份与恢复的场景
• 多环境同步：通过Minio实现不同环境间的数据库数据迁移
• 数据容灾需求：通过Minio对象存储实现数据库数据的异地备份

使用方法与配置说明

基本使用（docker run）

bash
docker run -d \
  --name mariadb-minio \
  -e MYSQL_ROOT_PASSWORD=your_root_password \
  -e MINIO_ENDPOINT=minio.example.com:9000 \
  -e MINIO_ACCESS_KEY=your_access_key \
  -e MINIO_SECRET_KEY=your_secret_key \
  -e MINIO_BUCKET=db-backups \
  -p 3306:3306 \
  mariadb-minio:latest

Docker Compose配置

yaml
version: '3'
services:
  mariadb:
    image: mariadb-minio:latest
    container_name: mariadb-minio
    restart: always
    ports:
      - "3306:3306"
    environment:
      - MYSQL_ROOT_PASSWORD=your_root_password
      - MYSQL_DATABASE=your_database
      - MYSQL_USER=your_user
      - MYSQL_PASSWORD=your_password
      - MINIO_ENDPOINT=minio:9000
      - MINIO_ACCESS_KEY=minio_access_key
      - MINIO_SECRET_KEY=minio_secret_key
      - MINIO_BUCKET=db-backups
      - BACKUP_INTERVAL=24h  # 备份间隔，支持s(秒)/m(分)/h(小时)/d(天)
      - BACKUP_RETENTION=7d  # 备份保留时间
    volumes:
      - mariadb_data:/var/lib/mysql
    depends_on:
      - minio

  minio:
    image: minio/minio
    container_name: minio
    restart: always
    ports:
      - "9000:9000"
      - "9001:9001"
    environment:
      - MINIO_ROOT_USER=minio_access_key
      - MINIO_ROOT_PASSWORD=minio_secret_key
    volumes:
      - minio_data:/data
    command: server /data --console-address ":9001"

volumes:
  mariadb_data:
  minio_data:

环境变量配置说明

手动执行备份

进入容器后执行备份命令：

bash
docker exec -it mariadb-minio /usr/local/bin/backup.sh

手动执行恢复

指定备份文件进行恢复：

bash
docker exec -it mariadb-minio /usr/local/bin/restore.sh backup_20240101.sql.gz

注意事项

1. 首次使用时需确保Minio服务已正常运行且指定桶已创建
2. 备份文件默认使用gzip压缩，命名格式为backup_YYYYMMDD_HHMMSS.sql.gz
3. 恢复操作会覆盖当前数据库数据，请谨慎执行
4. 生产环境建议配合数据卷（volume）使用，确保数据持久化