woblerr/pgbackrest Docker 镜像 - 轩辕镜像

docker-pgbackrest

概述

docker-pgbackrest是将pgBackRest打包到Docker容器中的镜像，适用于不愿在专用仓库主机或CI/CD系统中通过yum、apt等方式安装pgBackRest系统包的场景。只需运行Docker容器即可使用pgBackRest，同时PostgreSQL服务器端需按pgBackRest文档配置。

仓库包含pgBackRest最新5个版本的信息，如需旧版本可手动构建。同时提供支持Greenplum的pgBackRest分支版本（基于pgbackrest/pull/1833），包含最新3个版本，旧版本同样支持手动构建。

支持的版本标签

标准pgBackRest版本标签

• 2.56.0、latest
• 2.56.0-alpine
• 2.55.1
• 2.55.1-alpine
• 2.55.0
• 2.55.0-alpine
• 2.54.2
• 2.54.2-alpine
• 2.54.1
• 2.54.1-alpine

支持Greenplum的pgBackRest版本标签

• 2.52-gpdb
• 2.52-gpdb-alpine
• 2.50-gpdb
• 2.50-gpdb-alpine
• 2.47-gpdb
• 2.47-gpdb-alpine

镜像特性

• 基础镜像：基于官方Ubuntu或Alpine镜像
• 构建方式：
  • Ubuntu版本：在独立的builder容器中从源码构建
  • Alpine版本：使用虚拟包.backrest-build从源码构建
• 附加功能：包含pgbackrest-bash-completion脚本，支持通过Tab键自动补全pgbackrest命令

环境变量

拉取镜像

根据需要的版本标签替换tag。

Docker Hub

bash
docker pull woblerr/pgbackrest:tag

Alpine版本：

bash
docker pull woblerr/pgbackrest:tag-alpine

GitHub Registry

bash
docker pull ghcr.io/woblerr/pgbackrest:tag

Alpine版本：

bash
docker pull ghcr.io/woblerr/pgbackrest:tag-alpine

运行示例

使用前需挂载必要的目录或文件到容器中。

简单运行

bash
docker run --rm pgbackrest:51 pgbackrest help

交互模式

bash
docker run --rm -it pgbackrest:2.56.0 bash

pgbackrest@cac1f58b56f2:/$ pgbackrest version
pgBackRest 2.56.0

专用仓库主机示例

假设主机用户/组为pgbackrest:pgbackrest（UID/GID 1001:1001），备份存储在本地用户目录下。

使用SSH协议

bash
docker run --rm \
    -e BACKREST_UID=1001 \
    -e BACKREST_GID=1001 \
    -v ~/.ssh/id_rsa:/home/pgbackrest/.ssh/id_rsa \
    -v /etc/pgbackrest:/etc/pgbackrest \
    -v /var/lib/pgbackrest:/var/lib/pgbackrest \
    pgbackrest:2.56.0 \
    pgbackrest backup --stanza demo --type full --log-level-console info

旧版本pgBackRest：

bash
docker run --rm \
    -e BACKREST_UID=1001 \
    -e BACKREST_GID=1001 \
    -v ~/.ssh/id_rsa:/home/pgbackrest/.ssh/id_rsa \
    -v /etc/pgbackrest:/etc/pgbackrest \
    -v /var/lib/pgbackrest:/var/lib/pgbackrest \
    pgbackrest:2.30 \
    pgbackrest backup --stanza demo-old --type full --log-level-console info

防止同一stanza并发执行多个备份进程：

bash
docker run --rm \
    -e BACKREST_UID=1001 \
    -e BACKREST_GID=1001 \
    -v ~/.ssh/id_rsa:/home/pgbackrest/.ssh/id_rsa \
    -v /etc/pgbackrest:/etc/pgbackrest \
    -v /var/lib/pgbackrest:/var/lib/pgbackrest \
    -v /tmp/pgbackrest:/tmp/pgbackrest \
    pgbackrest:2.56.0 \
    pgbackrest backup --stanza demo --type full --log-level-console info

使用TLS协议

仅支持pgBackRest version >= 2.37，两种使用模式：

1. 以TLS服务器模式启动容器
需设置BACKREST_TLS_SERVER=enable，BACKREST_HOST_TYPE和BACKREST_TLS_WAIT不影响此模式：

bash
docker run -d \
    -e BACKREST_UID=1001 \
    -e BACKREST_GID=1001 \
    -e BACKREST_TLS_SERVER=enable \
    -v /etc/pgbackrest:/etc/pgbackrest \
    -v /var/lib/pgbackrest:/var/lib/pgbackrest \
    -p 8432:8432 \
    --name backrest_server \
    pgbackrest:2.56.0

2. 后台启动TLS服务器并通过TLS执行pgBackRest
需设置BACKREST_HOST_TYPE=tls，BACKREST_TLS_WAIT可调整等待时间（默认15秒）：

bash
docker run --rm \
    -e BACKREST_UID=1001 \
    -e BACKREST_GID=1001 \
    -e BACKREST_HOST_TYPE=tls \
    -v /etc/pgbackrest:/etc/pgbackrest \
    -v /var/lib/pgbackrest:/var/lib/pgbackrest \
    pgbackrest:2.56.0 \
    pgbackrest backup --stanza demo --type full --log-level-console info

本地PostgreSQL备份示例（芝加哥时区）

PostgreSQL以postgres:postgres（UID/GID 1001:1001）运行，数据路径/var/lib/postgresql/12/main，备份路径/var/lib/pgbackrest：

bash
docker run --rm \
    -e BACKREST_USER=postgres \
    -e BACKREST_UID=1001 \
    -e BACKREST_GROUP=postgres \
    -e BACKREST_GID=1001 \
    -e TZ=America/Chicago \
    -v /etc/pgbackrest/pgbackrest.conf:/etc/pgbackrest/pgbackrest.conf \
    -v /var/lib/postgresql/12/main:/var/lib/postgresql/12/main \
    -v /var/lib/pgbackrest:/var/lib/pgbackrest \
    -v /var/run/postgresql/.s.PGSQL.5432:/var/run/postgresql/.s.PGSQL.5432 \
    pgbackrest:2.56.0 \
    pgbackrest backup --stanza demo --type full --log-level-console info

远程PostgreSQL通过TLS备份示例

远程PostgreSQL通过TLS通信，备份和WAL文件路径/var/lib/pgbackrest：

启动TLS服务器容器（供远程PostgreSQL归档WAL文件）：

bash
docker run -d \
    -e BACKREST_UID=1001 \
    -e BACKREST_GID=1001 \
    -e BACKREST_TLS_SERVER=enable \
    -v /etc/pgbackrest/pgbackrest.conf:/etc/pgbackrest/pgbackrest.conf \
    -v /etc/pgbackrest/cert:/etc/pgbackrest/cert \
    -v /var/lib/pgbackrest:/var/lib/pgbackrest \
    -p 8432:8432 \
    --name backrest_server \
    pgbackrest:2.56.0

执行备份：

bash
docker run --rm \
    -e BACKREST_UID=1001 \
    -e BACKREST_GID=1001 \
    -e BACKREST_HOST_TYPE=tls \
    -v /etc/pgbackrest/pgbackrest.conf:/etc/pgbackrest/pgbackrest.conf \
    -v /etc/pgbackrest/cert:/etc/pgbackrest/cert \
    -v /var/lib/pgbackrest:/var/lib/pgbackrest \
    pgbackrest:2.56.0 \
    pgbackrest backup --stanza demo --type full --log-level-console info

构建镜像

标准版本构建

bash
make build_version TAG=2.56.0

Alpine版本：

bash
make build_version_alpine TAG=2.56.0

或直接使用docker命令：

bash
docker build -f Dockerfile --build-arg BACKREST_VERSION=2.56.0 --build-arg BACKREST_COMPLETION_VERSION=v0.10 -t pgbackrest:2.56.0 .

Alpine版本：

bash
docker build -f Dockerfile.alpine --build-arg BACKREST_VERSION=2.56.0 --build-arg BACKREST_COMPLETION_VERSION=v0.10 -t pgbackrest:2.56.0-alpine .

旧版本（< v2.51）构建

pgBackRest v2.51+使用meson构建系统，旧版本需使用Dockerfile_make或Dockerfile_make.alpine：

bash
make build_version TAG=2.49

Alpine版本：

bash
make build_version_alpine TAG=2.49

或直接使用docker命令：

bash
docker build -f Dockerfile_make --build-arg BACKREST_VERSION=2.49 --build-arg BACKREST_COMPLETION_VERSION=v0.10 -t pgbackrest:2.49 .

Alpine版本：

bash
docker build -f Dockerfile_make.alpine --build-arg BACKREST_VERSION=2.49 --build-arg BACKREST_COMPLETION_VERSION=v0.10 -t pgbackrest:2.49-alpine .

Greenplum支持版本

拉取镜像

Docker Hub：

bash
docker pull woblerr/pgbackrest:tag-gpdb

Alpine版本：

bash
docker pull woblerr/pgbackrest:tag-gpdb-alpine

GitHub Registry：

bash
docker pull ghcr.io/woblerr/pgbackrest:tag-gpdb

Alpine版本：

bash
docker pull ghcr.io/woblerr/pgbackrest:tag-gpdb-alpine

运行示例

bash
docker run --rm pgbackrest:2.52-gpdb pgbackrest help

运行测试

执行端到端测试：

bash
make test-e2e

测试详情参见测试说明。