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

配置监听与版本发布

配置监听与版本发布

本课实现可回滚的配置发布链路。发布端先写入不可变版本,再以节点版本为条件更新 current;消费端校验新版本后原子替换本地缓存,失败时继续使用旧配置。

学习目标

  • 实现不可变版本与 current 指针的发布模型
  • 使用版本条件避免并发发布互相覆盖
  • 在校验失败、断线和回滚时保持可用配置

设计发布流程

配置内容写入 /configs/<APP>/versions/<VERSION>,创建后不再修改;/configs/<APP>/current 只保存当前版本号。这样可以先完整校验候选版本,再切换一个很小的指针节点。

配置版本发布、消费与回滚流程

使用版本条件发布

下面是片段示例,依赖共享 CuratorFramework。它假设候选版本节点已创建并通过内容校验,current 节点内容为 UTF-8 版本号。

java
import java.nio.charset.StandardCharsets;
import org.apache.curator.framework.CuratorFramework;
import org.apache.zookeeper.data.Stat;

static void switchCurrent(
        CuratorFramework client,
        String app,
        String newVersion) throws Exception {
    String currentPath = "/configs/" + app + "/current";

    Stat stat = new Stat();
    client.getData().storingStatIn(stat).forPath(currentPath);

    client.setData()
            .withVersion(stat.getVersion())
            .forPath(
                    currentPath,
                    newVersion.getBytes(StandardCharsets.UTF_8));
}

预期行为

text
current 未被其他发布者修改时,指针切换到 <NEW_VERSION>
并发发布已先修改 current 时,当前调用收到 BadVersion
版本节点内容保持不变,消费者只通过 current 决定生效版本

只依赖 setData 的版本条件即可阻止静默覆盖。若发布还包含审计节点等多项变更,可使用 multi 事务把检查与变更组合为原子操作。

消费端监听与本地切换

消费端监听 current,而不是监听所有 versions。收到变化后读取版本号,再加载对应版本内容,依次验证节点存在、schemaVersion、字段约束和 checksum。

校验成功后构造新的不可变配置对象,并用一次原子引用替换本地缓存。业务线程始终读取完整旧对象或完整新对象,不能在原对象上逐字段修改。

监听回调只负责触发刷新。若短时间连续发布多个版本,可合并刷新任务并最终读取 current 的最新值,不要求逐个处理所有中间事件。

校验失败与断线策略

新版本不存在、JSON 无法解析、checksum 不一致或业务约束失败时,不更新本地缓存,并记录应用名、目标版本、失败阶段和 current 的节点版本。旧配置继续服务,健康检查可标记为降级而不是直接清空配置。

ZooKeeper 暂时断线时继续使用最后一次成功配置;连接恢复后重新读取 current 做一次全量对账。只有明确业务要求强一致停机时,才在配置过旧超过阈值后拒绝服务。

回滚与历史清理

回滚不是修改旧版本内容,而是把 current 条件更新回已验证的历史版本。回滚同样使用 Stat.version,避免覆盖新的正常发布。

历史版本按保留数量或时间清理,但必须排除 current 指向的版本和仍在灰度使用的版本。删除前生成清单并确认消费者最低版本,不能在发布链路中同步递归删除大量节点。

验收测试

连续发布合法版本 v000002 和非法版本 v000003。两个应用实例应先切换到 v000002;收到 v000003 后均保留 v000002,并产生明确告警。

再把 current 回滚到 v000001,两个实例应完成一致切换。并发启动两个发布者时,只允许一个版本条件更新成功,另一个收到 BadVersion 并重新决策,不能静默覆盖。

本课总结

  • 不可变版本加 current 指针能把发布、审计和回滚解耦
  • 发布端用节点版本做 CAS,消费端校验后原子替换本地缓存
  • 新配置失败或连接中断时保留最后一次成功配置,并在恢复后对账

下一课预告

后续实践可在此基础上补充综合联调、压测和故障演练,验证四个模块在会话丢失与节点故障下仍能正确协作。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置监听与版本发布

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

登录哪都通