README
¶
ekit-registry
注册发现核心 + Nacos 实现 + 配置加载 + 服务发现桥接。
本仓库是 ekit（git.enjoye.top/enjoydream/ekit v0.34.0）
拆分出的独立 Go module，属于 yi-nology ekit 子项目矩阵（Round-2 深拆粒度）。
安装
go get github.com/yi-nology/ekit-registry@v0.2.0
包清单
- `registry/` — Registrar/Discoverer/Subscriber/ConfigStore 核心接口 + 实例模型 + netutil
- `registry/nacos/` — Nacos 实现（nacos-sdk-go v2）
- `registry/sdbridge/` — 服务发现适配器共享核心（跨模块公开）
- `registrymocks/` — 4 接口统一测试 mock
- `nacos/` — Nacos 客户端门面
- `config/` — YAML/env/.env 配置加载与 merge
依赖关系
子项目矩阵与依赖方向（自底向上，19 仓）：
ekit-core 文本/数据工具 + governance/lifecycle/version （零内部依赖）
ekit-concurrency 并发与流控原语 （零内部依赖）
ekit-logx 日志门面 + shutdown （零内部依赖）
ekit-istio Istio Proxyless （零内部依赖）
ekit-metrics Prometheus 门面 → core
ekit-tracing OTel + traceid → logx
ekit-registry 注册发现 + 配置 → core, logx
ekit-data 缓存抽象 + 定时任务 → core, logx, concurrency
ekit-gorm SQL/GORM 全家 → core, logx
ekit-redis Redis 全家 → data, core, logx
ekit-httpx HTTP 客户端 + 负载均衡 → core, concurrency, logx, metrics, tracing, registry
ekit-nns 服务治理客户端 → httpx, registry, core, logx, tracing, metrics
ekit-bootstrap 应用引导
ekit-middleware Hertz 中间件栈 → core, concurrency, logx, metrics, tracing, registry
ekit-hertz Hertz 运行时/适配/instrumentation → middleware, gorm, nns, registry, metrics, tracing, logx, core
ekit-kitex Kitex 生态 → nns, registry, core, concurrency, logx, metrics
ekit-workflow 流程编排 → concurrency, logx
注：
ekit-observability已在 Round-2 深拆中解散——logx 迁 [ekit-logx]、metrics 迁 [ekit-metrics]、 tracing/traceid 迁 [ekit-tracing]、shutdown 迁 [ekit-logx]；原仓库已归档。
依赖：ekit-core、ekit-logx。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 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.