服务注册与分布式协调 / 系统课时
滚动变更静态参数不丢多数派
滚动变更静态参数不丢多数派
不能通过 reconfig 在线修改的参数通常需要重启进程生效。安全做法不是“依次重启所有机器”,而是把每个节点当成一个独立发布单元:只重启一个投票成员,等它重新同步并恢复服务后,才允许进入下一台。
学习目标
- 根据投票成员数量计算滚动期间的多数派余量
- 设计单节点重启、恢复、验证、再继续的发布门禁
- 在节点无法重新加入时及时停止并回滚本节点
先算清滚动窗口
3 个投票成员需要 2 票,多数派余量只有 1 台;5 个投票成员需要 3 票,单次下线 1 台后仍有 4 台可用。因此无论集群大小,每个滚动步骤都只允许一个投票成员处于“重启或重新同步”状态。
如果上一台虽然进程已经启动,但尚未重新成为稳定的 FOLLOWING 或 LEADING 状态,就不能继续下一台。发布节奏应由“恢复完成”驱动,而不是由固定等待时间驱动。

单节点应用静态配置
下面以把 maxClientCnxns 调整为 120 为例。它只是静态参数示例,真实发布应替换成变更单中需要修改的参数,并确保所有投票成员最终采用一致配置。
sudo cp /etc/zookeeper/zoo.cfg /etc/zookeeper/zoo.cfg.bak
sudo sed -i 's/^maxClientCnxns=.*/maxClientCnxns=120/' /etc/zookeeper/zoo.cfg
grep '^maxClientCnxns=' /etc/zookeeper/zoo.cfg
sudo systemctl restart zookeeper
sudo systemctl is-active zookeeper
$ZK_HOME/bin/zkServer.sh status预期结果:配置文件显示新值,服务恢复为 active,节点最终重新进入 leader 或 follower 角色。实际角色由当时选举结果决定。
maxClientCnxns=120
active
Mode: <MODE>如果原配置中没有 maxClientCnxns 这一行,不能直接使用上述替换命令,应改为显式追加或用配置管理系统生成完整文件,避免“命令执行成功但参数根本没有写入”的假成功。
通过健康门禁再进入下一台
单节点启动成功只说明进程存在,还不足以继续发布。进入下一台之前至少确认:该节点已重新加入当前成员配置;角色稳定;客户端基本读写成功;现有监控中的连接数、未完成请求、同步延迟与会话异常没有持续恶化。
可以从任一健康节点读取动态配置,确认成员关系没有因为滚动发布发生意外变化。
$ZK_HOME/bin/zkCli.sh -server zk1.example:2181 get /zookeeper/config预期结果:返回的 server.x 成员集合与发布前一致,只是当前被重启节点已经恢复在线;如果成员条目丢失或角色异常,应立即停止滚动。
节点恢复失败时只回滚当前节点
若重启后的节点无法重新加入,不要为了“赶进度”继续重启第二台。先保留其余多数派节点不动,检查配置语法、文件权限、端口占用、数据目录和版本差异;确认是本次静态参数变更导致时,恢复备份并只重启当前故障节点。
sudo cp /etc/zookeeper/zoo.cfg.bak /etc/zookeeper/zoo.cfg
sudo systemctl restart zookeeper
sudo systemctl is-active zookeeper
$ZK_HOME/bin/zkServer.sh status预期结果:服务恢复 active,节点重新进入可服务角色后,滚动流程才重新具备继续条件。
active
Mode: <MODE>滚动变更的核心门禁只有一句话:任何时刻都只能有一个投票成员离开稳定状态,而且下一步必须建立在“上一台已经重新同步并恢复服务”的事实之上,而不是建立在“重启命令已经执行完”的假设之上。