patroni

Patroni PostgreSQL 高可用管理

补充说明

Patroni 用分布式配置存储（etcd/Consul/ZooKeeper）管理 PostgreSQL 主备和自动故障切换。它负责选主、复制配置、pg_rewind 和 VIP/负载均衡回调。

常用示例

patroni /etc/patroni.yml
patronictl -c /etc/patroni.yml list
patronictl -c /etc/patroni.yml topology
patronictl -c /etc/patroni.yml switchover
patronictl -c /etc/patroni.yml failover
patronictl -c /etc/patroni.yml restart app
patronictl -c /etc/patroni.yml reinit app replica1
patronictl -c /etc/patroni.yml edit-config
patronictl -c /etc/patroni.yml show-config

易错点与排错

DCS（etcd/Consul）失去 quorum 时 Patroni 会停止自动切换；先恢复 DCS。
同步复制配置不当会影响可用性；评估 synchronous_mode 和 synchronous_node_count。
故障切换后旧主需要用 pg_rewind 重新加入；检查 pg_rewind 条件。
patronictl switchover 是计划内切换，failover 是强制切换；生产优先 switchover。
回调脚本（VIP/HAProxy）失败会导致流量切不过去；单独测试。
PostgreSQL 配置由 Patroni 管理，手改可能被覆盖。
监控 leader、复制延迟和 DCS 健康。

相关命令

patroni — 高可用管理
psql — 数据库连接
etcdctl — DCS 状态
pg_rewind — 备库回退

读完自测

合上页面，先回答，再展开对照。

DCS 失去 quorum 时 Patroni 会怎样？
计划内主库切换应该用哪个命令？
故障切换后旧主如何重新加入？

答案

停止自动切换，应先恢复 DCS。
patronictl switchover，failover 是强制切换。
用 pg_rewind 重新加入，并检查 pg_rewind 条件。