coderat/docker-pg_backup

docker-pg_backup镜像说明

镜像概述

本镜像基于PostgreSQL官方Wiki的pg_backup_rotated.sh脚本构建，实现PostgreSQL数据库的自动化备份与备份生命周期管理。通过Cron定时任务执行每日备份，并支持按配置保留不同周期的备份文件，适用于各类PostgreSQL环境的日常备份需求。

核心功能

• 定时备份：通过环境变量配置每日备份的时间（分钟、小时）。
• 多种备份格式：支持Plain（压缩SQL）、Custom（PostgreSQL自定义格式）、Globals（集群全局配置如用户/密码）三种备份类型。
• 备份旋转：可设置每日备份保留天数、每周备份保留周数及每周备份的生成日期。
• Schema-only备份：指定数据库名称匹配规则，仅备份符合规则的数据库Schema（不含数据）。
• 安全配置：支持通过密码文件（如Docker Secrets）传递数据库密码，避免明文暴露。

使用场景

• 生产环境PostgreSQL数据库的日常自动备份。
• 需要自动管理备份生命周期（自动清理过期备份）的场景。
• 多环境（开发/测试/生产）数据库备份的统一部署与管理。

配置说明

环境变量

卷挂载

• /backups：备份文件存储目录（必须挂载）。
• /etc/localtime：可选，只读挂载主机时区文件，使Cron使用主机时区。

部署示例

Docker Run命令

bash
docker run -d \
  --name pg_backup \
  -e POSTGRES_HOSTNAME=postgres-server \
  -e POSTGRES_USER=postgres \
  -e POSTGRES_PASSWORD=your_secure_password \
  -e CRON_RUN_HOUR=2 \
  -e CRON_RUN_MINUTE=0 \
  -v /opt/pg_backups:/backups \
  -v /etc/localtime:/etc/localtime:ro \
  coderat/docker-pg_backup

Docker Compose示例

yaml
version: '3'
services:
  pg_backup:
    image: coderat/docker-pg_backup
    environment:
      POSTGRES_HOSTNAME: postgres
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD_FILE: /run/secrets/db_password
      CRON_RUN_HOUR: 3
      CRON_RUN_MINUTE: 30
      WEEKS_TO_KEEP: 4
    volumes:
      - ./backups:/backups
      - /etc/localtime:/etc/localtime:ro
    secrets:
      - db_password
secrets:
  db_password:
    file: ./db_password.txt