服务注册与分布式协调 / 系统课时
读取当前成员与配置版本
读取当前成员与配置版本
动态重配置之前,必须先从正在运行的 ZooKeeper 集群读取真实成员列表,而不是只相信本地 zoo.cfg。本节通过 sync、config 和 /zookeeper/config 获取成员、客户端连接地址及配置版本,为后续带版本校验的重配置留下可靠快照。
学习目标
- 从在线集群读取当前动态成员配置和客户端连接信息
- 理解
/zookeeper/config中version与重配置事务的关系 - 在变更前保存一份可用于校验和故障恢复的真实集群视图
先连接一个可用成员
使用 ZooKeeper 自带 CLI 连接任意可正常服务的成员。这里通过标准输入执行一组命令,便于把检查过程保存到运维脚本或变更记录中。
/opt/zookeeper/bin/zkCli.sh -server zk1:2181 <<'EOF'
sync /zookeeper/config
config
get -s /zookeeper/config
quit
EOF预期输出
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> 代表一个成员。常见格式同时包含服务器通信地址、选举端口、成员类型以及客户端地址,例如:
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 的状态信息。下面的命令把本次读取结果写入本地文件,便于审核和事后比较。
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"预期输出
Sync is OK
server.<ID>=<SERVER_ADDRESS>
server.<ID>=<SERVER_ADDRESS>
version=<VERSION>
<CONFIG_CONTENT>
<STAT_INFORMATION>生成的文件名中时间会随执行时刻变化。变更申请中应至少保留读取时间、连接的服务器、完整成员列表和配置版本;执行重配置前如果等待时间较长,应重新读取一次,而不是继续使用数小时前的快照。
后续任何成员增删都应以这份在线配置为起点,并在提交前再次确认版本没有被其他重配置事务推进,这样才能把“当前成员是谁”和“我修改的是哪一版配置”同时校验清楚。