首页
/ Yoke 项目启动与配置教程

Yoke 项目启动与配置教程

2025-05-25 23:58:56作者:申梦珏Efrain

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 的正常运行至关重要。

登录后查看全文