rsprta/mariadb-backup

rsprta/mariadb-backup ![Pipeline status]([***]

快速参考

• 维护者：Radek Sprta
• 获取帮助：仓库Issues

镜像概述

该容器旨在使用mysqldump工具对MariaDB数据库进行备份，提供定时备份功能，可灵活配置连接参数和存储路径。

核心功能和特性

• 基于mysqldump实现MariaDB数据库备份
• 支持通过CRON表达式配置定时备份策略
• 可自定义数据库连接参数（主机、端口、用户、密码）
• 备份文件存储在挂载卷中，确保数据持久化
• 轻量级设计，易于集成到现有Docker环境

使用场景和适用范围

适用于需要定期备份MariaDB数据库的场景，包括但不限于：

• 生产环境数据库定时备份
• 开发/测试环境数据保护
• 与Docker化MariaDB服务配合使用的备份方案
• 需要自动化数据库备份流程的系统

使用方法和配置说明

Docker Compose配置示例

以下示例假设MariaDB容器名为mariadb，并运行在同名网络中：

yaml
version: '2'
services:
  backup:
    container_name: mariadb-backup
    image: registry.gitlab.com/radek-sprta/docker-mariadb-backup
    environment:
      - CRON_TIMER=@daily  # 备份频率
      - MARIADB_HOST=mariadb  # 数据库主机
      - MARIADB_PASSWORD=secret  # 数据库密码
      - MARIADB_PORT=3306  # 数据库端口
      - MARIADB_USER=root  # 备份用户
    volumes:
      - "/var/lib/backup:/backup"  # 备份文件存储路径
    networks:
      - database  # 连接到数据库网络
    restart: unless-stopped  # 自动重启策略
networks:
  database:
    external:
      name: mariadb  # 使用外部网络

环境变量配置说明

容器运行需配置以下环境变量：

CRON_TIMER

• 描述：备份执行频率
• 格式：cron时间表达式（如0 3 * * *表示每天凌晨3点）
• 默认值：@daily（每天执行一次）
• 示例：0 5 * * 0（每周日凌晨5点执行）

MARIADB_HOST

• 描述：MariaDB数据库主机地址
• 格式：主机名或IP地址
• 必需：是

MARIADB_PASSWORD

• 描述：备份用户的密码
• 格式：字符串
• 必需：是

MARIADB_PORT

• 描述：MariaDB数据库端口
• 格式：整数
• 默认值：3306
• 必需：否

MARIADB_USER

• 描述：执行备份的数据库用户
• 要求：需具备数据库备份权限（如SELECT、LOCK TABLES等）
• 必需：是

贡献

有关项目贡献方式，请参考贡献者指南。

联系方式

• ---

• incoming+radek-sprta/***

许可证

GNU General Public License v3

致谢

本项目使用https://github.com/audreyr/cookiecutter构建。