Patroni是一个模板,您可以使用Python创建自己的定制化、高可用性解决方案,并为最大的可访问性提供分布式配置存储,如ZooKeeper、etcd、Consul或Kubernetes。希望在数据中心或其他任何地方快速部署 HA PostgreSQL的数据库工程师、DBA、DevOps 工程师和 SRE会发现它很有用。我们称 Patroni 为“模板”,因为它远非一刀切或即插即用的复制系统(replication system)。It will have its own caveats. Use wisely. 使用PostgreSQL运行高可用性的方法有很多;有关列表,请参阅PostgreSQL 文档。Patroni当前支持的 PostgreSQL 版本:9.3 到 14。
Kubernetes 用户注意事项:Patroni 可以在 Kubernetes 之上本地运行。请查看 Patroni 文档的Kubernetes章节。
Patroni 起源于Compose项目Governor的一个分支,包括许多新功能。有关使用 Patroni 的基于 Docker 的部署示例,请参阅目前在 Zalando 使用的Spilo 。有关其他背景信息,请参阅:
Patroni 正在积极开发并接受捐款。有关更多详细信息,请参阅下面的贡献部分。
Mac OS 的先决条件
要在 Mac 上安装要求,请运行以下命令:brew install postgresql etcd haproxy libyaml python
Psycopg
从psycopg2-2.8开始,默认情况下将不再安装 psycopg2 的二进制版本。从源代码安装它需要 C 编译器和 postgres+python 开发包。由于在 python 世界中,无法指定依赖项(psycopg2 OR psycopg2-binary),因为您必须决定如何安装它。有几个选项可用:
使用发行版中的包管理器
sudo apt-get install python-psycopg2 # install python2 psycopg2 module on Debian/Ubuntu
sudo apt-get install python3-psycopg2 # install python3 psycopg2 module on Debian/Ubuntu
sudo yum install python-psycopg2 # install python2 psycopg2 on RedHat/Fedora/CentOS
从二进制包安装 psycopg2 pip install psycopg2-binary
从源代码安装 psycopg2 pip install psycopg2>=2.5.4
使用 psycopg 3.0 而不是 psycopg2 pip install psycopg[binary]>=3.0.0
pip安装
Patroni 可以用 pip 安装:pip install patroni[dependencies]
其中依赖项可以为空,也可以由以下一项或多项组成:
etcd 或 etcd3:python-etcd模块,以便将 Etcd 用作 DCS
consul:python-consul模块,以便将 Consul 用作 DCS
zookeeper:kazoo模块,以便将 Zookeeper 用作 DCS
exhibitor:kazoo模块,以便将 Exhibitor 用作 DCS(与 Zookeeper 相同的依赖项)
kubernetes:kubernetes模块,以便在 Patroni 中使用 Kubernetes 作为 DCS
raft:pysyncobj模块,以便使用 python Raft 实现作为 DCS
aws:boto为了使用 AWS 回调
例如,为了将 Patroni 与 Etcd 的依赖项一起安装为 DCS 和 AWS 回调的命令是:pip install patroni[etcd,aws]
请注意,调用副本创建或自定义引导脚本(即 WAL-E)的外部工具应独立于 Patroni 安装。
Patroni/PostgreSQL 节点与 DCS 节点解耦(Patroni 自己实现 RAFT 时除外),因此对最小节点数没有要求。运行一个由一个主服务器和一个备用服务器组成的集群是非常好的。您可以稍后添加更多备用节点。
以下部分假设 Patroni 存储库是从https://github.com/zalando/patroni克隆的。也就是说,您将需要示例配置文件postgres0.yml和postgres1.yml。如果您使用 pip 安装了 Patroni,您可以从 git 存储库中获取这些文件,并将下面的./patroni.py 替换为 patroni命令。
要开始,请从不同的终端执行以下操作:
> etcd --data-dir=data/etcd --enable-v2=true
> ./patroni.py postgres0.yml
> ./patroni.py postgres1.yml
然后,您将看到一个高可用性集群启动。测试 YAML 文件中的不同设置以查看集群的行为如何变化。杀死一些组件以查看系统的行为。添加更多postgres*.yml文件以创建更大的集群。
Patroni 提供了一个HAProxy配置,它将为您的应用程序提供一个用于连接到集群领导者的端点。要配置,请运行:
> haproxy -f haproxy.cfg
> psql --host 127.0.0.1 --port 5000 postgres
转到此处以获取有关 etcd、consul 和 ZooKeeper 设置的全面信息。例如,请参阅postgres0.yml。
转到此处以获取有关通过环境变量配置(覆盖)设置的全面信息。
Patroni 使用 Postgres 的流复制,默认是异步的。Patroni 的异步复制配置允许maximum_lag_on_failover设置。此设置确保如果跟随者落后于领导者超过一定数量的字节,则不会发生故障转移。此设置应根据业务需求增加或减少。也可以使用同步复制来获得更好的持久性保证。有关详细信息,请参阅复制模式文档。
从应用程序连接时,请始终使用非超级用户。Patroni 需要访问数据库才能正常运行。通过使用应用程序中的超级用户,您可以使用该superuser_reserved_connections设置潜在地使用整个连接池,包括为超级用户保留的连接。如果 Patroni 由于连接池已满而无法访问主节点,则行为将是不可取的。
测试 HA 解决方案是一个耗时的过程,有很多变数。考虑到跨平台应用程序尤其如此。您需要经过培训的系统管理员或顾问来完成这项工作。这不是我们可以在文档中深入介绍的内容。
也就是说,这里有一些你应该确保测试的基础设施:
https://patroni.readthedocs.io/en/latest/