arenstar/postgres-backup-s3

postgres-backup-s3

镜像概述

本镜像提供PostgreSQL数据库到S3存储的备份功能，支持定期自动备份，帮助用户轻松实现数据库数据的安全存储与自动化管理，降低数据丢失风险。

核心功能

1. 将PostgreSQL数据库备份文件上传至S3存储桶
2. 通过SCHEDULE环境变量设置定期自动备份
3. 可配置额外的PostgreSQL备份参数（如指定schema、包含blobs数据等）

使用场景

1. 个人或企业用户需要定期备份PostgreSQL数据库的场景
2. 希望将数据库备份存储到S3云存储以确保数据安全的场景
3. 需自动化数据库备份流程、减少手动操作的场景

配置说明

环境变量

• S3相关：
  • S3_ACCESS_KEY_ID：S3访问密钥ID
  • S3_SECRET_ACCESS_KEY：S3秘密访问密钥
  • S3_BUCKET：目标S3存储桶名称
  • S3_REGION：S3存储桶所在区域（可选）
  • S3_PREFIX：备份文件在存储桶中的路径前缀（可选）
• PostgreSQL相关：
  • POSTGRES_DATABASE：需备份的数据库名称
  • POSTGRES_USER：数据库用户名
  • POSTGRES_PASSWORD：数据库密码
  • POSTGRES_HOST：数据库主机地址
  • POSTGRES_EXTRA_OPTS：额外的pg_dump参数（如--schema=public --blobs）
• 定期备份：
  • SCHEDULE：定期备份的时间计划（如@daily表示每日备份）

部署示例

Docker命令

sh
docker run -e S3_ACCESS_KEY_ID=your_key -e S3_SECRET_ACCESS_KEY=your_secret -e S3_BUCKET=your_bucket -e S3_PREFIX=backup -e POSTGRES_DATABASE=dbname -e POSTGRES_USER=user -e POSTGRES_PASSWORD=password -e POSTGRES_HOST=localhost arenstar/postgres-backup-s3

Docker Compose配置

yaml
version: '3'
services:
  postgres:
    image: postgres
    environment:
      POSTGRES_USER: user
      POSTGRES_PASSWORD: password

  pgbackups3:
    image: arenstar/postgres-backup-s3
    links:
      - postgres
    environment:
      SCHEDULE: '@daily'
      S3_REGION: your_region
      S3_ACCESS_KEY_ID: your_key
      S3_SECRET_ACCESS_KEY: your_secret
      S3_BUCKET: your_bucket
      S3_PREFIX: backup
      POSTGRES_DATABASE: dbname
      POSTGRES_USER: user
      POSTGRES_PASSWORD: password
      POSTGRES_EXTRA_OPTS: '--schema=public --blobs'

自动定期备份说明

设置SCHEDULE环境变量可实现自动备份，支持cron预定义计划（如@daily每日、@weekly每周等），详细调度规则参考官方文档。