lazytechw/barman-docker

镜像概述和主要用途

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

• 带有Barman流和rsync/ssh支持的PostgreSQL容器
• 带有sshd的Barman容器

主要用于PostgreSQL数据库的备份与恢复，支持同时备份多个PostgreSQL服务器，并提供流（streaming）和rsync/ssh两种备份策略。

核心功能和特性

• 多服务器备份：Barman容器可同时备份多个PostgreSQL服务器
• 双备份策略：支持流（streaming）和rsync/ssh两种备份方式
• 定时备份：内置定时任务（默认每天4点），可自定义备份 schedule
• 手动备份：支持手动触发全量备份或指定服务器备份
• 恢复功能：支持基于最新备份或时间点（PITR）的恢复

使用场景和适用范围

适用于需要可靠PostgreSQL数据库备份的环境，包括：

• 生产环境PostgreSQL数据库的日常备份与灾难恢复
• 开发/测试环境中数据库的版本控制与数据回溯
• 需要管理多个PostgreSQL实例备份的场景

使用方法和配置说明

运行示例

构建镜像

Windows系统下，运行buildBoth.bat构建barman和postgres目录下的两个镜像：

bash
buildBoth.bat

启动容器

进入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的连接凭证。

设置环境变量

在docker-compose配置中设置以下环境变量：

yaml
# 格式：dbHostName,dbHost。dbHostName为Barman中使用的服务器名称，dbHost为数据库连接地址
PG_SERVERS: "pg,pg pgb,pgb"
BARMAN_PASSWORD: ${barmanPass}
STREAMING_PASSWORD: ${barmanStreamPass}

备份操作

定时备份

默认配置了每天4点执行全量备份的定时任务，可通过以下环境变量自定义备份 schedule：

yaml
environment:
  BARMAN_BACKUP_SCHEDULE: "0 4 * * *"  # 格式为cron表达式

手动备份

测试时可手动触发备份：

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

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

恢复操作

进入恢复模式

将docker-compose.or.yaml复制为docker-compose.override.yaml，使PostgreSQL容器进入恢复模式：

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

执行恢复

进入Barman容器执行恢复操作：

bash
docker-compose exec barman bash

# 列出备份ID（SERVER_NAME为目标服务器名称）
barman list-backup SERVER_NAME

# 恢复最新备份到PostgreSQL数据目录
gosu barman barman recover SERVER_NAME latest /var/lib/postgresql/data --remote-ssh-command 'ssh postgres@pg'

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

exit

# 启动服务
docker-compose up -d

配置说明

SSH和流备份策略

警告：目前推荐使用流备份策略，SSH策略不再在Travis中测试，但仍欢迎PR贡献。

默认仅启用流备份策略，可通过以下环境变量启用/禁用SSH或流备份：

bash
# 禁用流备份
BARMAN_STREAM_ON=0

# 启用SSH备份
BARMAN_SSH_ON=1

贡献与反馈

欢迎提交Issues和Pull Requests！

参考项目

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