Skip to content

Latest commit

 

History

History
executable file
·
100 lines (71 loc) · 5.04 KB

README_cn.md

File metadata and controls

executable file
·
100 lines (71 loc) · 5.04 KB

Go-Chassis 是一个go语言的微服务开发框架，专注于帮你实现云原生应用

为什么使用 Go chassis

  • 强大的中间件 "handler chain":不止拥有 "filter" or "interceptor"的能力. chain中每个handler都可以拿到后面的handler的执行结果，包括业务代码的执行结果。这在很多场景下都很实用，比如:

1.跟踪业务指标，并导出他们让prometheus收集。

2.跟踪关键的业务执行结果，审计这些信息。

3.分布式调用链追踪，end span可以等到业务执行后在handler中去完善，无需写在业务代码中。

  1. 客户端调用远程服务时，也需要进行中间处理，比如客户端负载均衡，请求重试

以上场景的共性是帮助你解耦通用功能与业务逻辑，解放业务开发者。否则业务逻辑将于这些通用功能耦合，你可以将这些工作交给基础设施团队，开发出来的中间件，可以供任何业务团队使用。而业务团队只需要专注于业务逻辑开发。

  • go chassis沉淀了许多可信软件所需的特性：开箱即用的限流，校验请求，金丝雀发布，高可用，通信保护等功能

  • go chassis被设计为通信协议中立的框架,你可以开发自定义的协议集成到go chassis， 并应用统一的治理能力，如负载均衡，熔断器，限流，流量控制，这些功能使你的服务变得具有韧性，并面向云原生。完全不需要再去自己集成各种方案，使用go chassis只需要通过配置文件来使用这些功能。

  • go chassis 使用open tracing与prometheus使调用链与指标可视化

  • go chassis 灵活性高，许多组件可以自己定制，比如注册发现，指标上报，调用链追踪，分布式配置管理等

  • go chassis是插件化设计，所有的功能都是可插拔的，且功能可按需引入，不引入就不会编译到二进制执行文件中。开源三方件依赖很少

特性

  • 可插拔的注册发现组件: 当前支持Apache ServiceComb，kubernetes与istio，无论是服务端发现还是客户端注册发现都可以适配。
  • 插件化协议: 当前支持http，grpc，支持开发者定制私有协议
  • 多端口管理: 对于同协议，可以开放不同的端口，使用端口来划分API，面向不同调用方
  • 断路器: 在运行时保护你的分布式系统，免于错误雪崩。
  • 流量管理: 可以根据访问特征，微服务元数据，权重等规则灵活控制流量，可支持金丝雀发布等场景。
  • 客户端复杂均衡: 支持定制策略，当前支持roundrobin，随机，会话粘纸与延迟权重。
  • 限流: 客户端，服务端均可限流
  • 可插拔的加解密组件: 加解密组件会被应用到mTLS等安全敏感的处理流程中，可自定义算法
  • Handler Chain: 可以在处理请求的过程中定制特殊逻辑，比如认证鉴权。
  • Metrics: 支持上报prometheus
  • 调用链追踪: 集成opentracing-go作为标准，当前支持zipkin
  • 运行时热加载配置: 集成轻量级配置管理框架go-archaius, 配置可以在运行时热加载，无需重启，比如负载均衡，断路器，流量管理等配置
  • 原生支持动态配置框架: 集成轻量级配置管理框架 go-archaius, 开发者可以实现拥有运行时配置热加载功能的应用
  • API gateway与service mesh方案: 由 servicecomb-mesher提供.
  • Open API 2.0支持 go chassis会自动生成 Open API 2.0 文档并把它注册到Apache ServiceComb的service center. 你可以在统一的服务查看微服务文档。

go chassis插件库 plugins 可以查看目前的插件

Get started

1.生成 go mod

go mod init

2.增加go chassis

GO111MODULE=on go get github.com/go-chassis/go-chassis

如果你面临网络问题

export GOPROXY=https://goproxy.io

3.开始编写你的第一个微服务

文档

这是在线文档 here, 但他总是最新的版本, 如果你使用其他版本的go chassis 你可以跟随这里来生成本地文档

例子

当前有两个例子库，提供很多使用场景

开发 go chassis

  1. 安装go 1.12+

  2. Clone 工程

git clone [email protected]:go-chassis/go-chassis.git
  1. 下载 vendors
cd go-chassis
export GO111MODULE=on 
go mod download
#optional
export GO111MODULE=on 
go mod vendor
  1. 安装Apache ServiceComb service-center

Known Users

欢迎在此登录自己的信息

趣头条