Proxy Parameters
The best way to load balance is to determine the current system state by service discovery (e.g., querying Consul metadata) and using smart clients to connect. However, load balancing and traffic access solutions usually vary by company, infrastructure, and R&D staff level. For presentation integrity reasons, a Haproxy and VIP-based load balancing solution is integrated into Pigsty.
Overview
#------------------------------------------------------------------------------
# PROXY PROVISION
#------------------------------------------------------------------------------
haproxy_enabled
haproxy_policy
haproxy_admin_auth_enabled
haproxy_admin_username
haproxy_admin_password
haproxy_client_timeout
haproxy_server_timeout
haproxy_exporter_port
haproxy_check_port
haproxy_primary_port
haproxy_replica_port
haproxy_backend_port
haproxy_weight
haproxy_weight_fallback
vip_enabled
vip_address
vip_cidrmask
vip_interface
Defaults
#------------------------------------------------------------------------------
# PROXY PROVISION
#------------------------------------------------------------------------------
# - haproxy - #
haproxy_enabled: true # enable haproxy among every cluster members
haproxy_policy: roundrobin # roundrobin, leastconn
haproxy_admin_auth_enabled: false # enable authentication for haproxy admin?
haproxy_admin_username: admin # default haproxy admin username
haproxy_admin_password: admin # default haproxy admin password
haproxy_client_timeout: 3h # client side connection timeout
haproxy_server_timeout: 3h # server side connection timeout
haproxy_exporter_port: 9101 # default admin/exporter port
haproxy_check_port: 8008 # default health check port (patroni 8008 by default)
haproxy_primary_port: 5433 # default primary port 5433
haproxy_replica_port: 5434 # default replica port 5434
haproxy_backend_port: 6432 # default target port: pgbouncer:6432 postgres:5432
haproxy_weight: 100 # default weight for load balancer
haproxy_weight_fallback: 1 # assign a small weight for primary in replica service
# (in case of singleton replica failure, primary can still take read-only )
# - vip - #
# vip_enabled: true # level2 vip requires primary/standby under same switch
# vip_address: 127.0.0.1 # virtual ip address ip/cidr
# vip_cidrmask: 32 # virtual ip address cidr mask
# vip_interface: eth0 # virtual ip network interface
Reference
haproxy_enabled
是否启用Haproxy组件
Pigsty默认会在所有数据库节点上部署Haproxy，您可以通过覆盖实例级变量，仅在特定实例/节点上启用Haproxy负载均衡器。
haproxy_policy
haproxy负载均衡所使用的算法，可选策略为roundrobin与leastconn
默认为roundrobin
haproxy_admin_auth_enabled
是否启用为Haproxy管理界面启用基本认证
默认不启用，建议在生产环境启用，或在Nginx或其他接入层添加访问控制。
haproxy_admin_username
启用Haproxy管理界面认证默认用户名，默认为admin
haproxy_admin_password
启用Haproxy管理界面认证默认密码，默认为admin
haproxy_client_timeout
Haproxy客户端连接超时，默认为3小时
haproxy_server_timeout
Haproxy服务端连接超时，默认为3小时
haproxy_exporter_port
Haproxy管理界面与监控指标暴露端点所监听的端口。
默认端口为9101
haproxy_check_port
Haproxy对后端PostgreSQL进程执行健康检查的端口。
默认端口为8008，即Patroni的端口。
其他的选项包括9630，即使用pg_exporter作为健康检查的端口。
haproxy_primary_port
Haproxy中集群读写服务默认端口，所有链接至该端口的客户端链接都会被转发至主实例的对应端口。
默认读写服务的端口为5433
haproxy_replica_port
Haproxy中集群只读服务默认端口，所有链接至该端口的客户端链接都会被转发至主从例的对应端口。
默认读写服务的端口为5434
haproxy_backend_port
Haproxy将客户端连接转发至后端的对应端口，可选：5432/6432
默认为6432，即Haproxy会将流量转发至6432连接池端口，修改为5432表示直接将流量转发至数据库。
haproxy_weight
Haproxy进行负载均衡时的标准权重，默认为100，建议在实例层次进行覆盖。
haproxy_weight_fallback
用于控制主库承载只读流量的权重。
如果haproxy_weight_fallback为0，主库不会承担任何只读流量（发送至haproxy_replica_port）。
如果haproxy_weight_fallback为1（或更高的值时），在集群正常工作时，主库会在从库服务集中承担 1/总权重 的微小流量，而当从库集中所有的只读实例故障时，只读流量可以漂移至主库承载。
该配置对于一主一从的情况非常实用，如果您有多台从库，建议将其配置为0。
vip_enabled
是否启用VIP
VIP用于确保读写服务与负载均衡器的高可用，Pigsty的VIP由vip-manager托管，会绑定在集群主库上。
这意味着您始终可以通过VIP访问集群主库，或者通过VIP访问主库上的负载均衡器（如果主库的压力很大，这样做可能会有性能压力）。
注意，您必须保证VIP候选实例处于同一个二层网络（VLAN、交换机）下。
vip_address
VIP地址
vip_address没有默认值，您必须为每一个集群显式指定并分配VIP地址
vip_cidrmask
VIP的CIDR网络长度
vip_cidrmask没有默认值，您必须为每一个集群显式指定VIP的网络CIDR。
vip_interface
VIP网卡名称
默认为eth0