服务注册与分布式协调 / 系统课时
服务注册与健康维护
服务注册与健康维护
本课实现服务实例注册和实例列表监听。你将使用临时节点表达会话存活,处理新会话建立后的节点恢复,支持元数据更新,并让调用方通过本地缓存获得稳定的实例视图。
学习目标
- 创建可随新会话恢复的服务实例临时节点
- 安全更新实例元数据并监听实例列表变化
- 区分会话健康与业务健康
注册实例节点
直接调用 create 创建临时节点后,应用还要自行处理 LOST 后重建。Curator 的 PersistentEphemeralNode recipe 可以维护目标临时节点,并在新会话建立后重新创建。
下面是片段示例,依赖共享 CuratorFramework,且父路径已由初始化程序创建。实例 ID 必须在同一服务内唯一。
import java.nio.charset.StandardCharsets;
import java.util.concurrent.TimeUnit;
import org.apache.curator.framework.CuratorFramework;
import org.apache.curator.framework.recipes.nodes.PersistentEphemeralNode;
public final class ServiceRegistration implements AutoCloseable {
private final PersistentEphemeralNode node;
public ServiceRegistration(
CuratorFramework client,
String serviceName,
String instanceId,
String metadataJson) {
String path = "/services/" + serviceName
+ "/instances/" + instanceId;
this.node = new PersistentEphemeralNode(
client,
PersistentEphemeralNode.Mode.EPHEMERAL,
path,
metadataJson.getBytes(StandardCharsets.UTF_8));
}
public void start() throws Exception {
node.start();
boolean created = node.waitForInitialCreate(10, TimeUnit.SECONDS);
if (!created) {
throw new IllegalStateException("Service node create timeout");
}
}
public void update(String metadataJson) throws Exception {
node.setData(metadataJson.getBytes(StandardCharsets.UTF_8));
}
@Override
public void close() throws Exception {
node.close();
}
}预期行为
启动后创建 /services/<SERVICE_NAME>/instances/<INSTANCE_ID>
短暂断线且旧会话恢复时,原临时节点仍有效
会话 LOST 后建立新会话时,recipe 重新创建临时节点
调用 close 后,注册节点被关闭并最终从实例列表消失
维护实例列表缓存
消费者不应每次请求都调用 getChildren。可使用 CuratorCache 监听 /services/<SERVICE_NAME>/instances,把事件转换为不可变的本地实例列表。回调中只完成解析、校验和原子替换,不执行慢网络调用。
监听事件可能合并、延迟或在重连后重新同步,因此业务逻辑应以“当前完整视图”为准,而不是把每个事件当作精确一次的业务消息。需要强一致通知的场景应使用消息系统,而不是依赖 Watch 计数。
更新元数据
实例地址、权重或状态变化时,可更新同一实例节点数据。数据应包含 schemaVersion,消费者先校验字段再替换缓存;解析失败时保留旧视图并上报告警。
更新频率要受控。把每秒变化的负载、请求数或心跳写入 ZooKeeper 会制造大量写入和 Watch 事件。动态负载更适合指标系统,注册节点只保存低频、用于发现的元数据。
健康语义与摘流
临时节点存在只说明 ZooKeeper 会话仍存活,不证明业务线程、数据库或下游依赖健康。调用方仍需执行连接失败重试、熔断或业务探活。
应用准备下线时,应先从流量入口摘除或把状态改为 DRAINING,等待在途请求完成,再关闭注册节点。直接杀进程虽然最终会删除临时节点,但在会话超时窗口内,调用方仍可能看到旧实例。
验证恢复能力
启动两个实例后,实例缓存应包含两个唯一 ID。停止一个实例并等待其会话过期,其他客户端应移除它;重新启动后节点恢复,列表重新加入,但不能出现同一 ID 的重复节点。
还应模拟短暂网络断开,确认未达到会话超时时不会无意义地删除和重建节点;达到 LOST 后,注册组件能在新会话中恢复,并使消费者最终得到与 ZooKeeper 一致的完整列表。
本课总结
- 服务注册使用临时节点,
PersistentEphemeralNode负责跨新会话重建 - 实例列表应通过本地缓存消费,Watch 只触发状态同步
- 会话健康不等于业务健康,下线流程需要先摘流再关闭注册
下一课预告
下一课将实现不可变配置版本、current 指针监听、本地缓存切换以及校验失败和回滚处理。