lazytechw/postgres-barman

PostgreSQL-Barman Docker镜像

镜像概述和主要用途

该Docker镜像包含两个容器构建：

• 带有barman流备份和rsync/ssh支持的PostgreSQL容器
• 带有sshd服务的Barman容器

主要用于PostgreSQL数据库的备份与恢复，支持多服务器备份管理，提供灵活的备份策略选择。

核心功能和特性

• 多服务器支持：Barman容器可备份多个PostgreSQL服务器
• 备份策略：同时支持流备份（streaming）和rsync/ssh备份策略
• 自动化备份：内置cron任务支持定时备份
• 手动备份：支持手动触发全量备份或指定服务器备份
• 恢复功能：支持最新备份恢复和时间点恢复（PITR）
• 安全认证：通过SSH密钥认证确保备份过程安全

使用场景和适用范围

适用于需要对一个或多个PostgreSQL数据库进行可靠备份和恢复的环境，包括：

• 生产环境PostgreSQL服务器的定期备份
• 开发测试环境的数据库备份与恢复验证
• 需要灵活备份策略（流备份或rsync/ssh）的场景
• 要求自动化备份与手动备份结合的场景

使用方法和配置说明

运行示例

构建镜像

Windows系统下，执行以下命令构建两个镜像：

bash
buildBoth.bat

该脚本会构建barman和postgres目录下的镜像。

启动容器

进入examples目录，使用docker-compose启动容器：

bash
cd examples
docker-compose up -d

可参考examples/test.sh了解详细使用方法。

生成SSH密钥

进入pgSshKeys和barmanSshKeys目录，分别执行以下命令生成SSH密钥：

bash
ssh-keygen -f ./ssh_host_rsa_key -q -N ""

将生成的ssh_host_rsa_key.pub公钥内容互复制到对方的authorized_keys文件中，实现SSH免密登录。

配置pgpass文件

在pgpass文件中添加PostgreSQL数据库的访问凭据，格式遵循PostgreSQL的pgpass标准。

设置环境变量

在docker-compose配置中设置必要的环境变量：

yaml
# 格式：dbHostName,dbHost。dbHostName用于Barman标识服务器名称，dbHost用于数据库连接
PG_SERVERS: "pg,pg pgb,pgb"
BARMAN_PASSWORD: ${barmanPass}       # Barman用户密码
STREAMING_PASSWORD: ${barmanStreamPass}  # 流备份密码

备份操作

定时备份

默认配置了cron任务按"0 4 * * *"（每天凌晨4点）执行备份，可通过环境变量修改备份计划：

yaml
environment:
  BARMAN_BACKUP_SCHEDULE: "0 4 * * *"  # 自定义cron表达式

手动备份

可通过以下命令手动触发备份：

bash
# 备份所有服务器
gosu barman barman backup all

# 备份指定服务器（SERVER_NAME为Barman中配置的服务器名称）
gosu barman barman backup SERVER_NAME

恢复操作

恢复步骤

1. 停止现有容器并备份数据目录：

bash
cd examples
docker-compose down
mv pgData pgData.bak  # 备份当前数据目录

2. 复制恢复模式配置文件：

bash
cp docker-compose.or.yaml docker-compose.override.yaml

3. 启动容器：

bash
docker-compose up

4. 执行恢复命令：

bash
# 进入Barman容器
docker-compose exec barman bash

# 列出可用备份（替换pg-streaming为实际服务器名称）
barman list-backup pg-streaming

# 恢复最新备份
gosu barman barman recover pg-streaming latest /var/lib/postgresql/data --remote-ssh-command 'ssh postgres@pg'

# 时间点恢复（PITR）示例
gosu barman barman recover pg-streaming latest /var/lib/postgresql/data --target-time "2021-01-07 10:45:00" --remote-ssh-command 'ssh postgres@pg'

exit  # 退出Barman容器

5. 重启容器完成恢复：

bash
docker-compose up -d

配置说明

SSH和流备份策略切换

警告：当前推荐使用流备份策略，SSH策略不再在Travis中进行测试，但仍接受PR贡献。

默认仅启用流备份策略，可通过环境变量启用/禁用相关策略：

# 禁用流备份
BARMAN_STREAM_ON=0

# 启用SSH备份
BARMAN_SSH_ON=1

问题反馈与PR

欢迎提交问题反馈和PR贡献！

参考项目

https://github.com/tbeadle/postgres/blob/master/barman/image-pre-start.d/01_update_postgresql.conf.sh