ekit-kitex

module
v0.1.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-kitex

Kitex RPC 生态——日志桥接、治理配置热更新、生命周期、BizError 桥接、可观测性与 Istio。

本仓库是 ekit(git.enjoye.top/enjoydream/ekit v0.34.0) 按框架耦合分层拆分出的独立 Go module,属于 yi-nology ekit 子项目矩阵。

安装

go get github.com/yi-nology/ekit-kitex@v0.1.0

包清单

  • kitex/ — klog→logx 桥接、NewServerTracingSuite、GovernanceConfig(Nacos 热更 retry/timeout/CB/limiter)、RunServer、WithBizErrorBridge、PanicLogMiddleware
  • kitex/kitexmeta/ — trace_id + metainfo 跨 RPC 透传(client middleware)
  • registry/kitex/、nns/kitex/ — Kitex 注册发现适配器
  • observability/metrics/instrumentation/kitexprom/ — 方法级 RPC 指标(monitor-prometheus 桥接)
  • observability/tracing/instrumentation/kitexotel/ — OTel server/client suite
  • observability/istio/ — Istio Proxyless XDS
  • examples/ — kitex echo 示例(client/server + IDL + 治理配置)

依赖关系

子项目矩阵与依赖方向(自底向上):

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、ekit-registry、ekit-nns(examples 另引 ekit-bootstrap)。

与 ekit 单体仓库的关系

  • 代码与 ekit v0.34.0 等价,仅 module 路径从 git.enjoye.top/enjoydream/ekit/... 改为 github.com/yi-nology/ekit-kitex/...
  • 后续演进以各子仓库独立发版(SemVer);ekit 单体仓库保留完整历史与架构文档(docs/PLATFORM_CONTRACT.md)
  • 开发规范(命名/错误处理/并发安全/日志门面)沿用 ekit AGENTS.md 约定

License

见 LICENSE

Directories

Path Synopsis
examples
kitex/client command
kitex/kitex_gen/kitex/echo/echoservice
Code generated by Kitex v0.16.3.
Code generated by Kitex v0.16.3.
kitex/server command
internal
e2e/kitex_gen/kitex/echo/echoservice
Code generated by Kitex v0.16.3.
Code generated by Kitex v0.16.3.
Package kitex 为 CloudWeGo Kitex RPC 框架提供 ekit 生态集成。
Package kitex 为 CloudWeGo Kitex RPC 框架提供 ekit 生态集成。
kitexmeta
Package kitexmeta 桥接 kitex transmeta 体系 + ekit traceid,让 trace_id / 用户身份 / 空间码等业务元数据在 kitex server 入口注入 到 ctx,通过 kitex client transmeta 自动透传到下游 server。
Package kitexmeta 桥接 kitex transmeta 体系 + ekit traceid,让 trace_id / 用户身份 / 空间码等业务元数据在 kitex server 入口注入 到 ctx,通过 kitex client transmeta 自动透传到下游 server。
nns
kitex
Package kitex 提供 NNS 门面到 CloudWeGo Kitex 框架的适配器。
Package kitex 提供 NNS 门面到 CloudWeGo Kitex 框架的适配器。
observability
istio
Package istio 提供 Kitex xDS / Proxyless / Istio 集成的 ekit 桥接。
Package istio 提供 Kitex xDS / Proxyless / Istio 集成的 ekit 桥接。
metrics/instrumentation/kitexprom
Package kitexprom 桥接 kitex-contrib/monitor-prometheus,为 Kitex 提供 方法级 RPC 指标(吞吐/时延,labels 含 caller/callee/method/status/retry)。
Package kitexprom 桥接 kitex-contrib/monitor-prometheus,为 Kitex 提供 方法级 RPC 指标(吞吐/时延,labels 含 caller/callee/method/status/retry)。
tracing/instrumentation/kitexotel
Package kitexotel 提供 Kitex 客户端/服务端的 metainfo propagation 启用 helper,以及 OTel 链路透传(通过 metainfo carrier)选项。
Package kitexotel 提供 Kitex 客户端/服务端的 metainfo propagation 启用 helper,以及 OTel 链路透传(通过 metainfo carrier)选项。
registry
kitex
Package kitex 提供 ekit registry 抽象到 CloudWeGo Kitex 框架的适配器。
Package kitex 提供 ekit registry 抽象到 CloudWeGo Kitex 框架的适配器。

Jump to

Keyboard shortcuts

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