ekit-hertz

module
v0.3.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 14, 2026 License: MIT

README

ekit-hertz

Hertz 运行时集成——日志桥接、生命周期、SSE/health/metrics 子包、注册发现与 NNS 适配器、OTel 桥接。

本仓库是 ekit(git.enjoye.top/enjoydream/ekit v0.34.0) 拆分出的独立 Go module,属于 yi-nology ekit 子项目矩阵(Round-2 深拆粒度)。

安装

go get github.com/yi-nology/ekit-hertz@v0.3.0

包清单

  • `hertz/` — 运行时集成:日志桥接(hlog→logx)、RunServer 生命周期、Shutdown Hook;子包 adaptor/health/metrics/render/sse
  • `handler/` — crudh(CRUD HTTP handler)、validatorh(参数绑定)、versionh
  • `registry/hertz/`、`nns/hertz/` — Hertz 注册发现适配器
  • `governance/hertz/` — 动态限流/超时中间件
  • `observability/tracing/instrumentation/hertzotel|hertztracer/` — OTel / OpenTracing 桥接

自研标准中间件栈与 contrib 桥接已迁 ekit-middleware;handler 层(crudh/validatorh/versionh)已迁 ekit-handler——本仓库因此不再依赖 GORM 与 middleware 栈。

依赖关系

子项目矩阵与依赖方向(自底向上,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-handler     HTTP handler 层(CRUD/绑定/版本)        → middleware, gorm, core, tracing
    ekit-hertz       Hertz 运行时/适配/instrumentation        → nns, registry, metrics, tracing, logx, core, concurrency
    ekit-kitex       Kitex 生态                               → nns, registry, core, concurrency, logx, metrics, tracing
  ekit-workflow      流程编排                                 → concurrency, logx
ekit-kitex-examples  Kitex 示例(echo client/server)         → kitex, bootstrap, registry, logx, tracing

注:ekit-observability 已在 Round-2 深拆中解散——logx 迁 [ekit-logx]、metrics 迁 [ekit-metrics]、 tracing/traceid 迁 [ekit-tracing]、shutdown 迁 [ekit-logx];原仓库已归档。

依赖:ekit-nns、ekit-registry、ekit-metrics、ekit-tracing、ekit-logx、ekit-core。

与 ekit 单体仓库的关系

  • 代码与 ekit v0.34.0 等价,module 路径 git.enjoye.top/enjoydream/ekit/... → github.com/yi-nology/ekit-hertz/...
  • 各子仓库独立发版(SemVer);开发规范沿用 ekit AGENTS.md 约定

License

见 LICENSE

Directories

Path Synopsis
governance
hertz
Package govhertz 把 governance.Store 消费成 hertz server 治理中间件 (audit 5.2 阶段 1:hertz 侧治理)。
Package govhertz 把 governance.Store 消费成 hertz server 治理中间件 (audit 5.2 阶段 1:hertz 侧治理)。
Package hertz 为 Hertz HTTP 框架提供 ekit 生态集成。
Package hertz 为 Hertz HTTP 框架提供 ekit 生态集成。
adaptor
Package adaptor 提供 hertz-contrib/adaptor 常用 helper,让 ekit 业务 用 1 行代码把 net/http 生态(http.FileServer / embed.FS / gorilla/websocket)接入 hertz。
Package adaptor 提供 hertz-contrib/adaptor 常用 helper,让 ekit 业务 用 1 行代码把 net/http 生态(http.FileServer / embed.FS / gorilla/websocket)接入 hertz。
health
Package health 提供 Hertz 健康检查端点。
Package health 提供 Hertz 健康检查端点。
metrics
Package metrics 提供 Hertz Prometheus 指标端点。
Package metrics 提供 Hertz Prometheus 指标端点。
render
Package render 提供业务特定的 hertz Render interface 实现,与 hertz 官方 render 子包(https://www.cloudwego.io/zh/docs/hertz/tutorials/basic-feature/render/) 风格一致。
Package render 提供业务特定的 hertz Render interface 实现,与 hertz 官方 render 子包(https://www.cloudwego.io/zh/docs/hertz/tutorials/basic-feature/render/) 风格一致。
sse
Package sse 提供 Hertz SSE(Server-Sent Events)封装。
Package sse 提供 Hertz SSE(Server-Sent Events)封装。
nns
hertz
Package hertz 提供 nns 与 CloudWeGo Hertz 集成的适配器。
Package hertz 提供 nns 与 CloudWeGo Hertz 集成的适配器。
observability
tracing/instrumentation/hertzotel
Package hertzotel 提供 Hertz HTTP client/server 的 OpenTelemetry tracing 集成 helper,桥接 hertz-contrib/obs-opentelemetry/tracing。
Package hertzotel 提供 Hertz HTTP client/server 的 OpenTelemetry tracing 集成 helper,桥接 hertz-contrib/obs-opentelemetry/tracing。
tracing/instrumentation/hertztracer
Package hertztracer 提供 Hertz HTTP client/server 的 OpenTracing tracing 集成 helper,桥接 hertz-contrib/tracer。
Package hertztracer 提供 Hertz HTTP client/server 的 OpenTracing tracing 集成 helper,桥接 hertz-contrib/tracer。
registry
hertz
Package hertz 提供 ekit registry 抽象到 CloudWeGo Hertz 框架的适配器。
Package hertz 提供 ekit registry 抽象到 CloudWeGo Hertz 框架的适配器。

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL