appexpress/pg-dump

PostgreSQL数据库备份至S3存储桶Docker镜像

镜像概述

本Docker镜像旨在提供一种简单高效的解决方案，用于自动对PostgreSQL数据库进行归档备份，并将备份文件上传至Amazon S3或S3兼容存储服务。通过容器化部署，可快速集成到现有环境，实现数据库备份的自动化与远程存储，提升数据安全性和灾难恢复能力。

核心功能与特性

• 自动化备份：支持通过cron表达式配置定时备份任务，无需手动执行
• 完整归档：使用pg_dump工具创建PostgreSQL数据库的完整备份，确保数据完整性
• S3集成：原生支持将备份文件上传至Amazon S3或兼容S3协议的存储服务
• 灵活配置：通过环境变量自定义备份参数、数据库连接信息和S3存储配置
• 轻量级：基于Alpine Linux构建，镜像体积小，资源占用低

使用场景与适用范围

• 生产环境数据库备份：定期备份关键业务数据，防止数据丢失
• 开发/测试环境：快速创建数据快照，支持环境恢复和版本控制
• 多环境部署：统一备份策略，适用于本地、云服务器等多种部署环境
• 数据迁移：通过S3存储实现不同环境间的数据库迁移

使用方法与配置说明

环境变量配置

Docker Run部署示例

立即执行一次备份并上传

bash
docker run -e POSTGRES_HOST=postgres -e POSTGRES_PORT=5432 -e POSTGRES_DB=mydb \
  -e POSTGRES_USER=admin -e POSTGRES_PASSWORD=password \
  -e S3_BUCKET=my-backups -e AWS_ACCESS_KEY_ID=AKIAEXAMPLE \
  -e AWS_SECRET_ACCESS_KEY=secret -e AWS_REGION=us-east-1 \
  postgres-s3-backup

配置定时备份（每天凌晨2点执行）

bash
docker run -d --name postgres-backup -e POSTGRES_HOST=postgres \
  -e POSTGRES_DB=mydb -e POSTGRES_USER=admin -e POSTGRES_PASSWORD=password \
  -e S3_BUCKET=my-backups -e AWS_ACCESS_KEY_ID=AKIAEXAMPLE \
  -e AWS_SECRET_ACCESS_KEY=secret -e CRON_SCHEDULE="0 2 * * *" \
  postgres-s3-backup

使用S3兼容存储（如MinIO）

bash
docker run -e POSTGRES_HOST=postgres -e POSTGRES_DB=mydb \
  -e POSTGRES_USER=admin -e POSTGRES_PASSWORD=password \
  -e S3_BUCKET=my-backups -e AWS_ACCESS_KEY_ID=minioadmin \
  -e AWS_SECRET_ACCESS_KEY=minioadmin -e S3_ENDPOINT=http://minio:9000 \
  postgres-s3-backup

Docker Compose配置示例

yaml
version: '3'

services:
  postgres-backup:
    image: postgres-s3-backup
    environment:
      POSTGRES_HOST: postgres
      POSTGRES_PORT: 5432
      POSTGRES_DB: mydatabase
      POSTGRES_USER: backupuser
      POSTGRES_PASSWORD: securepassword
      S3_BUCKET: my-company-backups
      AWS_ACCESS_KEY_ID: AKIAEXAMPLEKEY
      AWS_SECRET_ACCESS_KEY: exampleSecretKey123
      AWS_REGION: eu-west-1
      BACKUP_FILENAME: postgres_backup_%Y%m%d.sql.gz
      CRON_SCHEDULE: "0 */6 * * *"  # 每6小时执行一次
    restart: always

注意事项

• 确保PostgreSQL数据库允许从容器所在网络访问（检查防火墙和pg_hba.conf配置）
• S3访问密钥需具备存储桶的写入权限（推荐配置最小权限策略）
• 备份文件默认使用gzip压缩以减少存储空间占用
• 定时任务依赖容器内的cron服务，需确保容器持续运行（建议配置restart: always）