bborbe/postgres-backup

PostgreSQL备份镜像（bborbe/postgres-backup）

镜像概述

bborbe/postgres-backup是一个轻量级Docker镜像，用于实现PostgreSQL数据库的备份管理，支持一次性备份和定时循环备份，帮助用户快速、安全地保护数据库数据。

核心功能

1. 一次性备份：立即执行单次数据库备份操作。
2. 定时备份：按指定间隔（如每小时）自动循环备份。
3. 灵活配置：通过环境变量自定义数据库连接信息、备份模式及存储路径。

使用场景

• 生产环境PostgreSQL数据库的定期数据保护。
• 开发/测试环境的数据备份与恢复准备。
• 需要自动化备份流程的场景。

配置说明

主要环境变量：

• HOST：PostgreSQL数据库主机地址（如容器名）。
• PORT：数据库端口（默认5432）。
• DATABASE：目标数据库名称。
• USERNAME：数据库用户名。
• PASSWORD：数据库密码。
• ONE_TIME：是否为一次性备份（true/false）。
• WAIT：定时备份间隔（如1h表示每小时一次）。
• TARGETDIR：备份文件存储目录。

部署示例

启动PostgreSQL数据库容器

bash
docker run \
--name db \
--env POSTGRES_DB=mydb \
--env POSTGRES_USER=myuser \
--env POSTGRES_PASSWORD=mypassword \
--env PGDATA=/var/lib/postgresql/data/pgdata \
postgres:9.6.1-alpine

执行一次性备份

bash
docker run \
--env HOST=db \
--env PORT=5432 \
--env DATABASE=mydb \
--env USERNAME=myuser \
--env PASSWORD=mypassword \
--env ONE_TIME=true \
--env LOCK=/postgres_backup_cron.lock \
--env TARGETDIR=/backup \
--volume /tmp:/backup \
--link db:db \
bborbe/postgres-backup:latest \
-logtostderr \
-v=1

备份文件将保存到/tmp目录，可通过ls /tmp/postgres_mydb_*.dump查看。

每小时定时备份

bash
docker run \
--env HOST=db \
--env PORT=5432 \
--env DATABASE=mydb \
--env USERNAME=myuser \
--env PASSWORD=mypassword \
--env WAIT=1h \
--env ONE_TIME=false \
--env LOCK=/postgres_backup_cron.lock \
--env TARGETDIR=/backup \
--volume /tmp:/backup \
--link db:db \
bborbe/postgres-backup:latest \
-logtostderr \
-v=1

备份文件同样保存到/tmp目录，可通过ls /tmp/postgres_mydb_*.dump查看。

版权与许可

Copyright (c) 2016, Benjamin Borbe <***>
All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
   * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
   * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.