Skip to content
a microservice framework for rapid development of micro services in Go
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE Update issue templates Jan 14, 2019
auth improvement: remove cse auth (#294) Jul 28, 2018
bootstrap improve dev experience; add log in circuit (#424) Nov 5, 2018
client upgrade archaius (#557) Mar 12, 2019
control refactor rate limiting (#545) Mar 5, 2019
core bug fix: dynamic router not work (#566) Mar 21, 2019
eventlistener api level circuit breaker and example (#417) Oct 30, 2018
examples upgrade archaius (#557) Mar 12, 2019
healthz new feature: supply more options for api spec (#482) Dec 22, 2018
initiator improvement: init logger before other module start (#368) Sep 13, 2018
licenses rename pkg (#290) Jul 27, 2018
metrics optimize code (#562) Mar 18, 2019
server fix critical bug: https server do not accept http and https request (#… Mar 18, 2019
session alter SessionStickiness strategy save cookie with cache and support r… Nov 6, 2018
.gitignore Support the governance configuration key format with appID Nov 14, 2018
.travis.yml bug fix: dynamic timeout config does not work (#534) Mar 1, 2019 edit doc to show how to use CSE (#532) Feb 22, 2019
LICENSE rename pkg (#290) Jul 27, 2018
chassis.go return error (#567) Mar 20, 2019
chassis_test.go fix go routine massive increase, if there is too much metrics collect… Oct 29, 2018

Build Status Coverage Status Go Report Card GoDoc HitCount Join Slack

Go-Chassis is a microservice framework for rapid development of microservices in Go

Why use Go chassis

go chassis is designed as a protocol-independent framework, any protocol is able to integrate with go chassis and leverage same function like load balancing, circuit breaker,rate limiting, routing management, those function resilient your service

go chassis makes service observable by bring open tracing and prometheus to it.

go chassis is flexible, many different modules can be replaced by other implementation, like registry, metrics, handler chain, config center etc

With many build-in function like route management, circuit breaker, load balancing, monitoring etc, your don't need to investigate, implement and integrate many solutions yourself.

go chassis supports Istio platform, Although Istio is a great platform with a service mesh in data plane, it surely decrease the throughput and increase the latency of your service go chassis can bring better performance to go program, you can use Istio configurations to control go chassis.

Go chassis also has a service mesh solution, it is build on top of go chassis. you can use same registry, configuration to goven all of service writen in diffrent language.


  • Pluggable registrator and discovery service: Support Service center, istio pilot, kubernetes and file based registry, fit both client side discovery and server side discovery pattern
  • Pluggable Protocol: You can custom your own protocol, by default support http and grpc
  • Multiple server management: you can separate API by protocols and ports
  • Circuit breaker: Protect your micro service system in runtime
  • Route management: Able to route to different service based on weight and match rule to achieve Canary Release easily
  • Client side Load balancing: Able to custom strategy
  • Rate limiting: Both client side and server side rate limiting
  • Pluggable Cipher: Able to custom your own cipher for AKSK and TLS certs
  • Handler Chain: Able to add your own code during service calling for client and server side
  • Metrics: Able to expose Prometheus metric API automatically and custom metrics reporter
  • Tracing:Use opentracing-go as standard library, easy to integrate tracing impl
  • Logger: You can custom your own writer to sink log, by default support file and stdout
  • Hot-reconfiguraion: Powered by go-archaius, configurations can be reload in runtime, like load balancing, circuit breaker, rate limiting
  • Dynamic Configuration framework: Powered by go-archaius, developer is able to develop a service which has hot-reconfiguration feature easily
  • Fault Injection: In consumer side, you can inject faults to bring chaos testing into your system

You can check plugins to see more features

Quick Start

You can see more documentations in here

  1. Install go 1.10+

  2. Clone the project

git clone
  1. Use go mod(go 1.11+, experimental but a recommended way)
cd go-chassis
export GO111MODULE=on 
go mod download
export GO111MODULE=on 
go mod vendor

NOTICE:if you do not use mod, We can not ensure you the compatibility. however you can still maintain your own vendor, which means you have to solve compiling issue your own.

  1. Install service-center

  2. Write your first http micro service


You can check examples here

NOTICE: Now examples is migrating to here

Communication Protocols

Go-Chassis supports 3 types of communication protocol.

  1. Rest - REST is an approach that leverages the HTTP protocol for communication.
  2. Highway - This is a RPC communication protocol, it was deprecated.
  3. grpc - native grpc protocol, go chassis bring circuit breaker, route management etc to grpc.

Debug suggestion for dlv:

Add -tags debug into go build arguments before debugging, if your go version is go1.10 onward.


go build -tags debug -o server -gcflags "all=-N -l" server.go

Chassis customized debug tag to resolve dlv debug issue:

Eco system

this part introduce some eco systems that go chassis can run with

Apache ServiceComb

With ServiceComb service center as registry, go chassis supply more features like contract management and multiple service registry, highly recommended. that will not prevent you from using kubernetes or Istio, Because service center can aggregate heterogeneous registry and give you a unified service registry entry point.

Kubenetes and Istio

go chassis has k8s registry and Istio registry plugins, and support Istio traffic management you can use spring cloud or Envoy with go chassis under same service discovery service.

You can’t perform that action at this time.