PostgreSQL高可用Repmgr命令及配置文件是怎样的

在现代数据库管理中，高可用性（High Availability, HA）是一个至关重要的需求。PostgreSQL作为一款功能强大的开源关系型数据库管理系统，提供了多种高可用解决方案，其中repmgr是一个广泛使用的工具。本文将详细介绍repmgr的命令及配置文件，帮助您更好地理解和配置PostgreSQL的高可用环境。

1. Repmgr简介

repmgr（Replication Manager）是一个用于管理PostgreSQL复制和故障转移的开源工具。它简化了主从复制、故障检测、自动故障转移等操作，使得PostgreSQL集群的高可用性管理更加便捷。

1.1 主要功能

• 复制管理：自动配置和管理主从复制。
• 故障检测：监控主节点的健康状态，检测故障。
• 自动故障转移：在主节点故障时，自动将备节点提升为新的主节点。
• 手动故障转移：支持手动触发故障转移。
• 节点管理：添加、删除、重新加入节点等操作。

2. Repmgr安装与配置

在开始使用repmgr之前，首先需要在所有PostgreSQL节点上安装repmgr工具。

2.1 安装Repmgr

在Debian/Ubuntu系统上，可以使用以下命令安装repmgr：

sudo apt-get install repmgr

在CentOS/RHEL系统上，可以使用以下命令安装repmgr：

sudo yum install repmgr

2.2 配置PostgreSQL

在配置repmgr之前，需要确保PostgreSQL的配置文件中启用了流复制和WAL归档。

编辑postgresql.conf文件，添加或修改以下配置：

wal_level = replica
max_wal_senders = 10
wal_keep_segments = 32
archive_mode = on
archive_command = 'cp %p /path/to/archive/%f'

编辑pg_hba.conf文件，允许复制用户进行连接：

host    replication     repmgr_user     192.168.1.0/24        md5

2.3 创建Repmgr用户

在主节点上创建一个用于复制的用户：

CREATE USER repmgr_user WITH REPLICATION ENCRYPTED PASSWORD 'repmgr_password';

3. Repmgr配置文件

repmgr的配置文件通常位于/etc/repmgr.conf或/etc/repmgr/<version>/repmgr.conf。以下是一个典型的repmgr.conf配置文件示例：

node_id=1
node_name=node1
conninfo='host=192.168.1.1 user=repmgr_user dbname=repmgr_db password=repmgr_password'
data_directory='/var/lib/postgresql/12/main'
pg_bindir='/usr/lib/postgresql/12/bin'
use_replication_slots=yes
failover=automatic
promote_command='/usr/bin/repmgr standby promote -f /etc/repmgr.conf --log-to-file'
follow_command='/usr/bin/repmgr standby follow -f /etc/repmgr.conf --log-to-file'
log_level=INFO
log_file='/var/log/repmgr/repmgr.log'

3.1 配置项说明

• node_id：节点的唯一标识符。
• node_name：节点的名称。
• conninfo：连接到PostgreSQL数据库的连接信息。
• data_directory：PostgreSQL数据目录。
• pg_bindir：PostgreSQL二进制文件目录。
• use_replication_slots：是否使用复制槽。
• failover：故障转移模式，automatic表示自动故障转移。
• promote_command：提升备节点为主节点的命令。
• follow_command：备节点跟随新主节点的命令。
• log_level：日志级别。
• log_file：日志文件路径。

4. Repmgr常用命令

repmgr提供了丰富的命令行工具，用于管理PostgreSQL集群。以下是一些常用的命令及其用法。

4.1 初始化主节点

在主节点上初始化repmgr：

repmgr -f /etc/repmgr.conf primary register

4.2 注册备节点

在备节点上注册到主节点：

repmgr -f /etc/repmgr.conf standby clone --upstream-node-id=1
repmgr -f /etc/repmgr.conf standby register

4.3 查看集群状态

查看当前集群的状态：

repmgr -f /etc/repmgr.conf cluster show

4.4 手动故障转移

手动触发故障转移，将备节点提升为主节点：

repmgr -f /etc/repmgr.conf standby promote

4.5 重新加入节点

将故障节点重新加入集群：

repmgr -f /etc/repmgr.conf node rejoin --force-rewind

4.6 删除节点

从集群中删除一个节点：

repmgr -f /etc/repmgr.conf node unregister --node-id=2

5. 故障检测与自动故障转移

repmgr通过定期检查主节点的健康状态来实现故障检测。当检测到主节点故障时，repmgr会自动触发故障转移，将备节点提升为新的主节点。

5.1 配置故障检测

在repmgr.conf中配置故障检测参数：

monitoring_interval=2
monitor_interval_async=10

5.2 自动故障转移

当主节点故障时，repmgr会自动执行promote_command，将备节点提升为主节点。同时，其他备节点会自动执行follow_command，跟随新的主节点。

6. 监控与日志

repmgr提供了详细的日志记录功能，便于监控和排查问题。

6.1 日志配置

在repmgr.conf中配置日志级别和日志文件路径：

log_level=INFO
log_file='/var/log/repmgr/repmgr.log'

6.2 监控工具

可以使用repmgr自带的监控工具查看集群状态：

repmgr -f /etc/repmgr.conf cluster show

7. 总结

repmgr是一个功能强大的工具，能够简化PostgreSQL高可用集群的管理。通过合理的配置和使用repmgr命令，您可以轻松实现PostgreSQL的自动故障转移、节点管理等功能，确保数据库系统的高可用性和稳定性。

本文详细介绍了repmgr的安装、配置、常用命令以及故障检测与自动故障转移的实现。希望这些内容能够帮助您更好地理解和应用repmgr，构建一个高可用的PostgreSQL集群。