baunach/postgres-restore

Postgres数据库恢复Docker镜像

镜像概述和主要用途

本镜像基于标准Postgres镜像构建，用于从S3兼容存储中恢复Postgres数据库，通过aws cli实现数据恢复功能。当设置AWS_S3_BUCKET和AWS_S3_PATH环境变量时，会自动安装aws cli，简化数据库恢复流程。

https://github.com/baunach-it/postgres-restore/blob/main/Dockerfile

核心功能和特性

• 基于标准Postgres镜像，确保与Postgres数据库的兼容性
• 支持从S3兼容存储恢复数据库备份
• 自动安装aws cli（当设置AWS_S3_BUCKET和AWS_S3_PATH环境变量时）
• 支持自定义aws cli版本
• 支持自定义S3端点，适应不同的S3兼容存储服务

使用场景和适用范围

• Postgres数据库的备份恢复操作
• 跨环境（如开发、测试、生产）的数据库迁移
• 需要从S3存储中恢复数据库的场景
• 自动化数据库恢复流程的集成

使用方法和配置说明

环境变量配置

创建.env文件，配置以下环境变量：

bash
# 目标数据库连接信息
POSTGRES_RESTORE_TARGET_DB_HOST=localhost          # 目标数据库主机
POSTGRES_RESTORE_TARGET_DB_PORT=5432               # 目标数据库端口
POSTGRES_RESTORE_TARGET_USER=postgres              # 目标数据库用户名
POSTGRES_RESTORE_TARGET_PASSWORD=mypassword        # 目标数据库密码
POSTGRES_RESTORE_TARGET_DB_NAME=target_db          # 目标数据库名称

# S3存储配置（如需使用S3恢复时添加）
POSTGRES_RESTORE_AWS_ACCESS_KEY_ID=                # AWS访问密钥ID
POSTGRES_RESTORE_AWS_SECRET_ACCESS_KEY=            # AWS密钥
POSTGRES_RESTORE_AWS_DEFAULT_REGION=               # AWS默认区域
POSTGRES_RESTORE_AWS_S3_BUCKET=                    # S3存储桶名称
POSTGRES_RESTORE_AWS_S3_PATH=                      # S3中备份文件路径

# 自定义配置
POSTGRES_RESTORE_AWS_CLI_VERSION=                  # 自定义aws cli版本（可选）
POSTGRES_RESTORE_S3_ENDPOINT=                      # 自定义S3端点（可选，适用于非AWS S3兼容存储）
POSTGRES_RESTORE_DUMPFILE=                         # 备份文件名

运行容器

引用.env文件运行容器，可使用latest标签或指定Postgres版本（如18.0）：

bash
docker run --rm \
  --env-file .env \
  -e POSTGRES_RESTORE_DUMPFILE=dump.sql.gz \  # 指定备份文件名（若未在.env中设置）
  -v /desired/backup/path:/restore \          # 挂载本地备份目录（若使用本地文件恢复）
  --network desired-network \                  # 连接到目标数据库所在网络
  baunach/postgres-restore:latest

参数说明

• --rm：容器退出后自动删除
• --env-file .env：加载.env文件中的环境变量
• -e POSTGRES_RESTORE_DUMPFILE：指定备份文件名（可覆盖.env中的设置）
• -v /desired/backup/path:/restore：挂载本地备份文件路径到容器内的/restore目录（用于本地文件恢复）
• --network desired-network：确保容器与目标数据库在同一网络，以便正常连接