2022-04-07 19:13:56 +03:00
# Micro [](https://opensource.org/licenses/Apache-2.0) [](https://pkg.go.dev/github.com/unistack-org/micro/v3?tab=overview) [](https://github.com/unistack-org/micro/actions?query=workflow%3Abuild+branch%3Amaster+event%3Apush) [](https://goreportcard.com/report/go.unistack.org/micro/v3) [](https://codecov.io/gh/unistack-org/micro)
2015-01-13 23:31:27 +00:00
2020-08-25 14:16:08 +03:00
Micro is a standard library for microservices.
2016-06-20 02:52:38 +01:00
2018-11-27 19:43:57 +00:00
## Overview
2020-08-25 14:16:08 +03:00
Micro provides the core requirements for distributed systems development including RPC and Event driven communication.
2018-11-27 19:43:57 +00:00
2016-12-07 16:54:19 +00:00
## Features
2016-07-03 02:49:13 +01:00
2020-08-25 14:16:08 +03:00
Micro abstracts away the details of distributed systems. Here are the main features.
2016-07-03 02:49:13 +01:00
2020-05-31 11:26:46 +01:00
- **Authentication** - Auth is built in as a first class citizen. Authentication and authorization enable secure
zero trust networking by providing every service an identity and certificates. This additionally includes rule
based access control.
- **Dynamic Config** - Load and hot reload dynamic config from anywhere. The config interface provides a way to load application
level config from any source such as env vars, file, etcd. You can merge the sources and even define fallbacks.
- **Data Storage** - A simple data store interface to read, write and delete records. It includes support for memory, file and
CockroachDB by default. State and persistence becomes a core requirement beyond prototyping and Micro looks to build that into the framework.
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
2020-08-25 14:16:08 +03:00
development. When service A needs to speak to service B it needs the location of that service.
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
2020-08-25 14:16:08 +03:00
and server handle this by default.
2018-12-02 13:23:46 +00:00
2020-08-25 14:16:08 +03:00
- **Transport** - gRPC or http 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.
2018-12-02 13:23:46 +00:00
2020-08-25 14:16:08 +03:00
- **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.
2018-11-27 19:43:57 +00:00
2020-05-31 11:21:55 +01:00
- **Synchronization** - Distributed systems are often built in an eventually consistent manner. Support for distributed locking and
leadership are built in as a Sync interface. When using an eventually consistent database or scheduling use the Sync interface.
2020-08-25 14:16:08 +03:00
- **Pluggable Interfaces** - Micro makes use of Go interfaces for each system abstraction. Because of this these interfaces
are pluggable and allows Micro to be runtime agnostic.
2018-12-02 13:26:38 +00:00
2018-11-14 15:18:13 +00:00
## Getting Started
2017-02-10 12:36:42 +00:00
2020-08-25 14:16:08 +03:00
To be created.
2020-04-19 00:46:33 +01:00
## License
2020-08-25 14:16:08 +03:00
Micro is Apache 2.0 licensed.
2020-04-19 00:46:33 +01:00
