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

项目需求与架构设计

项目需求与架构设计

本课把前面分散学习的 ZooKeeper 能力组合成一个生产级示例项目。最终系统同时支持服务注册、配置监听、主节点选举和任务互斥,并明确故障边界与验收标准。

学习目标

  • 把四类协调需求拆成清晰的组件边界
  • 设计共享客户端、业务模块和本地缓存的依赖关系
  • 定义可执行的故障场景与验收标准

明确最小需求

项目包含两个应用实例和一个后台任务。每个实例启动后注册服务地址;配置版本变化时刷新本地缓存;同一时刻只有一个实例担任调度主节点;具体任务执行前还要获取互斥锁,防止主节点切换期间重复执行。

服务注册回答“有哪些实例”,配置监听回答“当前使用哪个版本”,选举回答“谁负责调度”,锁回答“某项任务能否进入临界区”。四者职责不同,不能用一个临时节点同时承担全部语义。

ZooKeeper 综合项目架构

组件边界

应用进程只创建一个 CuratorFramework 实例,由基础设施层管理连接、重试和关闭。四个业务组件共享该客户端,但各自维护独立路径、监听器和生命周期。

配置缓存保存在应用内存,本地读取不经过 ZooKeeper;任务执行结果写入数据库,并使用业务唯一键防重。ZooKeeper 只保存小型元数据和协调状态,不承担消息队列、业务数据表或结果存储职责。

配置项目参数

下面是项目配置结构示例。它由 Spring Boot 或其他配置框架绑定,部署环境必须提供实例 ID、主机、端口和业务日期等变量。

yaml
coordination:
  connect-string: "zk-1:2181,zk-2:2181,zk-3:2181"
  namespace: "anystack-demo"
  session-timeout-ms: 15000
  connection-timeout-ms: 5000
  retry:
    base-sleep-ms: 500
    max-retries: 5
  service:
    name: "payment-worker"
    instance-id: "${INSTANCE_ID}"
    endpoint: "http://${HOST}:${PORT}"
  config:
    application: "payment-worker"
  election:
    name: "daily-settlement"
  lock:
    resource: "settlement-${BIZ_DATE}"

配置生效后,所有模块都应基于同一 namespace 构造路径。INSTANCE_ID 在同一服务内必须唯一,HOST、PORT 和 BIZ_DATE 由部署或任务上下文提供,不能在所有实例中写成相同常量。

验证时打印脱敏后的最终配置,并检查四个组件生成的根路径都位于 /anystack-demo 命名空间下;任一必填变量为空时,应用应在启动阶段失败,而不是带着不完整路径运行。

设计故障模型

网络短暂中断时,应用进入降级状态但保留本地配置;会话真正丢失后,服务注册、选举候选和锁都必须按新会话恢复。配置监听失败不能清空当前可用配置,发布失败也不能改变 current 指针。

Leader 身份只代表“有权尝试调度”,不代表任务一定成功。任务写入必须有业务幂等键,锁释放也不能替代数据库事务或结果校验。

验收标准

启动两个实例后,服务目录应出现两个临时节点,调用方能收到实例列表变化。发布新配置后,两实例切换到同一版本;非法配置被拒绝且旧配置继续可用。

任意时刻只能有一个选举 Leader。停止 Leader 后,另一实例应接任;同一业务日期的任务结果只能落库一次。ZooKeeper 任一节点停止时,只要多数派仍在,项目功能应继续工作。

本课总结

  • 四类协调能力要分开建模,并共享统一客户端基础设施
  • ZooKeeper 保存协调元数据,本地缓存和业务数据库承担各自职责
  • 项目设计必须同时包含正常流程、会话丢失和故障切换验收

下一课预告

下一课将把架构映射为稳定的命名空间和节点结构,明确每类节点的持久性、命名规则和数据边界。

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

目录与阅读设置

阅读设置

17

记录一个想法

项目需求与架构设计

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

登录哪都通