服务注册与分布式协调 / 系统课时
命名空间与数据结构设计
命名空间与数据结构设计
本课为综合项目规划可维护的 ZooKeeper 数据树。你将确定服务实例、配置版本、选举候选和锁节点的路径结构,并为持久性、命名、权限和数据大小建立统一规则。
学习目标
- 为四类业务能力设计互不冲突的路径
- 正确选择持久、临时和顺序节点
- 约束节点数据、版本和 ACL 边界
设计应用根路径
所有路径放在独立应用根目录下,避免与其他系统混用。服务名、应用名和资源名使用稳定的小写标识;实例 ID 和版本号只出现在对应层级,不把时间戳、随机串散落到每个路径段。

给出完整树结构
下面是目标数据结构,不是命令输出。尖括号表示部署时替换的变量。
/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 客户端,统一处理连接状态、重试策略、启动等待和应用关闭。