Skip to content

Latest commit

 

History

History
126 lines (77 loc) · 7.54 KB

README_cn.md

File metadata and controls

126 lines (77 loc) · 7.54 KB

CloudWeGo-Kitex

English | 中文

Release WebSite License Go Report Card OpenIssue ClosedIssue Stars Forks Slack

Kitex[kaɪt'eks] 字节跳动内部的 Golang 微服务 RPC 框架,具有高性能强可扩展的特点,在字节内部已广泛使用。如今越来越多的微服务选择使用 Golang,如果对微服务性能有要求,又希望定制扩展融入自己的治理体系,Kitex 会是一个不错的选择。

框架特点

  • 高性能

    使用自研的高性能网络库 Netpoll,性能相较 go net 具有显著优势。

  • 扩展性

    提供了较多的扩展接口以及默认扩展实现,使用者也可以根据需要自行定制扩展,具体见下面的框架扩展。

  • 多消息协议

    RPC 消息协议默认支持 ThriftKitex ProtobufgRPC。Thrift 支持 Buffered 和 Framed 二进制协议;Kitex Protobuf 是 Kitex 自定义的 Protobuf 消息协议,协议格式类似 Thrift;gRPC 是对 gRPC 消息协议的支持,可以与 gRPC 互通。除此之外,使用者也可以扩展自己的消息协议。

  • 多传输协议

    传输协议封装消息协议进行 RPC 互通,传输协议可以额外透传元信息,用于服务治理,Kitex 支持的传输协议有 TTHeaderHTTP2。TTHeader 可以和 Thrift、Kitex Protobuf 结合使用。

  • 多种消息类型

    支持 PingPongOneway双向 Streaming。其中 Oneway 目前只对 Thrift 协议支持。

  • 服务治理

    支持服务注册/发现、负载均衡、熔断、限流、重试、监控、链路跟踪、日志、诊断等服务治理模块,大部分均已提供默认扩展,使用者可选择集成。

  • 代码生成

    Kitex 内置代码生成工具,可支持生成 ThriftProtobuf 以及脚手架代码。

详细文档

  • 快速开始

  • 用户指南

    • 基本特性

      包含消息类型、编解码协议、直连访问、连接池、超时控制、请求重试、负载均衡、熔断、埋点粒度控制、日志以及 HttpResolver,详见文档

    • 治理特性

      支持服务发现、监控、链路跟踪、自定义访问控制等治理特性,详见文档

    • 高级特性

      支持泛化调用、Server SDK 化等高级特性,详见文档

    • 代码生成

      提供代码生成工具与 Combine Service 说明,详见文档

    • 框架扩展

      提供基本扩展 - 自定义 Middleware、Suite 扩展(封装自定义治理模块)、服务注册扩展、服务发现扩展、负载均衡扩展、监控扩展、日志扩展、编解码(协议)扩展、传输模块扩展、Transport Pipeline-Bound 扩展、元信息传递扩展、诊断模块扩展等支持,详见文档

  • 参考

    • 关于应用层传输协议 TTHeader、异常说明与版本管理,请参考文档
  • 最佳实践

    • Kitex 在生产环境下的最佳实践,如优雅停机、错误处理、集成测试,详见:文档
  • FAQ

    • 请参考 FAQ

框架性能

性能测试只能提供相对参考,工业场景下,有诸多因素可以影响实际的性能表现。

我们提供了 kitex-benchmark 项目用来长期追踪和比较 Kitex 与其他框架在不同情况下的性能数据以供参考。

相关项目

  • Netpoll:自研的高性能网络库,Kitex 默认集成的。
  • kitex-contrib:Kitex 的部分扩展库,使用者可以根据需求通过 Option 集成进 Kitex 中。
  • kitex-examples: Kitex 功能示例代码集。
  • biz-demo: Kitex 业务示例。

相关文章

贡献代码

贡献者指南:Contributing

开源许可

Kitex 基于Apache License 2.0 许可证,其依赖的三方组件的开源许可见 Licenses

联系我们

Landscapes

  

CloudWeGo 丰富了 CNCF 云原生生态