repmgr完全指南：PostgreSQL高可用复制管理终极方案

【免费下载链接】repmgr A lightweight replication manager for PostgreSQL (Postgres) 项目地址: https://gitcode.com/gh_mirrors/re/repmgr

repmgr 是一套开源工具，专为PostgreSQL数据库设计，用于管理复制和故障转移。它通过提供设置备用服务器、监控复制状态以及执行故障转移或切换等管理任务的实用程序，增强了PostgreSQL的内置复制功能。对于需要确保数据库服务持续可用的企业和开发者来说，repmgr是实现高可用性的理想选择。

为什么选择repmgr？核心优势解析 🚀

在PostgreSQL的高可用方案中，repmgr凭借其轻量级设计和强大功能脱颖而出。与其他解决方案相比，它具有以下核心优势：

• 简单易用：通过直观的命令行工具和清晰的配置文件，快速上手无需复杂的学习曲线
• 自动化操作：支持自动故障转移和备用服务器克隆，减少人工干预
• 全面监控：实时跟踪复制状态，及时发现并预警潜在问题
• 灵活配置：可根据不同环境需求自定义复制策略和故障转移规则
• 开源免费：完全开源的解决方案，无需额外许可费用

快速入门：repmgr安装与配置指南

准备工作

在开始安装repmgr之前，请确保您的系统满足以下要求：

• PostgreSQL 9.3或更高版本
• 所有节点之间的网络连接正常
• 适当的用户权限（通常需要postgres用户）

安装步骤

1. 克隆仓库

   git clone https://gitcode.com/gh_mirrors/re/repmgr
   cd repmgr
   

2. 编译安装

   ./configure
   make
   make install
   

3. 创建repmgr扩展 在主数据库中执行：

   CREATE EXTENSION repmgr;
   

核心配置文件解析

repmgr的配置文件是实现高可用的关键。以下是repmgr.conf.sample中的核心配置项：

# 必要配置项
node_id=1                  # 唯一节点ID（大于0的整数）
node_name='primary_node'   # 节点名称（建议使用主机名）
conninfo='host=primary port=5432 user=repmgr dbname=repmgr'  # 数据库连接信息
data_directory='/var/lib/postgresql/14/main'  # 数据目录路径

# 复制设置
replication_user='repmgr'  # 复制用户
use_replication_slots=yes  # 是否使用复制槽

# 故障转移设置
failover='automatic'       # 故障转移模式（自动/手动）
priority=100               # 提升优先级（值越高越优先）
promote_command='repmgr standby promote -f /etc/repmgr.conf'  # 提升命令
follow_command='repmgr standby follow -f /etc/repmgr.conf --upstream-node-id=%n'  # 跟随命令

核心功能详解：从基础到高级 🛠️

1. 主备复制管理

repmgr简化了PostgreSQL主备复制的配置和管理流程。通过以下命令可以轻松设置和维护复制环境：

• 注册主节点

  repmgr primary register -f /etc/repmgr.conf
  

• 克隆备用节点

  repmgr standby clone -h primary_host -U repmgr -d repmgr --force
  

• 注册备用节点

  repmgr standby register -f /etc/repmgr.conf
  

2. 自动故障转移

repmgr的自动故障转移功能是其核心优势之一。当主节点出现故障时，repmgrd守护进程会自动将最合适的备用节点提升为新的主节点：

# 启动repmgrd守护进程
repmgrd -f /etc/repmgr.conf --daemonize

在repmgr.conf中，通过以下配置控制故障转移行为：

failover='automatic'          # 启用自动故障转移
priority=100                  # 节点优先级
reconnect_attempts=6          # 重连尝试次数
reconnect_interval=10         # 重连间隔（秒）

3. 集群监控与管理

repmgr提供了全面的集群监控工具，帮助管理员实时了解系统状态：

• 查看集群状态

  repmgr cluster show
  

• 检查节点健康状况

  repmgr node check -f /etc/repmgr.conf
  

• 监控复制延迟

  repmgr node check --replication-lag -f /etc/repmgr.conf
  

4. 手动切换与维护

在计划维护时，repmgr支持安全的主备切换，确保服务不中断：

# 执行主备切换
repmgr standby switchover -f /etc/repmgr.conf --siblings-follow

实战案例：构建高可用PostgreSQL集群

环境规划

假设我们要构建一个包含3个节点的PostgreSQL集群：

• 1个主节点（primary）
• 2个备用节点（standby1, standby2）

配置步骤

1. 在所有节点安装PostgreSQL和repmgr

2. 在主节点初始化数据库并创建repmgr用户

   CREATE ROLE repmgr WITH SUPERUSER LOGIN REPLICATION PASSWORD 'repmgr_password';
   CREATE DATABASE repmgr OWNER repmgr;
   

3. 配置主节点repmgr.conf

   node_id=1
   node_name='primary'
   conninfo='host=primary port=5432 user=repmgr dbname=repmgr password=repmgr_password'
   data_directory='/var/lib/postgresql/14/main'
   replication_user='repmgr'
   failover='automatic'
   priority=100
   

4. 注册主节点

   repmgr primary register -f /etc/repmgr.conf
   

5. 在备用节点克隆并注册

   repmgr standby clone -h primary -U repmgr -d repmgr
   repmgr standby register -f /etc/repmgr.conf
   

6. 启动repmgrd守护进程

   repmgrd -f /etc/repmgr.conf --daemonize
   

常见问题与解决方案 ❓

Q: 如何处理复制延迟过大的问题？

A: 可以通过调整以下配置项来优化复制性能：

replication_lag_warning=300   # 复制延迟警告阈值（秒）
replication_lag_critical=600  # 复制延迟严重阈值（秒）

同时确保网络带宽充足，并考虑使用更快的存储设备。

Q: 如何手动触发故障转移？

A: 可以使用以下命令手动将备用节点提升为主节点：

repmgr standby promote -f /etc/repmgr.conf

Q: repmgrd无法启动怎么办？

A: 首先检查日志文件（默认位于/var/log/repmgr/），常见问题包括：

• 配置文件错误
• 数据库连接问题
• 权限不足

总结：repmgr为PostgreSQL高可用保驾护航

repmgr作为一款轻量级的PostgreSQL复制管理工具，通过自动化的故障转移、直观的集群监控和简单的配置管理，大大降低了构建高可用PostgreSQL集群的复杂度。无论是小型应用还是企业级系统，repmgr都能提供可靠的复制管理解决方案，确保数据安全和服务持续可用。

要深入了解更多repmgr功能和最佳实践，请参考官方文档和资源：

• repmgr.conf.sample
• doc/目录下的详细文档
• FAQ.md常见问题解答

【免费下载链接】repmgr A lightweight replication manager for PostgreSQL (Postgres) 项目地址: https://gitcode.com/gh_mirrors/re/repmgr