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

命名空间与数据结构设计

命名空间与数据结构设计

本课为综合项目规划可维护的 ZooKeeper 数据树。你将确定服务实例、配置版本、选举候选和锁节点的路径结构,并为持久性、命名、权限和数据大小建立统一规则。

学习目标

  • 为四类业务能力设计互不冲突的路径
  • 正确选择持久、临时和顺序节点
  • 约束节点数据、版本和 ACL 边界

设计应用根路径

所有路径放在独立应用根目录下,避免与其他系统混用。服务名、应用名和资源名使用稳定的小写标识;实例 ID 和版本号只出现在对应层级,不把时间戳、随机串散落到每个路径段。

综合项目命名空间与节点类型

给出完整树结构

下面是目标数据结构,不是命令输出。尖括号表示部署时替换的变量。

text
/anystack-demo
├── services
│   └── payment-worker
│       └── instances
│           ├── <INSTANCE_ID_A>         # 临时节点
│           └── <INSTANCE_ID_B>         # 临时节点
├── configs
│   └── payment-worker
│       ├── current                     # 持久节点,内容为版本号
│       └── versions
│           ├── v000001                 # 持久节点,不可变配置
│           └── v000002
├── election
│   └── daily-settlement
│       └── candidates
│           └── candidate-0000000001   # 临时顺序节点
└── locks
    └── settlement-<BIZ_DATE>
        └── lock-0000000001            # 临时顺序节点

服务实例使用临时节点,使会话失效后能够自动移除。选举和锁使用临时顺序节点,顺序号用于判断最小候选者;配置版本和 current 指针必须持久化,不能因发布器断线而消失。

设计节点数据

实例节点只保存发现所需的小型元数据,例如 endpoint、协议、区域、启动时间和元数据版本。健康状态不能只靠字段声明,应以会话存活为基础,并由调用方结合业务探活。

配置版本节点保存小型 JSON 或外部配置引用,并包含 schemaVersion、checksum、createdAt 和 createdBy。current 只保存版本号,消费者先读取 current,再加载不可变版本内容。

选举和锁节点只保存实例 ID、请求 ID 和创建时间等诊断字段。不要在锁节点中写任务结果,也不要把密钥、令牌或大文件直接放入 ZooKeeper。

版本与命名规则

版本号使用固定宽度递增格式,例如 v000001,便于排序和审计。实例 ID 在同一服务内唯一,推荐由部署平台提供,而不是每次重连生成新随机值。

路径一旦发布就视为接口。重命名时应提供双读或迁移期,不能直接移动生产路径并期待所有客户端同时升级。

ACL 与容量边界

服务实例模块只写自己的 instances 路径,配置发布器可写 versions 和 current,普通消费者只有读取权限;选举和锁模块只访问各自目录。ACL 身份应来自受控认证,不把 world:anyone:cdrwa 作为生产默认值。

还应在应用层限制单节点数据大小、历史版本数量和单目录实例规模。部署到测试环境后,逐条读取节点的 ephemeralOwner、数据版本和 ACL:实例、候选与锁节点应具有非零会话所有者,配置节点应为持久节点,越权写入应被拒绝。

本课总结

  • 临时节点适合会话态实例,临时顺序节点适合选举和锁
  • 配置采用不可变版本加 current 指针,便于校验、审计和回滚
  • 路径、数据大小和 ACL 都应作为长期接口统一治理

下一课预告

下一课将封装 Curator 客户端,统一处理连接状态、重试策略、启动等待和应用关闭。

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

目录与阅读设置

阅读设置

17

记录一个想法

命名空间与数据结构设计

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

登录哪都通