Go-Chassis

Go-Chassis is a Software Development Kit(SDK) for rapid development of microservices in Go

Go-chassis is based on Go-Micro A pluggable RPC framework

Features

• Pluggable registrator and discovery service: Support Service center,istio pilot 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 highway(RPC)
• Circuit breaker: Protect your service in runtime or on-demand
• Route management: Able to route to different service based on weight and match rule to achieve Canary Release easily
• Load balancing: Able to custom strategy and filter
• 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: A lot of configuration can be reload in runtime, like loadbalancing, circuit breaker, rate limiting
• Dynamic Configuration framework: 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.8+

2. Clone the project

git clone git@github.com:go-chassis/go-chassis.git

3. Use use go mod(go 1.11+, experimental but a recommended way)

cd go-chassis
GO111MODULE=on go mod download
#optional
GO111MODULE=on go mod vendor

4. Install service-center

5. Write your first http micro service

Examples

You can check examples here

Communication Protocols

Go-Chassis supports two 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

Debug suggestion for dlv:

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

example:

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

Chassis customized debug tag to resolve dlv debug issue:

golang/go#23733

https://github.com/derekparker/delve/issues/865