Yoke 项目启动与配置教程

1. 项目目录结构及介绍

Yoke 是一个为 PostgreSQL 提供高可用性和自动故障转移的解决方案。项目目录结构如下：

yoke/
├── config/              # 配置文件模板目录
├── monitor/             # 监控器相关代码
├── site/                # 网站和文档相关文件
├── state/               # 状态管理相关代码
├── yokeadm/             # Yoke 命令行界面程序
├── .gitignore           # Git 忽略文件列表
├── .travis.yml          # Travis CI 配置文件
├── LICENSE              # 项目许可证文件
├── README.md            # 项目自述文件
├── c.conf               # 配置文件示例
├── main.go              # 主程序文件
└── update_mocks.sh      # 更新模拟文件的脚本

• config/: 包含项目的配置文件模板。
• monitor/: 包含监控器组件的代码，用于监控集群状态。
• site/: 包含项目网站和文档的静态文件。
• state/: 包含状态管理组件的代码。
• yokeadm/: 包含 Yoke 命令行界面程序的代码。
• .gitignore: 指定 Git 忽略跟踪的文件和目录。
• .travis.yml: 配置 Travis CI 的自动化构建流程。
• LICENSE: 项目使用的许可证信息。
• README.md: 项目描述和基本信息。
• c.conf: 提供了一个配置文件的示例。
• main.go: Yoke 主程序的入口文件。
• update_mocks.sh: 脚本用于更新模拟的依赖。

2. 项目的启动文件介绍

Yoke 项目的启动主要通过 main.go 文件进行。该文件是 Go 程序的入口点，负责初始化和启动 Yoke 服务。以下是一些关键步骤：

• 解析命令行参数和配置文件。
• 设置日志记录级别。
• 初始化集群状态管理器。
• 启动集群监控器。
• 根据配置文件启动 PostgreSQL 实例。

3. 项目的配置文件介绍

Yoke 使用 config.ini 文件进行配置。这个文件定义了集群的参数，包括节点角色、网络设置、数据目录、同步命令等。以下是一个配置文件的示例结构：

[config]
advertise_ip = 192.168.1.1
advertise_port = 4400
data_dir = /data/postgres
decision_timeout = 30
log_level = info
primary = role=primary_ip:4400
secondary = role=secondary_ip:4400
monitor = role=monitor_ip:4400
role = primary

[pg]
pg_port = 5432
status_dir = ./status

[sync]
sync_command = rsync -ae "ssh -o StrictHostKeyChecking=no" --delete /data/postgres/ slave_ip:/data/postgres/

[vip]
ip = 192.168.1.100
add_command = /sbin/ip addr add {{vip}} dev eth0
remove_command = /sbin/ip addr del {{vip}} dev eth0

[role_change]
command = /usr/local/bin/role_change.sh

配置文件中各个部分的含义如下：

• [config]: 基本配置，包括节点的 IP 地址、端口、数据目录等。
• [pg]: PostgreSQL 相关配置，如端口和状态目录。
• [sync]: 数据同步命令配置。
• [vip]: 虚拟 IP 地址配置，用于高可用性。
• [role_change]: 角色变更时执行的命令。

正确配置 config.ini 文件对于 Yoke 的正常运行至关重要。