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

读取当前成员与配置版本

读取当前成员与配置版本

动态重配置之前,必须先从正在运行的 ZooKeeper 集群读取真实成员列表,而不是只相信本地 zoo.cfg。本节通过 sync、config 和 /zookeeper/config 获取成员、客户端连接地址及配置版本,为后续带版本校验的重配置留下可靠快照。

学习目标

  • 从在线集群读取当前动态成员配置和客户端连接信息
  • 理解 /zookeeper/config 中 version 与重配置事务的关系
  • 在变更前保存一份可用于校验和故障恢复的真实集群视图

先连接一个可用成员

使用 ZooKeeper 自带 CLI 连接任意可正常服务的成员。这里通过标准输入执行一组命令,便于把检查过程保存到运维脚本或变更记录中。

bash
/opt/zookeeper/bin/zkCli.sh -server zk1:2181 <<'EOF'
sync /zookeeper/config
config
get -s /zookeeper/config
quit
EOF

预期输出

text
Sync is OK
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=<VERSION>
<CONFIG_CONTENT>
<STAT_INFORMATION>

不同 ZooKeeper 小版本的 CLI 提示文字和统计字段展示形式可能不同,实际值也会随集群变化。需要核对的是成员条目、角色、客户端端点以及 version,而不是逐字匹配示例输出。

为什么先执行 sync

/zookeeper/config 是 ZooKeeper 保存动态成员配置的特殊 znode。客户端连接到某个 Follower 后立即读取数据时,该节点理论上可能尚未应用最新事务;sync /zookeeper/config 会让后续读取至少与服务端当前已同步状态对齐,从而降低读取旧视图的风险。

需要注意,sync 不是锁,也不会阻止其他管理员在你读取之后继续发起重配置。它解决的是“读取之前先同步”,不是“读取以后配置不会变化”。因此真正提交重配置时仍然应该使用版本条件进行并发保护。

看懂 config 返回的成员格式

动态配置中的每个 server.<ID> 代表一个成员。常见格式同时包含服务器通信地址、选举端口、成员类型以及客户端地址,例如:

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:observer;0.0.0.0:2181
version=<VERSION>

这是配置数据片段,不是独立可执行命令。participant 会参与投票并影响法定人数,observer 接收事务但不参与投票;分号后的地址描述客户端连接端点。准备扩缩容时,应先核对成员 ID 是否唯一、主机名和端口是否正确,以及计划移除的节点是否仍然出现在当前配置中。

理解配置版本和重配置事务

动态成员配置不是普通文本文件的简单覆盖。每次成功的成员变更都会作为 ZooKeeper 事务提交,并生成新的动态配置版本。配置末尾的 version=<VERSION> 因而可以看成这份成员视图的并发控制依据。

假设运维人员 A 读取到版本 V1,随后运维人员 B 已经完成一次重配置并把版本推进到 V2。如果 A 仍然基于 V1 的成员列表直接覆盖配置,就可能误删 B 刚加入的节点。正确做法是在后续 reconfig 操作中携带读取时的配置版本,让服务端在版本已经变化时拒绝旧操作,而不是静默覆盖。

保存变更前快照

真正修改成员之前,建议同时保存 config 输出和 /zookeeper/config 的状态信息。下面的命令把本次读取结果写入本地文件,便于审核和事后比较。

bash
STAMP=$(date +%Y%m%d-%H%M%S)
/opt/zookeeper/bin/zkCli.sh -server zk1:2181 <<EOF > "zk-config-$STAMP.txt"
sync /zookeeper/config
config
get -s /zookeeper/config
quit
EOF
cat "zk-config-$STAMP.txt"

预期输出

text
Sync is OK
server.<ID>=<SERVER_ADDRESS>
server.<ID>=<SERVER_ADDRESS>
version=<VERSION>
<CONFIG_CONTENT>
<STAT_INFORMATION>

生成的文件名中时间会随执行时刻变化。变更申请中应至少保留读取时间、连接的服务器、完整成员列表和配置版本;执行重配置前如果等待时间较长,应重新读取一次,而不是继续使用数小时前的快照。

后续任何成员增删都应以这份在线配置为起点,并在提交前再次确认版本没有被其他重配置事务推进,这样才能把“当前成员是谁”和“我修改的是哪一版配置”同时校验清楚。

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

目录与阅读设置

阅读设置

17

记录一个想法

读取当前成员与配置版本

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

登录哪都通