服务注册与分布式协调 / 系统课时

增量加入新的投票成员

增量加入新的投票成员

本课把一个全新的 ZooKeeper 节点安全加入现有 ensemble,并让它最终成为 participant。关键不是直接执行 reconfig,而是先让新节点找到当前 Leader、同步到已提交状态,再以条件化重配置完成成员切换,最后用配置读取和真实写请求确认新多数派已经生效。

学习目标

  • 能为新节点准备唯一的 myid、仲裁端口、选举端口和客户端端口
  • 能使用增量 reconfig -add 将新节点加入为 participant
  • 能验证配置传播、数据同步以及加入前后的多数派变化

加入前先确认多数派和重配置条件

简单多数派集群中,N 个投票成员提交事务所需的最小票数为 floor(N/2)+1。例如 3 节点集群需要 2 票;加入第 4 个 participant 后需要 3 票。扩容并不会自动提高故障容忍度:3 节点和 4 节点都只能容忍 1 个投票成员不可用。

执行前还要确认现有集群健康、reconfigEnabled=true 已启用,并且当前身份具备执行重配置的权限。生产环境不要为了省事开启 skipACL;若 CLI 返回 Insufficient permission,应修复认证与 ACL,而不是绕过权限检查。

新增投票成员的安全重配置流程

先让新节点同步现有集群

假设当前成员是 zk1、zk2、zk3,准备加入 zk4,其服务器 ID 为 4。新节点的 dataDir/myid 必须写入 4,并确保仲裁端口 2888、选举端口 3888 和客户端端口 2181 不会与本机其他实例冲突。

新节点首次启动时,可以把当前已提交成员和自身一起写入初始配置,并暂时把自身列为 observer。这个角色只用于安全引导:它能帮助新节点找到现有 Leader,又避免多个待加入节点意外自行形成投票多数派。

properties
tickTime=2000
dataDir=/data/zookeeper
initLimit=10
syncLimit=5
reconfigEnabled=true

server.1=zk1:2888:3888:participant;2181
server.2=zk2:2888:3888:participant;2181
server.3=zk3:2888:3888:participant;2181
server.4=zk4:2888:3888:observer;2181

这份初始配置的目标不是把 zk4 直接变成正式 observer,而是让它先连接现有 ensemble。启动后应从日志或监控确认 zk4 已连接当前 Leader 并完成必要的数据同步;在正式执行成员变更前,当前已提交动态配置仍应只包含 server ID 1、2、3。

执行条件化增量加入

先在 ZooKeeper CLI 中执行 config,记录最后一行的配置版本。下面用 <CONFIG_VERSION> 表示这个动态值;实际值由当前集群生成。

text
config

预期结果应只包含当前正式成员,并在最后给出版本:

text
server.1=zk1:2888:3888:participant;0.0.0.0:2181
server.2=zk2:2888:3888:participant;0.0.0.0:2181
server.3=zk3:2888:3888:participant;0.0.0.0:2181
version=<CONFIG_VERSION>

随后用 -v 提交条件化重配置,可避免你读取配置之后又有其他管理员修改成员列表而造成覆盖。

text
reconfig -add server.4=zk4:2888:3888:participant;2181 -v <CONFIG_VERSION>

预期结果会返回新的已提交成员列表,server.4 的角色为 participant,并生成新的配置版本:

text
Committed new configuration:
server.1=zk1:2888:3888:participant;0.0.0.0:2181
server.2=zk2:2888:3888:participant;0.0.0.0:2181
server.3=zk3:2888:3888:participant;0.0.0.0:2181
server.4=zk4:2888:3888:participant;0.0.0.0:2181
version=<ID>

如果返回 BadVersionException,说明 <CONFIG_VERSION> 已过期。重新读取 config、重新检查成员关系后再提交,不要去掉版本条件盲目重试。

用配置和写请求完成验收

重配置返回成功后,再次执行 config,确认所有正常节点最终看到同一成员列表和同一版本。还要检查 zk4 的同步延迟已经回落,且角色已经进入正常运行状态;只看到配置文本并不能替代数据同步检查。

最后执行一次真实 quorum write。下面的 <ID> 应替换为本次变更唯一标识,避免与已有 znode 冲突。

text
create /reconfig-add-check-<ID> joined
get /reconfig-add-check-<ID>
delete /reconfig-add-check-<ID>

预期输出至少应包含创建成功和刚写入的数据:

text
Created /reconfig-add-check-<ID>
joined

此时再核对监控中的投票成员数:加入前是 3 个 participant、quorum 为 2;加入后是 4 个 participant、quorum 为 3。只有新成员已同步、配置已传播且新多数派下的写请求能提交,才算完成一次安全扩容。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

增量加入新的投票成员

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通