YugabyteDB 手动部署指南：启动 YB-Master 服务详解

YugabyteDB 手动部署指南：启动 YB-Master 服务详解

yugabyte-db yugabyte/yugabyte-db: 是 YugaByte DB 的官方仓库，一个高性能、高可扩展、分布式的 SQL 数据库，支持 PostgreSQL 兼容性。适合对分布式数据库、SQL 数据库和云原生应用的开发者。 项目地址: https://gitcode.com/gh_mirrors/yu/yugabyte-db

概述

在分布式数据库 YugabyteDB 的部署过程中，YB-Master 服务是整个集群的核心管理组件。本文将详细介绍如何手动启动 YB-Master 服务，包括配置参数解析、部署场景示例以及健康状态验证方法。

YB-Master 服务核心作用

YB-Master 是 YugabyteDB 集群的系统目录管理器，主要负责以下关键功能：

1. 维护所有表、分片（tablet）和副本的元数据信息
2. 协调集群范围的运维操作（如创建/删除表）
3. 管理分片到 YB-TServer 的分配
4. 处理集群成员变更和领导选举

典型部署场景

考虑一个六节点集群的部署案例：

• 复制因子：3（数据存储三副本）
• 节点角色分配：
  • 3个节点运行 YB-Master（必须等于复制因子）
  • 6个节点全部运行 YB-TServer
• 网络配置：
  • 三个 YB-Master 节点私有 IP：172.151.17.130、172.151.17.220、172.151.17.140
• 云环境配置：
  • 云平台：AWS
  • 区域：us-west
  • 可用区：us-west-2a、us-west-2b、us-west-2c（每个可用区部署两个节点）
• 存储配置：
  • 多个数据盘挂载在 /home/centos/disk1 和 /home/centos/disk2

命令行启动方式

在每个 YB-Master 节点上执行以下命令（注意替换 IP 地址为当前节点的实际地址）：

./bin/yb-master \
  --master_addresses 172.151.17.130:7100,172.151.17.220:7100,172.151.17.140:7100 \
  --rpc_bind_addresses 172.151.17.130:7100 \
  --fs_data_dirs "/home/centos/disk1,/home/centos/disk2" \
  --placement_cloud aws \
  --placement_region us-west \
  --placement_zone us-west-2a \
  >& /home/centos/disk1/yb-master.out &

关键参数解析

1. --master_addresses：指定所有 YB-Master 节点的地址列表，数量必须等于复制因子
2. --rpc_bind_addresses：设置当前节点的 RPC 绑定地址
3. --fs_data_dirs：指定数据存储目录，支持多目录以分散 I/O 负载
4. placement_ 参数*：定义节点的物理位置信息，用于智能数据放置

配置文件启动方式

对于生产环境，推荐使用配置文件方式管理参数：

1. 创建 master.conf 文件：

--master_addresses=172.151.17.130:7100,172.151.17.220:7100,172.151.17.140:7100
--rpc_bind_addresses=172.151.17.130:7100
--fs_data_dirs=/home/centos/disk1,/home/centos/disk2
--placement_cloud=aws
--placement_region=us-west
--placement_zone=us-west-2a

2. 通过 flagfile 参数启动：

./bin/yb-master --flagfile master.conf >& /home/centos/disk1/yb-master.out &

高级配置选项

1. 时间同步：对于需要高精度时钟的场景，可配置： --time_source=clockbound 这需要预先配置系统级的时间同步服务

2. 日志管理：默认日志路径位于 --fs_data_dirs 指定的第一个目录下的 yb-data/master/logs/ 中

服务健康验证

启动后，检查日志确认集群状态：

1. 查看日志文件：

   cat /home/centos/disk1/yb-data/master/logs/yb-master.INFO
   

2. 健康状态判断：

   • FOLLOWER 节点：日志中包含

     [sys.catalog]: This master's current role is: FOLLOWER
     

   • LEADER 节点：日志中包含

     [term X LEADER]: Becoming Leader. State: Replica: ...
     

生产环境建议

1. 自动重启：将启动命令添加到 cron 或使用进程监控工具，确保服务异常退出后能自动恢复
2. 多可用区部署：对于高可用场景，确保 YB-Master 节点分布在不同的可用区
3. 监控配置：设置适当的监控告警，关注领导选举状态和 Raft 共识健康度

后续步骤

成功启动 YB-Master 服务后，下一步是部署 [YB-TServer 服务]，完成完整的 YugabyteDB 集群搭建。

通过以上步骤，您已经掌握了 YugabyteDB 核心管理组件的部署方法。正确配置 YB-Master 服务是确保整个分布式数据库集群稳定运行的基础。

yugabyte-db yugabyte/yugabyte-db: 是 YugaByte DB 的官方仓库，一个高性能、高可扩展、分布式的 SQL 数据库，支持 PostgreSQL 兼容性。适合对分布式数据库、SQL 数据库和云原生应用的开发者。 项目地址: https://gitcode.com/gh_mirrors/yu/yugabyte-db