tcousin/duplicity-with-prometheus-metrics Docker Image Overview

tcousin/duplicity-with-prometheus-metrics

定期运行Duplicity备份并提供Prometheus指标的Docker镜像，支持备份任务的周期性执行与监控，目前仍处于测试阶段。

0 次下载activetcousin镜像

🚀专业版镜像服务，面向生产环境设计

中文简介版本下载

🚀专业版镜像服务，面向生产环境设计

Periodic Duplicity with Prometheus Metrics

镜像概述

本Docker镜像旨在定期执行Duplicity备份任务，并集成Prometheus指标暴露功能，便于监控备份任务的执行状态与结果。镜像封装了Duplicity备份工具与周期调度能力，同时提供标准化监控指标，适用于需要自动化备份且关注任务可观测性的场景。注意：当前镜像仍处于测试阶段，不建议直接用于生产环境。

核心功能与特性

定期备份调度：通过cron表达式自定义备份周期（如每日、每周），支持灵活配置执行频率
Prometheus指标集成：暴露备份成功率、执行耗时、文件处理数等关键指标，支持Prometheus抓取与监控告警
Duplicity原生兼容：完整支持Duplicity的备份特性（如增量备份、加密、压缩、多目标存储等）
轻量级设计：基于Alpine基础镜像构建，减少资源占用，适合边缘环境与容器化部署
配置灵活性：通过环境变量或挂载配置文件自定义备份参数，无需修改镜像本身

使用场景与适用范围

服务器数据定期备份（如应用数据、日志文件、配置文件等）
需监控备份状态的业务场景（如***、***等对数据可靠性要求高的领域）
容器化环境中对持久化数据的自动化备份（如Kubernetes集群内应用数据备份）
需构建备份监控看板的场景（配合Prometheus+Grafana实现可视化监控）

使用方法与配置说明

基本部署示例（docker run）

bash
docker run -d \
  --name periodic-duplicity \
  -p 9090:9090 \  # Prometheus指标端口
  -e BACKUP_SOURCE="/data/source" \  # 待备份数据路径（容器内）
  -e BACKUP_TARGET="s3://my-backup-bucket/data" \  # 备份目标路径（支持Duplicity兼容协议）
  -e CRON_SCHEDULE="0 3 * * *" \  # 每日凌晨3点执行备份
  -e DUPLICITY_OPTIONS="--full-if-older-than 7D --encrypt-key ABC123" \  # Duplicity额外参数（如加密密钥、完整备份周期）
  -v /host/data:/data/source:ro \  # 挂载宿主机数据到容器内备份源路径
  -v /host/gnupg:/root/.gnupg:ro \  # 挂载GnuPG密钥目录（用于加密备份）
  -v /host/backup-config:/etc/backup:ro \  # 可选：挂载自定义配置文件
  periodic-duplicity-prometheus:latest

核心环境变量配置

环境变量名	说明	默认值	是否必填
`BACKUP_SOURCE`	容器内待备份数据的绝对路径	-	是
`BACKUP_TARGET`	备份目标路径（支持`file://`/`s3://`/`ftp://`等Duplicity兼容协议）	-	是
`CRON_SCHEDULE`	cron表达式，定义备份执行周期（如`0 /6 * *`表示每6小时执行一次）	-	是
`PROMETHEUS_PORT`	Prometheus指标暴露端口	9090	否
`METRICS_PATH`	Prometheus指标接口路径	`/metrics`	否
`DUPLICITY_OPTIONS`	传递给Duplicity命令的额外参数（如`--compress --exclude *.log`）	空	否
`LOG_LEVEL`	日志输出级别（支持`debug`/`info`/`warn`/`error`）	`info`	否
`BACKUP_PRE_HOOK`	备份执行前的自定义命令（如数据预处理脚本路径）	空	否
`BACKUP_POST_HOOK`	备份执行后的自定义命令（如清理临时文件脚本路径）	空	否

Prometheus指标说明

镜像默认在PROMETHEUS_PORT端口的METRICS_PATH路径暴露以下指标，可配置Prometheus抓取规则进行监控：

指标名称	类型	说明
`backup_job_success`	Gauge	最近一次备份任务执行结果（1=成功，0=失败，-1=未执行过）
`backup_job_duration_seconds`	Gauge	最近一次备份任务执行耗时（秒）
`backup_files_processed`	Gauge	最近一次备份处理的文件总数
`backup_last_run_timestamp`	Gauge	最近一次备份任务开始执行的Unix时间戳
`backup_total_runs`	Counter	自容器启动以来的备份任务总执行次数

注意事项

测试阶段提示：镜像仍处于测试阶段，建议先在非生产环境验证功能完整性与稳定性
敏感信息管理：备份目标的访问密钥（如S3密钥）、GnuPG加密密钥等敏感信息，建议通过环境变量或挂载文件传递，避免直接嵌入镜像
存储权限配置：确保备份源路径（宿主机挂载目录）有读权限，目标存储（如S3桶、FTP服务器）有写权限
备份验证：首次部署后建议手动触发一次备份（可通过docker exec执行/usr/local/bin/run-backup.sh），验证配置有效性与目标可用性