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

更换成员地址并保持编号稳定

更换成员地址并保持编号稳定

主机迁移不一定要把旧成员删除后再创建一个新编号。只要逻辑成员身份不变,就可以保持 server.X 与 myid 稳定,只调整 quorum、election 和 client 地址,并通过配置提交、进程切换与连通性验证完成迁移。

学习目标

  • 在地址变化时保持 ZooKeeper 逻辑成员编号不变
  • 根据是否启用动态重配置选择在线变更或静态滚动方式
  • 验证新地址已经进入集群配置,并确认新节点正常参与集群

先确定变更方式

如果集群已经启用动态重配置,可以通过 reconfig 修改现有成员的地址;ZooKeeper 的增量重配置允许对已经存在的 server ID 提交新的地址、端口或角色,提交后仍然是同一个逻辑成员。动态重配置由 reconfigEnabled=true 控制,官方当前管理文档说明该选项默认关闭,因此不能假设所有集群都能直接执行 reconfig。([Apache ZooKeeper][1])

如果生产环境没有启用动态重配置,就不要为了本次迁移临时强开功能。可以在维护窗口中统一准备新的静态成员配置,再按保持法定多数的顺序滚动重启。无论采用哪一种方式,都应一次只迁移一个成员。

保持server编号不变的地址迁移流程

只修改地址不修改编号

动态成员配置中的一条记录可以同时描述 quorum 通信地址、leader election 地址、角色以及 client 地址。例如成员 2 从旧主机迁移到 zk2-new.example.com 后,编号仍然是 2:

text
server.1=zk1.example.com:2888:3888:participant;zk1.example.com:2181
server.2=zk2-new.example.com:2888:3888:participant;zk2-new.example.com:2181
server.3=zk3.example.com:2888:3888:participant;zk3.example.com:2181

这是配置片段示例。分号左侧描述成员间通信,通常依次包含 quorum 端口和 election 端口;分号右侧描述客户端连接地址。当前 ZooKeeper 动态重配置格式支持在同一条 server 配置中携带 client 地址和端口。([Apache ZooKeeper][2])

新机器的数据目录中仍应保持:

text
2

这里的 2 是 dataDir/myid 内容。迁移过程中不要为了“适配新机器”把它改成一个新的编号,否则原本的地址迁移就会变成成员删除与成员新增,影响范围明显扩大。

使用动态重配置提交新地址

下面以已启用动态重配置、当前管理员具有重配置权限为前提。命令把已经存在的成员 2 更新为新地址;官方 CLI 文档明确支持通过 reconfig -add 更新现有 server ID。([Apache ZooKeeper][2])

bash
#!/usr/bin/env bash
set -euo pipefail

ZK_HOME="${ZK_HOME:-/opt/zookeeper}"
CONNECT="zk1.example.com:2181"
NEW_MEMBER='server.2=zk2-new.example.com:2888:3888:participant;zk2-new.example.com:2181'

printf 'reconfig -add %s\nquit\n' "$NEW_MEMBER" \
  | "$ZK_HOME/bin/zkCli.sh" -server "$CONNECT"

预期结果中应出现提交后的成员配置。配置版本属于动态值:

text
Committed new configuration:
server.1=zk1.example.com:2888:3888:participant;zk1.example.com:2181
server.2=zk2-new.example.com:2888:3888:participant;zk2-new.example.com:2181
server.3=zk3.example.com:2888:3888:participant;zk3.example.com:2181
version=<VERSION>

实际输出可能把未显式指定的 client 地址规范化为具体监听形式,因此验收重点不是逐字符比对,而是确认 server.2 的 server ID 没变,且 quorum、election、client 目标已经全部指向规划的新地址。

切换进程并验证新成员

配置提交后,确认旧主机上的成员 2 已停止且不会被 systemd、容器编排或守护脚本重新拉起,再启动新主机上 myid=2 的 ZooKeeper。随后直接检查新节点状态:

bash
#!/usr/bin/env bash
set -euo pipefail

ZK_HOME="${ZK_HOME:-/opt/zookeeper}"
"$ZK_HOME/bin/zkServer.sh" status

正常节点的预期输出应包含运行模式,具体角色取决于当时的 leader 选举结果:

text
ZooKeeper JMX enabled by default
Using config: <PATH>/zoo.cfg
Client port found: 2181. Client address: <ADDRESS>. Client SSL: false.
Mode: <leader|follower>

不同版本的状态输出文字可能略有差异,但不能出现连接失败、进程未运行或无法读取配置等错误。接着还应从一个健康成员查询已提交的动态配置,确认集群看到的仍是 server.2 而不是新的逻辑编号。

别漏掉客户端地址迁移

quorum 和 election 地址只解决 ZooKeeper 成员之间的通信,client 地址变化还会影响应用连接串、服务发现配置、DNS、负载均衡和防火墙规则。如果应用仍直接连接旧的 zk2 地址,即使集群自身已经恢复为三节点,客户端也可能持续出现连接超时或反复重连。

因此验收不能只看新节点进程是否启动。最终应同时确认:集群配置中的 server.2 已指向新地址,新节点以原 myid=2 正常加入,旧节点不会再次启动,应用侧连接串或 DNS 已能访问新 client 地址,并且迁移期间其余投票成员始终保持法定多数。做到这些,地址变化才只是基础设施迁移,而不是一次意外的成员身份重建。

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

目录与阅读设置

阅读设置

17

记录一个想法

更换成员地址并保持编号稳定

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

登录哪都通