Patroni工具集成指南：与Barman的深度整合

尤辰城Agatha

于 2025-06-06 09:02:00 发布

阅读量208

点赞数 4

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00254/article/details/148464341

Patroni工具集成指南：与Barman的深度整合

patroni A template for PostgreSQL High Availability with Etcd, Consul, ZooKeeper, or Kubernetes 项目地址: https://gitcode.com/gh_mirrors/pa/patroni

前言

Patroni作为PostgreSQL高可用解决方案，其强大之处不仅在于自身功能，还在于它能与生态系统中其他工具无缝集成。本文将深入探讨Patroni与Barman备份工具的集成方式，帮助DBA构建更健壮的PostgreSQL高可用环境。

Barman集成概述

Barman是PostgreSQL的备份管理工具，而Patroni提供的patroni_barman应用程序充当了两者之间的桥梁。这个工具通过pg-backup-api与Barman进行远程通信，实现了备份操作的远程执行能力。

核心功能解析

1. 恢复功能(recover)

patroni_barman recover子命令提供了两种关键用途：

自定义引导方法：可用于初始化新的PostgreSQL集群
自定义副本创建：用于从备份中创建新的副本节点

技术要点：

此功能特别适合灾难恢复场景
可以基于Barman备份快速重建整个集群
支持时间点恢复(PITR)操作

2. 配置切换功能(config-switch)

patroni_barman config-switch子命令设计用于角色变更回调，主要解决以下问题：

典型场景：当Patroni集群发生故障转移时，Barman需要从新的主节点开始接收WAL日志。传统方式需要手动调整配置，而通过此功能可实现自动化切换。

实战配置示例

以下是一个完整的Patroni配置示例，展示了如何设置角色变更回调：

postgresql:
    callbacks:
        on_role_change: >
            patroni_barman
                --api-url YOUR_API_URL
                config-switch
                --barman-server YOUR_BARMAN_SERVER_NAME
                --barman-model YOUR_BARMAN_MODEL_NAME
                --switch-when promoted

配置说明：

YOUR_API_URL：pg-backup-api的服务地址
YOUR_BARMAN_SERVER_NAME：Barman服务器名称
YOUR_BARMAN_MODEL_NAME：预定义的Barman配置模型名称
--switch-when promoted：仅在提升为主节点时触发配置切换

实现原理深度解析

配置模型机制：
- Barman 3.10+引入了配置模型概念
- 允许通过模板方式动态修改Barman配置
- 模型可以预先定义各种备份策略
API交互流程：
- Patroni通过REST API与pg-backup-api通信
- API将请求转发给Barman执行实际操作
- 整个过程对Patroni透明