Yoke：PostgreSQL 高可用集群最佳实践

1. 项目介绍

Yoke 是一个 PostgreSQL 高可用性和自动故障转移解决方案。它提供了一个简单易管理的 PostgreSQL 集群，包含主节点、辅助节点和监控节点，确保数据库服务在出现故障时能够自动切换，保持服务的持续可用性。

2. 项目快速启动

环境准备

• 3 个服务器节点，分别作为主节点（primary）、辅助节点（secondary）和监控节点（monitor）。
• 主节点和辅助节点之间需要能够无密码 SSH 通信。
• 主节点和辅助节点需要安装 rsync（或其他同步命令）。
• 主节点和辅助节点上需要以 postgres 用户身份安装 PostgreSQL，并且 PostgreSQL 应在系统路径中。
• PostgreSQL 应作为子进程运行，不应独立启动。

配置文件

每个节点都需要一个配置文件（config.ini），以下为配置文件的基本选项：

[config]
advertise_ip = # 本节点向其他节点广播的 IP
advertise_port = 4400 # 本节点向其他节点广播的端口
data_dir = /data # PostgreSQL 数据目录
decision_timeout = 30 # 节点决定 PostgreSQL 实例状态的延时
log_level = warn # 日志级别
primary = # 主节点 IP:port
secondary = # 辅助节点 IP:port
monitor = # 监控节点 IP:port
role = # 节点角色（primary/secondary/monitor）
pg_port = 5432 # PostgreSQL 端口
status_dir = ./status # 节点状态信息存储目录
sync_command = rsync -ae "ssh -o StrictHostKeyChecking=no" --delete {{local_dir}} {{slave_ip}}:{{slave_dir}} # 数据同步命令
[vip]
ip = # 虚拟 IP
add_command = # 添加虚拟 IP 的命令
remove_command = # 移除虚拟 IP 的命令
[role_change]
command = # 节点角色变更时调用的命令

启动项目

配置完成后，通过以下命令启动 Yoke：

./yoke ./primary.ini

其中 primary.ini 是主节点的配置文件，文件名和路径可以自定义。

3. 应用案例和最佳实践

数据同步

确保 sync_command 配置正确，以便在主节点上同步数据到辅助节点。

故障转移

在监控节点上配置正确的 role_change 命令，以便在主节点故障时自动将辅助节点提升为新的主节点。

日志管理

根据需要调整 log_level，以便在开发和生产环境中获得适当的日志信息。

监控和运维

使用 Yoke 提供的 CLI 工具 yokeadm 进行集群状态查询和节点管理。

./yokeadm list # 查看集群状态
./yokeadm demote # 将节点降级

4. 典型生态项目

• Prometheus: 用于监控和告警的开源系统，可以与 Yoke 结合使用，监控 PostgreSQL 集群状态。
• Grafana: 用于可视化监控数据的开源平台，可以与 Prometheus 配合使用，展示 PostgreSQL 集群性能。
• Kubernetes: 用于自动部署、扩展和管理容器化应用程序的开源系统，可以将 Yoke 集群部署到 Kubernetes 中，实现自动化管理。