服务注册与分布式协调 / 系统课时
跨可用区迁移单个投票成员
跨可用区迁移单个投票成员
跨可用区迁移最怕的不是复制慢,而是在迁移过程中同时改变多数派与故障域关系。本节用“先以 Observer 同步、再原子替换投票成员、最后下线旧节点”的顺序,把一次迁移控制在单成员范围内,并给出 RTT、同步状态和成员配置的核对方法。
学习目标
- 设计一次只影响一个投票成员的跨可用区迁移顺序
- 使用动态重配置完成 Observer 加入与投票成员替换
- 在下线旧节点前验证多数派、RTT 和同步状态
迁移前先固定故障域边界
假设当前是 3 个投票成员,分别位于 AZ-A、AZ-B、AZ-C,多数派为 2。迁移 AZ-B 的成员时,不要同时搬迁其他节点,也不要先停旧节点再慢慢准备新节点,否则任何额外故障都可能把集群推到失去多数派的边缘。
迁移前记录当前 /zookeeper/config、各节点角色、跨区 RTT 与告警基线。新节点应使用相同 ZooKeeper 主版本、相同数据目录权限和一致的 TLS、认证配置;myid 必须是新的唯一 server ID。

先让新节点以 Observer 完成同步
先把新节点加入为 Observer。Observer 会复制事务但不参与投票,因此不会改变现有 3 个投票成员的多数派计算。以下命令中的主机名按实际环境替换。
$ZK_HOME/bin/zkCli.sh -server zk-a1.example:2181 reconfig -add "server.4=zk-c2.example:2888:3888:observer;2181"
$ZK_HOME/bin/zkCli.sh -server zk-a1.example:2181 get /zookeeper/config预期结果:第二条命令返回的动态成员配置中出现新节点,并明确标记为 observer;原有投票成员数量不变。
server.4=zk-c2.example:2888:3888:observer;2181等待新节点完成初始同步后再继续。除进程存活外,还应确认它能持续跟随 leader、没有反复重连,跨可用区 RTT 与事务同步延迟没有超过既定阈值。
原子替换投票成员
新 Observer 稳定后,用同一次 reconfig 同时移除旧投票成员并把新节点加入为 participant。这样配置从“3 个 voter + 1 个 observer”直接变成“3 个 voter”,不会经历 4 个投票成员导致多数派门槛变化的中间状态。
$ZK_HOME/bin/zkCli.sh -server zk-a1.example:2181 reconfig -remove 2 -add "server.4=zk-c2.example:2888:3888:participant;2181"
$ZK_HOME/bin/zkCli.sh -server zk-a1.example:2181 get /zookeeper/config预期结果:成员配置中不再出现 server.2,server.4 变为 participant,其余投票成员保持不变。
server.4=zk-c2.example:2888:3888:participant;2181稳定后再下线旧节点
配置提交后至少跨过一个稳定观察窗口,再关闭旧节点。重点检查三件事:新成员角色稳定、客户端读写没有持续异常、跨区 RTT 与同步延迟回到可接受范围。如果新节点频繁掉队或网络抖动明显,应优先回退成员关系,而不是继续迁移下一台。
最后再次读取 /zookeeper/config 并确认旧 server ID 已彻底移除,再停止旧主机上的 ZooKeeper 服务。迁移完成的判断标准不是“新进程已经启动”,而是“新成员已经稳定参与多数派,旧成员已从成员配置中退出,且故障域分布符合目标设计”。