PostgreSQL集群中HAProxy和PgBouncer端口配置持久化方案

背景介绍

在PostgreSQL集群部署中，HAProxy和PgBouncer是常用的负载均衡和连接池组件。默认情况下，PostgreSQL集群部署工具会为这些服务分配标准端口，但在实际生产环境中，管理员可能需要修改这些端口以满足特定需求。

问题现象

当管理员尝试修改HAProxy和PgBouncer的监听端口后，发现这些修改在虚拟机重启后会丢失。具体表现为：

• HAProxy统计页面端口7000无法保持
• PgBouncer服务端口6432配置无法持久化

根本原因分析

这种配置丢失现象源于PostgreSQL集群的动态配置管理机制。集群使用confd服务来动态管理HAProxy的配置文件，这意味着直接修改/etc/haproxy/haproxy.cfg文件不是持久化的解决方案，因为confd会在特定条件下重新生成配置文件。

正确配置方法

1. 通过变量文件预先配置

在部署集群前，应在vars/main.yml文件中预先定义相关端口参数：

haproxy_listen_port:
  master: 5000
  replicas: 5001
  replicas_sync: 5002
  replicas_async: 5003
  pgbouncer: 6432
  stats: 7000

2. 修改confd模板文件

对于已经部署的集群，应修改confd的模板文件来实现持久化配置：

1. 定位到模板文件：/etc/confd/templates/haproxy.tmpl
2. 在适当位置添加或修改以下配置：

listen stats
    mode http
    bind {{ .HAProxyNode1IP }}:7000
    bind {{ .ControlNodeIP }}:7000
    stats enable
    stats uri /

frontend pgbouncer_frontend
    bind *:6432
    default_backend pgbouncer_backend
    option tcplog

backend pgbouncer_backend
    balance roundrobin
    option httpchk OPTIONS /primary
    http-check expect status 200
    default-server inter 3s fastinter 1s fall 3 rise 4 on-marked-down shutdown-sessions
    server pgnode01 {{ .PGNode1IP }}:6432 check port 8008
    server pgnode02 {{ .PGNode2IP }}:6432 check port 8008
    server pgnode03 {{ .PGNode3IP }}:6432 check port 8008

注意事项

1. 生产环境谨慎操作：直接修改模板文件属于高级操作，需要充分测试验证后再应用于生产环境
2. 配置备份：修改前应备份原始配置文件
3. 服务重启：修改后需要重启相关服务使配置生效
4. 版本兼容性：不同版本的PostgreSQL集群可能有不同的配置管理机制

最佳实践建议

1. 尽量在初始部署前完成所有端口规划
2. 如需修改，优先考虑通过官方提供的变量配置方式
3. 必须手动修改时，确保理解修改的影响范围
4. 建立配置变更文档，记录所有自定义修改

通过以上方法，可以确保HAProxy和PgBouncer的端口配置在系统重启后仍然保持有效，满足业务需求的同时保证服务的稳定性。