服务注册与分布式协调 / 系统课时
拆分静态配置与动态成员配置
拆分静态配置与动态成员配置
这一课把 ZooKeeper 的配置拆成两个责任域:zoo.cfg 保存启动期静态参数,dynamicConfigFile 指向由集群维护的成员配置。学完后,你能判断哪些内容可以在线重配置,哪些修改仍必须通过滚动重启生效,并避免手工篡改版本化动态文件。
学习目标
- 读懂
zoo.cfg、dynamicConfigFile、server.x与配置版本之间的关系 - 区分运行期动态成员配置与启动期静态参数
- 用只读命令核对当前成员配置,而不是直接编辑动态文件
两类配置分别负责什么
ZooKeeper 3.5.0 之后把可在线变化的成员信息从普通启动参数中分离出来。当前 3.9 文档把 server、group、weight 归为动态配置;动态文件通过 dynamicConfigFile 由静态配置引用,重配置提交后由 ZooKeeper 更新各节点上的动态配置。([Apache ZooKeeper][1])
一个典型的静态 zoo.cfg 可以保留如下内容。这里的路径只是示例,部署时应替换成真实目录。
tickTime=2000
dataDir=/var/lib/zookeeper
initLimit=10
syncLimit=5
reconfigEnabled=true
dynamicConfigFile=/etc/zookeeper/zoo.cfg.dynamic.<VERSION>tickTime、dataDir、initLimit、syncLimit、reconfigEnabled 这类参数在进程启动时读取,不会因为成员重配置而自动改变。dynamicConfigFile 则是一个指针,告诉当前服务器去哪里读取本轮成员配置。
动态文件承担成员拓扑,例如:
server.1=zk1.example.com:2888:3888:participant;2181
server.2=zk2.example.com:2888:3888:participant;2181
server.3=zk3.example.com:2888:3888:participant;21812888 是 quorum 通信端口,3888 是选举端口,分号右侧是客户端端口;participant 表示该节点参与投票。实际端口和主机名以你的环境为准。

配置版本为什么不能手工改
每次成功的动态重配置都会产生新的配置版本。ZooKeeper 会把版本用于判断哪份成员配置更新,并把版本带入动态配置文件名;静态文件中的 dynamicConfigFile 也会随之指向新的版本化文件。官方文档明确提醒不要人工修改这个版本,否则可能造成节点看到不同成员配置,带来不一致甚至数据风险。([Apache ZooKeeper][1])
因此,运维时应把“成员变化”理解为一次由集群提交的配置事务,而不是一次普通的文件分发。旧动态文件可以作为历史痕迹保留,但不能通过编辑旧文件来“回滚”在线集群。
用只读命令核对当前成员
连接任意可用节点后,先同步配置节点,再读取当前动态配置。config 读取的是 /zookeeper/config 对应的已提交成员信息;同步后再读,可以减少连到 follower 时看到稍旧配置的可能。([Apache ZooKeeper][1])
bin/zkCli.sh -server zk1.example.com:2181预期结果:
[zk: zk1.example.com:2181(CONNECTED) 0]进入 CLI 后执行:
sync /zookeeper/config
config预期结果:
Sync is OK
server.1=zk1.example.com:2888:3888:participant;2181
server.2=zk2.example.com:2888:3888:participant;2181
server.3=zk3.example.com:2888:3888:participant;2181
version=<VERSION><VERSION> 会随集群实际状态变化。核对时重点看服务器 ID、主机、quorum 端口、选举端口、角色和客户端端口是否与预期一致,而不是拿版本号做人工排序或改写。
哪些修改仍要滚动重启
动态重配置解决的是成员拓扑,不等于 ZooKeeper 的全部配置都能热更新。像 tickTime、dataDir、dataLogDir、initLimit、syncLimit、认证提供器以及 reconfigEnabled 等启动期设置,修改后通常需要重启对应服务器进程才能生效。
生产集群应按“先确认多数派健康,再一次只重启一个节点”的方式滚动处理。每重启一台都要等它重新加入并恢复 follower 或 leader 等正常角色,再继续下一台;不要把静态参数变更和成员扩缩容混在同一批操作里,否则出问题时很难判断是启动配置还是成员配置导致。
判断原则很简单:成员列表、角色和成员端口走动态重配置;进程启动期参数走配置文件加滚动重启。 只要坚持这条边界,就能避免把 ZooKeeper 的配置文件当成普通文本文件随意覆盖。