任务，参考 on PIGSTY

备份恢复

Mon, 01 Jan 0001 00:00:00 +0000

Pigsty 使用 pgBackRest 管理 PostgreSQL 备份，这可能是生态系统中最强大的开源备份工具。它支持增量/并行备份与恢复、加密、MinIO/S3 等众多特性。Pigsty 默认为每个 PGSQL 集群预配置了备份功能。

章节	内容
机制	备份脚本、定时任务、pgbackrest、仓库与管理
策略	备份策略、磁盘规划、恢复窗口权衡
仓库	配置备份仓库：本地、MinIO、S3
管理	常用备份管理命令
恢复	使用剧本恢复到特定时间点
示例	沙箱示例：手工执行恢复操作

免责声明

Pigsty 尽最大努力提供可靠的 PITR 解决方案，但我们不对 PITR 操作导致的数据丢失承担任何责任，使用需自担风险。如需专业支持，请考虑我们的专业服务。

快速上手

备份策略：使用 Crontab 调度基础备份
WAL 归档：持续记录写入活动
恢复与还原：从备份和 WAL 归档中恢复

node_crontab: [ '00 01 * * * postgres /pg/bin/pg-backup full' ]

./pgsql-pitr.yml -e '{"pg_pitr": { "time": "2025-07-13 10:00:00+00" }}'

数据迁移

Mon, 01 Jan 0001 00:00:00 +0000

Pigsty 内置了一个剧本 pgsql-migration.yml，基于逻辑复制来实现在线数据库迁移。

通过预生成的自动化脚本，应用停机时间可以缩减到几秒内。但请注意，逻辑复制需要 PostgreSQL 10 以上的版本才能工作。

当然如果您有充足的停机时间预算，那么总是可以使用 pg_dump | psql 的方式进行停机迁移。

定义迁移任务

想要使用 Pigsty 提供的在线迁移剧本，您需要创建一个定义文件，来描述迁移任务的细节。

请查看任务定义文件示例作为参考： files/migration/pg-meta.yml。

这个迁移任务要将 pg-meta.meta 在线迁移到 pg-test.test，前者称为 源集群（SRC），后者称为 宿集群（DST）。

pg-meta-1	10.10.10.10 --> pg-test-1	10.10.10.11 (10.10.10.12,10.10.10.13)

基于逻辑复制的迁移以数据库为单位，您需要指定需要迁移的数据库名称，以及数据库源宿集群主节点的 IP 地址，以及超级用户的连接信息。

---
#-----------------------------------------------------------------
# PG_MIGRATION
#-----------------------------------------------------------------
context_dir: ~/migration  # 迁移手册 & 脚本的放置目录
#-----------------------------------------------------------------
# SRC Cluster (旧集群)
#-----------------------------------------------------------------
src_cls: pg-meta  # 源集群名称 <必填>
src_db: meta  # 源数据库名称 <必填>
src_ip: 10.10.10.10 # 源集群主 IP <必填>
#src_pg: '' # 如果定义，使用此作为源 dbsu pgurl 代替：
# # postgres://{{ pg_admin_username }}@{{ src_ip }}/{{ src_db }}
# # 例如: 'postgres://dbuser_dba:DBUser.DBA@10.10.10.10:5432/meta'
#sub_conn: '' # 如果定义，使用此作为订阅连接字符串代替：
# # host={{ src_ip }} dbname={{ src_db }} user={{ pg_replication_username }}'
# # 例如: 'host=10.10.10.10 dbname=meta user=replicator password=DBUser.Replicator'
#-----------------------------------------------------------------
# DST Cluster (新集群)
#-----------------------------------------------------------------
dst_cls: pg-test  # 宿集群名称 <必填>
dst_db: test  # 宿数据库名称 <必填>
dst_ip: 10.10.10.11 # 宿集群主 IP <必填>
#dst_pg: '' # 如果定义，使用此作为目标 dbsu pgurl 代替：
# # postgres://{{ pg_admin_username }}@{{ dst_ip }}/{{ dst_db }}
# # 例如: 'postgres://dbuser_dba:DBUser.DBA@10.10.10.11:5432/test'
#-----------------------------------------------------------------
# PGSQL
#-----------------------------------------------------------------
pg_dbsu: postgres
pg_replication_username: replicator
pg_replication_password: DBUser.Replicator
pg_admin_username: dbuser_dba
pg_admin_password: DBUser.DBA
pg_monitor_username: dbuser_monitor
pg_monitor_password: DBUser.Monitor
#-----------------------------------------------------------------
...

默认情况下，源宿集群两侧的超级用户连接串会使用全局的管理员用户和各自主库的 IP 地址拼接而成，但您总是可以通过 src_pg 和 dst_pg 参数来覆盖这些默认值。同理，您也可以通过 sub_conn 参数来覆盖订阅连接串的默认值。

任务教程

Mon, 01 Jan 0001 00:00:00 +0000

使用 VIP-Manager 为 PostgreSQL 集群配置二层 VIP

Mon, 01 Jan 0001 00:00:00 +0000

您可以在 PostgreSQL 集群上绑定一个可选的 L2 VIP —— 前提条件是：集群中的所有节点都在一个二层网络中。

这个 L2 VIP 强制使用 Master - Backup 模式，Master 始终指向在数据库集群主库实例所在的节点。

这个 VIP 由 VIP-Manager 组件管理，它会从 DCS （etcd）中直接读取由 Patroni 写入的 Leader Key，从而判断自己是否是 Master。

启用VIP

在 PostgreSQL 集群上定义 pg_vip_enabled 参数为 true，即可在集群上启用 VIP 组件。当然您也可以在全局配置中启用此配置项。

# pgsql 3 node ha cluster: pg-test
pg-test:
 hosts:
 10.10.10.11: { pg_seq: 1, pg_role: primary } # primary instance, leader of cluster
 10.10.10.12: { pg_seq: 2, pg_role: replica } # replica instance, follower of leader
 10.10.10.13: { pg_seq: 3, pg_role: replica, pg_offline_query: true } # replica with offline access
 vars:
 pg_cluster: pg-test # define pgsql cluster name
 pg_users: [{ name: test , password: test , pgbouncer: true , roles: [ dbrole_admin ] }]
 pg_databases: [{ name: test }]

 # 启用 L2 VIP
 pg_vip_enabled: true
 pg_vip_address: 10.10.10.3/24
 pg_vip_interface: eth1

请注意，pg_vip_address 必须是一个合法的 IP 地址，带有网段，且在当前二层网络中可用。

管理预案

Mon, 01 Jan 0001 00:00:00 +0000

本章节介绍 Pigsty 部署的日常管理和运维操作。