README
¶
ekit-registry
注册发现核心 + Nacos 实现 + 配置加载——框架无关的服务注册/发现抽象及其 Nacos 落地。
本仓库是 ekit（git.enjoye.top/enjoydream/ekit v0.34.0）
按框架耦合分层拆分出的独立 Go module，属于 yi-nology ekit 子项目矩阵。
安装
go get github.com/yi-nology/ekit-registry@v0.1.0
包清单
registry/—Registrar/Discoverer/Subscriber/ConfigStore核心接口 + 实例模型 + 注册地址解析（netutil）registry/nacos/— Nacos 实现（nacos-sdk-go v2）registry/sdbridge/— 服务发现适配器共享核心（拉取+校验+错误包装，原 internal 包，跨模块复用故公开）registrymocks/— 4 接口的统一测试 mock（原 internal 包，公开复用）nacos/— Nacos 客户端门面（nns 默认构造用）config/— YAML 配置加载（LoadBootstrap）、环境变量、.env、merge（zeroable tag）
依赖关系
子项目矩阵与依赖方向（自底向上）：
ekit-core 纯工具层（零内部依赖）
└─ ekit-observability 日志/追踪/指标门面
└─ ekit-registry 注册发现 + 配置
├─ ekit-data 存储层
├─ ekit-network 网络客户端
│ └─ ekit-nns 服务治理客户端
│ └─ ekit-bootstrap 应用引导
├─ ekit-hertz Hertz 生态
├─ ekit-kitex Kitex 生态
└─ ekit-workflow 流程编排
依赖：ekit-core、ekit-observability。Kitex/Hertz 适配器分属 ekit-kitex / ekit-hertz。
与 ekit 单体仓库的关系
- 代码与 ekit v0.34.0 等价，仅 module 路径从
git.enjoye.top/enjoydream/ekit/...改为github.com/yi-nology/ekit-registry/... - 后续演进以各子仓库独立发版（SemVer）；ekit 单体仓库保留完整历史与架构文档（docs/PLATFORM_CONTRACT.md）
- 开发规范（命名/错误处理/并发安全/日志门面）沿用 ekit AGENTS.md 约定
License
见 LICENSE
Directories
¶
| Path | Synopsis |
|---|---|
|
Package config 提供 YAML 配置文件加载和反射合并。
|
Package config 提供 YAML 配置文件加载和反射合并。 |
|
Package nacos 提供 Nacos 配置中心和服务注册发现客户端。
|
Package nacos 提供 Nacos 配置中心和服务注册发现客户端。 |
|
Package registry 提供与服务注册中心无关的服务注册与发现抽象接口。
|
Package registry 提供与服务注册中心无关的服务注册与发现抽象接口。 |
|
nacos
Package nacos 提供 registry 接口的 Nacos 实现。
|
Package nacos 提供 registry 接口的 Nacos 实现。 |
|
sdbridge
Package sdbridge 提供服务发现适配器的框架无关共享核心。
|
Package sdbridge 提供服务发现适配器的框架无关共享核心。 |
|
Package registrymocks 提供 registry 包 4 个接口（Registrar/Discoverer/Subscriber/ConfigStore） 的统一 mock 实现，供单元测试使用（原为 ekit internal 包，拆分后跨模块复用故公开）。
|
Package registrymocks 提供 registry 包 4 个接口（Registrar/Discoverer/Subscriber/ConfigStore） 的统一 mock 实现，供单元测试使用（原为 ekit internal 包，拆分后跨模块复用故公开）。 |
Click to show internal directories.
Click to hide internal directories.