clouddrove/minio-mongo-bkp

minback-mongo

镜像概述

minback-mongo 是一个专为 MongoDB 设计的轻量级备份容器。它提供了一种极其简单的方式来执行 mongodump 命令，并将生成的备份结果直接上传至 https://minio.io/ 对象存储实例。该镜像主要设计用于与 https://kubernetes.io/docs/concepts/workloads/controllers/cron-jobs/ 结合使用，从而以极低的维护成本实现对关键数据的频繁自动化备份。

核心功能与特性

• 定向备份：支持将单个 MongoDB 数据库转储并上传至 S3 兼容的存储桶（如 MinIO）。
• 轻量高效：镜像体积小，采用短生命周期设计，执行完毕即退出，不占用多余系统资源。
• 简单透明：底层实现简单且代码可读性高，易于排查问题和进行二次开发。
• 安全加密：支持使用 OpenSSL 对称密钥对归档文件进行可选加密，保障备份数据安全。

使用场景与适用范围

• Kubernetes 定时备份：作为 K8s CronJob 的任务负载，实现云原生环境下的 MongoDB 定时自动化备份。
• 对象存储归档：适用于需要将 MongoDB 数据定期归档至 MinIO 或 AWS S3 等对象存储服务的场景。
• 轻量级运维：适合追求无状态、短生命周期备份任务的微服务架构和 DevOps 流程。

使用方法

基本语法

bash
DB_NAME [OPTIONS...]

• DB_NAME：需要备份的 MongoDB 数据库名称。
• OPTIONS：需要传递给 mongodump 命令的任何附加参数（如 -h 指定主机，-u 指定用户名等）。

环境变量配置

该容器完全通过环境变量进行配置，使其能够轻松集成到 Kubernetes 的配置管理框架（如 ConfigMap 和 Secret）中。

部署示例

1. Docker CLI 运行示例

创建一个名为 backup.env 的环境变量文件：

env
MINIO_SERVER=https://play.minio.io/
MINIO_ACCESS_KEY=minio
MINIO_SECRET_KEY=miniosecret
MINIO_BUCKET=backups

执行备份命令（备份 my_db 数据库，连接到 mongoserver1）：

bash
docker run --rm --env-file backup.env docker.xuanyuan.run/minback/mongo my_db -h mongoserver1

2. Docker Compose 示例

适用于本地测试或结合宿主机 crontab 进行简单的定时任务调度：

yaml
version: '3.8'
services:
  mongo-backup:
    image: docker.xuanyuan.run/minback/mongo
    command: ["my_db", "-h", "mongoserver1"]
    environment:
      - MINIO_SERVER=https://play.minio.io/
      - MINIO_ACCESS_KEY=minio
      - MINIO_SECRET_KEY=miniosecret
      - MINIO_BUCKET=backups
      - DATE_FORMAT=+%Y-%m-%d_%H-%M
    restart: "no"

3. Kubernetes CronJob 示例

在生产环境中，推荐将其配置为 Kubernetes CronJob 以实现每日自动备份：

yaml
apiVersion: batch/v1
kind: CronJob
metadata:
  name: mongodb-backup
spec:
  schedule: "0 2 * * *" # 每天凌晨 2 点执行
  jobTemplate:
    spec:
      template:
        spec:
          containers:
          - name: mongo-backup
            image: minback/mongo
            args: ["my_db", "-h", "mongo-service.default.svc.cluster.local"]
            env:
            - name: MINIO_SERVER
              value: "[***]"
            - name: MINIO_ACCESS_KEY
              valueFrom:
                secretKeyRef:
                  name: minio-credentials
                  key: accesskey
            - name: MINIO_SECRET_KEY
              valueFrom:
                secretKeyRef:
                  name: minio-credentials
                  key: secretkey
            - name: MINIO_BUCKET
              value: "mongo-backups"
            - name: ENCRYPTION_KEY
              valueFrom:
                secretKeyRef:
                  name: backup-encryption
                  key: key
          restartPolicy: OnFailure