1. 为什么选择repmgr搭建PostgreSQL高可用集群在数据库运维领域高可用性(High Availability)是保证业务连续性的关键要素。PostgreSQL作为一款功能强大的开源关系型数据库其原生支持流复制(Streaming Replication)机制这为构建高可用架构奠定了基础。然而原生的流复制缺乏自动故障检测和切换能力这正是repmgr工具大显身手的地方。repmgr是一个专门为PostgreSQL设计的开源集群管理工具它通过以下核心功能增强了PostgreSQL的流复制能力自动化节点注册与集群状态监控支持手动和自动故障转移(Failover)提供节点重新加入(Rejoin)机制维护集群元数据信息与Patroni等同类工具相比repmgr的优势在于其轻量级和简单性。它不需要额外的分布式协调服务(如etcd或ZooKeeper)而是通过每个节点上运行的repmgrd守护进程来监控集群状态。这种设计使得repmgr特别适合中小规模的生产环境也是我推荐在3节点集群中使用的关键原因。2. 环境准备与规划2.1 硬件与系统要求在开始部署前我们需要准备3台服务器建议配置如下操作系统CentOS 7.9或Ubuntu 20.04 LTSCPU4核以上内存8GB以上存储SSD硬盘至少50GB可用空间网络节点间延迟1ms建议千兆内网互联对于我们的3节点集群规划如下节点1 (pg-node1): 初始主节点IP 192.168.1.101节点2 (pg-node2): 备节点1IP 192.168.1.102节点3 (pg-node3): 备节点2IP 192.168.1.1032.2 软件版本选择根据实际生产经验我推荐以下版本组合PostgreSQL: 14.5 (长期支持版本)repmgr: 5.3.3 (稳定版本避免使用最新的5.4.1已知有安装问题)注意在生产环境中强烈建议所有节点使用相同版本的操作系统和软件以避免兼容性问题。2.3 系统基础配置在所有节点上执行以下配置创建postgres用户useradd postgres passwd postgres配置SSH互信用于后续切换操作su - postgres ssh-keygen -t rsa ssh-copy-id postgrespg-node1 ssh-copy-id postgrespg-node2 ssh-copy-id postgrespg-node3安装必要依赖yum install -y readline readline-devel zlib zlib-devel openssl openssl-devel \ pam pam-devel libxml2 libxml2-devel libxslt libxslt-devel \ perl perl-devel libcurl-devel libicu libicu-devel tcl-devel \ uuid-devel gcc gcc-c make flex bison perl-ExtUtils*3. PostgreSQL与repmgr安装配置3.1 PostgreSQL安装与初始化在所有节点上编译安装PostgreSQLwget https://ftp.postgresql.org/pub/source/v14.5/postgresql-14.5.tar.gz tar -xzvf postgresql-14.5.tar.gz cd postgresql-14.5 ./configure --prefix/usr/local/pgsql make make install在主节点(pg-node1)初始化数据库mkdir -p /data/pgdata chown postgres:postgres /data/pgdata su - postgres /usr/local/pgsql/bin/initdb -D /data/pgdata --data-checksums -E UTF83.2 主节点参数配置编辑主节点的postgresql.confvi /data/pgdata/postgresql.conf # 修改以下参数 listen_addresses * port 5432 max_connections 1000 wal_level replica archive_mode on archive_command test ! -f /data/pg_archive/%f cp %p /data/pg_archive/%f max_wal_senders 10 wal_keep_size 1024 hot_standby on wal_log_hints on shared_preload_libraries repmgr配置pg_hba.conf允许复制连接vi /data/pgdata/pg_hba.conf # 添加以下行 host replication repuser 192.168.1.101/32 trust host replication repuser 192.168.1.102/32 trust host replication repuser 192.168.1.103/32 trust host all all 0.0.0.0/0 scram-sha-256启动主节点PostgreSQL服务/usr/local/pgsql/bin/pg_ctl -D /data/pgdata start3.3 repmgr安装与配置在所有节点上安装repmgrwget https://repmgr.org/download/repmgr-5.3.3.tar.gz tar -xzvf repmgr-5.3.3.tar.gz cd repmgr-5.3.3 ./configure --prefix/usr/local/repmgr PG_CONFIG/usr/local/pgsql/bin/pg_config make make install在主节点创建repmgr元数据库和用户/usr/local/pgsql/bin/psql -c CREATE USER repmgr SUPERUSER PASSWORD repmgr; /usr/local/pgsql/bin/psql -c CREATE DATABASE repmgr OWNER repmgr; /usr/local/pgsql/bin/psql -c CREATE USER repuser REPLICATION;配置.pgpass文件所有节点vi ~/.pgpass *:5432:repmgr:repmgr:repmgr *:5432:postgres:postgres:postgres chmod 600 ~/.pgpass4. 3节点集群搭建实战4.1 主节点注册在主节点创建repmgr配置文件mkdir -p /etc/repmgr vi /etc/repmgr/repmgr.conf node_id1 node_namepg-node1 conninfohost192.168.1.101 port5432 userrepmgr passwordrepmgr dbnamerepmgr connect_timeout3 data_directory/data/pgdata replication_userrepuser replication_typephysical repmgr_bindir/usr/local/pgsql/bin pg_bindir/usr/local/pgsql/bin failoverautomatic log_file/var/log/repmgr.log注册主节点/usr/local/repmgr/bin/repmgr -f /etc/repmgr/repmgr.conf primary register验证注册/usr/local/repmgr/bin/repmgr -f /etc/repmgr/repmgr.conf cluster show4.2 备节点配置与加入在两个备节点上执行克隆操作/usr/local/repmgr/bin/repmgr -h 192.168.1.101 -U repmgr -d repmgr -f /etc/repmgr/repmgr.conf standby clone启动备节点PostgreSQL服务/usr/local/pgsql/bin/pg_ctl -D /data/pgdata start注册备节点/usr/local/repmgr/bin/repmgr -f /etc/repmgr/repmgr.conf standby register4.3 启动repmgrd守护进程在所有节点上配置repmgrd服务vi /etc/repmgr/repmgr.conf # 添加以下配置 repmgrd_service_start_command/usr/local/repmgr/bin/repmgrd -f /etc/repmgr/repmgr.conf -p /var/run/repmgrd.pid -d --verbose repmgrd_service_stop_commandkill cat /var/run/repmgrd.pid connection_check_typeping reconnect_attempts3 reconnect_interval5 promote_command/usr/local/repmgr/bin/repmgr standby promote -f /etc/repmgr/repmgr.conf --log-to-file follow_command/usr/local/repmgr/bin/repmgr standby follow -f /etc/repmgr/repmgr.conf --log-to-file --upstream-node-id%n创建systemd服务文件vi /etc/systemd/system/repmgrd.service [Unit] Descriptionrepmgr daemon Afterpostgresql.service [Service] Userpostgres Grouppostgres Typeforking ExecStart/usr/local/repmgr/bin/repmgrd -f /etc/repmgr/repmgr.conf -p /var/run/repmgrd.pid -d ExecStopkill cat /var/run/repmgrd.pid Restartalways [Install] WantedBymulti-user.target启动并启用服务systemctl daemon-reload systemctl enable repmgrd systemctl start repmgrd5. 集群管理与故障切换测试5.1 日常管理命令查看集群状态repmgr -f /etc/repmgr/repmgr.conf cluster show检查节点状态repmgr -f /etc/repmgr/repmgr.conf node status查看事件日志repmgr -f /etc/repmgr/repmgr.conf cluster event5.2 手动切换(Switchover)测试在备节点上执行手动切换repmgr -f /etc/repmgr/repmgr.conf standby switchover切换过程详解验证当前主备状态停止主节点PostgreSQL服务提升目标备节点为新主节点重新配置原主节点为备节点并加入集群更新其他备节点指向新主节点5.3 自动故障转移(Failover)测试模拟主节点故障# 在主节点上 pg_ctl -D /data/pgdata stop观察自动故障转移repmgrd检测到主节点不可用备节点间进行选举基于LSN、优先级和节点ID选举出的备节点自动提升为新主节点其他备节点自动重新指向新主节点恢复原主节点repmgr -f /etc/repmgr/repmgr.conf node rejoin --force-rewind6. 生产环境优化与注意事项6.1 监控与告警配置建议配置以下监控项节点复制延迟集群节点状态repmgrd进程状态自动故障转移事件可以使用Prometheus Grafana搭建监控系统关键指标包括pg_replication_lagrepmgr_nodes_statusrepmgr_events_count6.2 常见问题排查问题1备节点无法加入集群可能原因主备节点PostgreSQL版本不一致网络连接问题认证配置错误(pg_hba.conf)复制槽冲突解决方案# 检查日志获取详细错误 tail -f /data/pgdata/log/postgresql-*.log # 验证网络连接 psql -h 主节点IP -U repmgr -d repmgr -c SELECT 1 # 检查复制用户权限 psql -c SELECT * FROM pg_roles WHERE rolname repuser;问题2自动故障转移不触发可能原因repmgrd服务未运行连接检查配置不正确选举超时解决方案# 检查repmgrd服务状态 systemctl status repmgrd # 验证连接检查配置 grep connection_check_type /etc/repmgr/repmgr.conf # 增加日志级别调试 repmgrd -f /etc/repmgr/repmgr.conf --log-levelDEBUG6.3 性能优化建议调整WAL相关参数wal_buffers 16MB max_wal_size 2GB min_wal_size 1GB优化复制性能max_replication_slots 10 max_wal_senders 10 wal_keep_size 2048MB定期维护# 在维护窗口期执行 vacuumdb -a -z reindexdb -a7. 扩展思考3节点集群的特殊考量在3节点配置中我们面临一个重要的设计决策是否引入见证节点(Witness Node)。见证节点不存储数据仅参与选举投票可以防止网络分区时的脑裂问题。对于关键业务系统我建议的3节点部署模式为1个主节点(读写)1个同步备节点(同步复制)1个异步备节点或见证节点这种配置既保证了数据安全性(同步复制)又提供了故障转移的仲裁机制。要配置同步复制可以在主节点的postgresql.conf中添加synchronous_standby_names pg-node2在实际操作中我发现3节点集群的最佳实践包括将节点分布在不同的机架或可用区配置适当的监控检查间隔(通常5-10秒)定期测试故障转移流程维护详细的切换操作手册记住任何高可用架构都需要定期测试才能确保其可靠性。我建议至少每季度进行一次完整的故障转移演练包括自动和手动切换场景。
1. 为什么选择repmgr搭建PostgreSQL高可用集群在数据库运维领域高可用性(High Availability)是保证业务连续性的关键要素。PostgreSQL作为一款功能强大的开源关系型数据库其原生支持流复制(Streaming Replication)机制这为构建高可用架构奠定了基础。然而原生的流复制缺乏自动故障检测和切换能力这正是repmgr工具大显身手的地方。repmgr是一个专门为PostgreSQL设计的开源集群管理工具它通过以下核心功能增强了PostgreSQL的流复制能力自动化节点注册与集群状态监控支持手动和自动故障转移(Failover)提供节点重新加入(Rejoin)机制维护集群元数据信息与Patroni等同类工具相比repmgr的优势在于其轻量级和简单性。它不需要额外的分布式协调服务(如etcd或ZooKeeper)而是通过每个节点上运行的repmgrd守护进程来监控集群状态。这种设计使得repmgr特别适合中小规模的生产环境也是我推荐在3节点集群中使用的关键原因。2. 环境准备与规划2.1 硬件与系统要求在开始部署前我们需要准备3台服务器建议配置如下操作系统CentOS 7.9或Ubuntu 20.04 LTSCPU4核以上内存8GB以上存储SSD硬盘至少50GB可用空间网络节点间延迟1ms建议千兆内网互联对于我们的3节点集群规划如下节点1 (pg-node1): 初始主节点IP 192.168.1.101节点2 (pg-node2): 备节点1IP 192.168.1.102节点3 (pg-node3): 备节点2IP 192.168.1.1032.2 软件版本选择根据实际生产经验我推荐以下版本组合PostgreSQL: 14.5 (长期支持版本)repmgr: 5.3.3 (稳定版本避免使用最新的5.4.1已知有安装问题)注意在生产环境中强烈建议所有节点使用相同版本的操作系统和软件以避免兼容性问题。2.3 系统基础配置在所有节点上执行以下配置创建postgres用户useradd postgres passwd postgres配置SSH互信用于后续切换操作su - postgres ssh-keygen -t rsa ssh-copy-id postgrespg-node1 ssh-copy-id postgrespg-node2 ssh-copy-id postgrespg-node3安装必要依赖yum install -y readline readline-devel zlib zlib-devel openssl openssl-devel \ pam pam-devel libxml2 libxml2-devel libxslt libxslt-devel \ perl perl-devel libcurl-devel libicu libicu-devel tcl-devel \ uuid-devel gcc gcc-c make flex bison perl-ExtUtils*3. PostgreSQL与repmgr安装配置3.1 PostgreSQL安装与初始化在所有节点上编译安装PostgreSQLwget https://ftp.postgresql.org/pub/source/v14.5/postgresql-14.5.tar.gz tar -xzvf postgresql-14.5.tar.gz cd postgresql-14.5 ./configure --prefix/usr/local/pgsql make make install在主节点(pg-node1)初始化数据库mkdir -p /data/pgdata chown postgres:postgres /data/pgdata su - postgres /usr/local/pgsql/bin/initdb -D /data/pgdata --data-checksums -E UTF83.2 主节点参数配置编辑主节点的postgresql.confvi /data/pgdata/postgresql.conf # 修改以下参数 listen_addresses * port 5432 max_connections 1000 wal_level replica archive_mode on archive_command test ! -f /data/pg_archive/%f cp %p /data/pg_archive/%f max_wal_senders 10 wal_keep_size 1024 hot_standby on wal_log_hints on shared_preload_libraries repmgr配置pg_hba.conf允许复制连接vi /data/pgdata/pg_hba.conf # 添加以下行 host replication repuser 192.168.1.101/32 trust host replication repuser 192.168.1.102/32 trust host replication repuser 192.168.1.103/32 trust host all all 0.0.0.0/0 scram-sha-256启动主节点PostgreSQL服务/usr/local/pgsql/bin/pg_ctl -D /data/pgdata start3.3 repmgr安装与配置在所有节点上安装repmgrwget https://repmgr.org/download/repmgr-5.3.3.tar.gz tar -xzvf repmgr-5.3.3.tar.gz cd repmgr-5.3.3 ./configure --prefix/usr/local/repmgr PG_CONFIG/usr/local/pgsql/bin/pg_config make make install在主节点创建repmgr元数据库和用户/usr/local/pgsql/bin/psql -c CREATE USER repmgr SUPERUSER PASSWORD repmgr; /usr/local/pgsql/bin/psql -c CREATE DATABASE repmgr OWNER repmgr; /usr/local/pgsql/bin/psql -c CREATE USER repuser REPLICATION;配置.pgpass文件所有节点vi ~/.pgpass *:5432:repmgr:repmgr:repmgr *:5432:postgres:postgres:postgres chmod 600 ~/.pgpass4. 3节点集群搭建实战4.1 主节点注册在主节点创建repmgr配置文件mkdir -p /etc/repmgr vi /etc/repmgr/repmgr.conf node_id1 node_namepg-node1 conninfohost192.168.1.101 port5432 userrepmgr passwordrepmgr dbnamerepmgr connect_timeout3 data_directory/data/pgdata replication_userrepuser replication_typephysical repmgr_bindir/usr/local/pgsql/bin pg_bindir/usr/local/pgsql/bin failoverautomatic log_file/var/log/repmgr.log注册主节点/usr/local/repmgr/bin/repmgr -f /etc/repmgr/repmgr.conf primary register验证注册/usr/local/repmgr/bin/repmgr -f /etc/repmgr/repmgr.conf cluster show4.2 备节点配置与加入在两个备节点上执行克隆操作/usr/local/repmgr/bin/repmgr -h 192.168.1.101 -U repmgr -d repmgr -f /etc/repmgr/repmgr.conf standby clone启动备节点PostgreSQL服务/usr/local/pgsql/bin/pg_ctl -D /data/pgdata start注册备节点/usr/local/repmgr/bin/repmgr -f /etc/repmgr/repmgr.conf standby register4.3 启动repmgrd守护进程在所有节点上配置repmgrd服务vi /etc/repmgr/repmgr.conf # 添加以下配置 repmgrd_service_start_command/usr/local/repmgr/bin/repmgrd -f /etc/repmgr/repmgr.conf -p /var/run/repmgrd.pid -d --verbose repmgrd_service_stop_commandkill cat /var/run/repmgrd.pid connection_check_typeping reconnect_attempts3 reconnect_interval5 promote_command/usr/local/repmgr/bin/repmgr standby promote -f /etc/repmgr/repmgr.conf --log-to-file follow_command/usr/local/repmgr/bin/repmgr standby follow -f /etc/repmgr/repmgr.conf --log-to-file --upstream-node-id%n创建systemd服务文件vi /etc/systemd/system/repmgrd.service [Unit] Descriptionrepmgr daemon Afterpostgresql.service [Service] Userpostgres Grouppostgres Typeforking ExecStart/usr/local/repmgr/bin/repmgrd -f /etc/repmgr/repmgr.conf -p /var/run/repmgrd.pid -d ExecStopkill cat /var/run/repmgrd.pid Restartalways [Install] WantedBymulti-user.target启动并启用服务systemctl daemon-reload systemctl enable repmgrd systemctl start repmgrd5. 集群管理与故障切换测试5.1 日常管理命令查看集群状态repmgr -f /etc/repmgr/repmgr.conf cluster show检查节点状态repmgr -f /etc/repmgr/repmgr.conf node status查看事件日志repmgr -f /etc/repmgr/repmgr.conf cluster event5.2 手动切换(Switchover)测试在备节点上执行手动切换repmgr -f /etc/repmgr/repmgr.conf standby switchover切换过程详解验证当前主备状态停止主节点PostgreSQL服务提升目标备节点为新主节点重新配置原主节点为备节点并加入集群更新其他备节点指向新主节点5.3 自动故障转移(Failover)测试模拟主节点故障# 在主节点上 pg_ctl -D /data/pgdata stop观察自动故障转移repmgrd检测到主节点不可用备节点间进行选举基于LSN、优先级和节点ID选举出的备节点自动提升为新主节点其他备节点自动重新指向新主节点恢复原主节点repmgr -f /etc/repmgr/repmgr.conf node rejoin --force-rewind6. 生产环境优化与注意事项6.1 监控与告警配置建议配置以下监控项节点复制延迟集群节点状态repmgrd进程状态自动故障转移事件可以使用Prometheus Grafana搭建监控系统关键指标包括pg_replication_lagrepmgr_nodes_statusrepmgr_events_count6.2 常见问题排查问题1备节点无法加入集群可能原因主备节点PostgreSQL版本不一致网络连接问题认证配置错误(pg_hba.conf)复制槽冲突解决方案# 检查日志获取详细错误 tail -f /data/pgdata/log/postgresql-*.log # 验证网络连接 psql -h 主节点IP -U repmgr -d repmgr -c SELECT 1 # 检查复制用户权限 psql -c SELECT * FROM pg_roles WHERE rolname repuser;问题2自动故障转移不触发可能原因repmgrd服务未运行连接检查配置不正确选举超时解决方案# 检查repmgrd服务状态 systemctl status repmgrd # 验证连接检查配置 grep connection_check_type /etc/repmgr/repmgr.conf # 增加日志级别调试 repmgrd -f /etc/repmgr/repmgr.conf --log-levelDEBUG6.3 性能优化建议调整WAL相关参数wal_buffers 16MB max_wal_size 2GB min_wal_size 1GB优化复制性能max_replication_slots 10 max_wal_senders 10 wal_keep_size 2048MB定期维护# 在维护窗口期执行 vacuumdb -a -z reindexdb -a7. 扩展思考3节点集群的特殊考量在3节点配置中我们面临一个重要的设计决策是否引入见证节点(Witness Node)。见证节点不存储数据仅参与选举投票可以防止网络分区时的脑裂问题。对于关键业务系统我建议的3节点部署模式为1个主节点(读写)1个同步备节点(同步复制)1个异步备节点或见证节点这种配置既保证了数据安全性(同步复制)又提供了故障转移的仲裁机制。要配置同步复制可以在主节点的postgresql.conf中添加synchronous_standby_names pg-node2在实际操作中我发现3节点集群的最佳实践包括将节点分布在不同的机架或可用区配置适当的监控检查间隔(通常5-10秒)定期测试故障转移流程维护详细的切换操作手册记住任何高可用架构都需要定期测试才能确保其可靠性。我建议至少每季度进行一次完整的故障转移演练包括自动和手动切换场景。
