2016-06-20 02:54:06 +01:00
|
|
|
# Go Micro [![License](https://img.shields.io/:license-apache-blue.svg)](https://opensource.org/licenses/Apache-2.0) [![GoDoc](https://godoc.org/github.com/micro/go-micro?status.svg)](https://godoc.org/github.com/micro/go-micro) [![Travis CI](https://api.travis-ci.org/micro/go-micro.svg?branch=master)](https://travis-ci.org/micro/go-micro) [![Go Report Card](https://goreportcard.com/badge/micro/go-micro)](https://goreportcard.com/report/github.com/micro/go-micro)
|
2015-01-13 23:31:27 +00:00
|
|
|
|
2018-12-02 10:23:19 +00:00
|
|
|
Go Micro is a pluggable framework for micro service development.
|
2016-06-20 02:52:38 +01:00
|
|
|
|
2018-11-27 19:43:57 +00:00
|
|
|
## Overview
|
|
|
|
|
|
|
|
Go Micro provides the core requirements for distributed systems development including RPC and Event driven communication.
|
|
|
|
The **micro** philosophy is sane defaults with a pluggable architecture. We provide defaults to get you started quickly
|
|
|
|
but everything can be easily swapped out.
|
|
|
|
|
2018-11-29 09:02:15 +00:00
|
|
|
<img src="https://micro.mu/docs/images/go-micro.png" />
|
|
|
|
|
2018-03-19 10:21:46 +00:00
|
|
|
Plugins are available at [github.com/micro/go-plugins](https://github.com/micro/go-plugins).
|
2015-01-14 08:38:39 +00:00
|
|
|
|
2017-07-16 14:58:31 +01:00
|
|
|
Follow us on [Twitter](https://twitter.com/microhq) or join the [Slack](http://slack.micro.mu/) community.
|
2016-12-25 20:53:08 +00:00
|
|
|
|
2016-12-07 16:54:19 +00:00
|
|
|
## Features
|
2016-07-03 02:49:13 +01:00
|
|
|
|
2017-06-15 19:57:27 +01:00
|
|
|
Go Micro abstracts away the details of distributed systems. Here are the main features.
|
2016-07-03 02:49:13 +01:00
|
|
|
|
2018-12-02 13:23:46 +00:00
|
|
|
- **Service Discovery** - Automatic service registration and name resolution. Service discovery is at the core of micro service
|
|
|
|
development. When service A needs to speak to service B it needs the location of that service. Consul is the default discovery
|
2018-12-06 18:46:02 +00:00
|
|
|
system with multicast DNS (mdns) as a local option or the SWIM protocol (gossip) for zero dependency p2p networks.
|
2018-12-02 13:23:46 +00:00
|
|
|
|
|
|
|
- **Load Balancing** - Client side load balancing built on service discovery. Once we have the addresses of any number of instances
|
|
|
|
of a service we now need a way to decide which node to route to. We use random hashed load balancing to provide even distribution
|
|
|
|
across the services and retry a different node if there's a problem.
|
|
|
|
|
|
|
|
- **Message Encoding** - Dynamic message encoding based on content-type. The client and server will use codecs along with content-type
|
|
|
|
to seamlessly encode and decode Go types for you. Any variety of messages could be encoded and sent from different clients. The client
|
2018-12-26 12:03:08 +00:00
|
|
|
and server handle this by default. This includes protobuf and json by default.
|
2018-12-02 13:23:46 +00:00
|
|
|
|
|
|
|
- **Sync Streaming** - RPC based request/response with support for bidirectional streaming. We provide an abstraction for synchronous
|
|
|
|
communication. A request made to a service will be automatically resolved, load balanced, dialled and streamed. The default
|
|
|
|
transport is http/1.1 or http2 when tls is enabled.
|
|
|
|
|
|
|
|
- **Async Messaging** - PubSub is built in as a first class citizen for asynchronous communication and event driven architectures.
|
|
|
|
Event notifications are a core pattern in micro service development. The default messaging is point-to-point http/1.1 or http2 when tls
|
|
|
|
is enabled.
|
2018-11-27 19:43:57 +00:00
|
|
|
|
2018-12-02 13:26:38 +00:00
|
|
|
- **Pluggable Interfaces** - Go Micro makes use of Go interfaces for each distributed system abstraction. Because of this these interfaces
|
|
|
|
are pluggable and allows Go Micro to be runtime agnostic. You can plugin any underlying technology. Find plugins in
|
|
|
|
[github.com/micro/go-plugins](https://github.com/micro/go-plugins).
|
|
|
|
|
2018-11-14 15:18:13 +00:00
|
|
|
## Getting Started
|
2017-02-10 12:36:42 +00:00
|
|
|
|
2018-11-21 13:10:09 +00:00
|
|
|
See the [docs](https://micro.mu/docs/go-micro.html) for detailed information on the architecture, installation and use of go-micro.
|
2017-02-10 12:36:42 +00:00
|
|
|
|
2016-04-26 12:18:18 +01:00
|
|
|
## Sponsors
|
|
|
|
|
2018-04-12 12:09:36 +01:00
|
|
|
Sixt is an Enterprise Sponsor of Micro
|
2016-04-26 12:18:18 +01:00
|
|
|
|
2017-02-11 14:26:47 +00:00
|
|
|
<a href="https://micro.mu/blog/2016/04/25/announcing-sixt-sponsorship.html"><img src="https://micro.mu/sixt_logo.png" width=150px height="auto" /></a>
|
2018-04-12 12:09:36 +01:00
|
|
|
|
|
|
|
Become a sponsor by backing micro on [Patreon](https://www.patreon.com/microhq)
|