Micro Examples 
This is a repository for micro examples. Feel free to contribute.
Contents
- api - Provides API usage examples
- booking - A booking.com demo application
- broker - A example of using Broker for Publish and Subscribing.
- client - Usage of the Client package to call a service.
- command - An example of bot commands as micro services
- event - Using the API Gateway event handler
- flags - Using command line flags with a service
- form - How to parse a form behind the micro api
- function - Example of using Function programming model
- graceful - Demonstrates graceful shutdown of a service
- greeter - A complete greeter example (includes python, ruby examples)
- heartbeat - Make services heartbeat with discovery for high availability
- metadata - Extracting metadata from context of a request
- options - Setting options in the go-micro framework
- plugins - How to use plugins
- pubsub - Example of using pubsub at the client/server level
- grpc - Examples of how to use go-grpc
- redirect - An example of how to http redirect using an API service
- roundrobin - A stateful client wrapper for true round robin of requests
- secure - Demonstrates use of transport secure option for self signed certs
- server - Use of the Server package directly to server requests.
- service - Example of the top level Service in go-micro.
- sharding - An example of how to shard requests or use session affinity
- shutdown - Demonstrates graceful shutdown via context cancellation
- sidecar - Greeter service using the sidecar with multiple languages
- stream - An example of a streaming service and client
- template - Api, web and srv service templates generated with the 'micro new' command
- waitgroup - Demonstrates how to use a waitgroup with a service
- wrapper - A simple example of using a log wrapper
External
- auth-srv - An Oauth2 authentication service
- geo-srv - Geolocation tracking service using hailocab/go-geoindex
- geo-web - Web demo for the geo srv
- geo-api - API for the geo srv
- discovery-srv - A discovery in the micro platform
- geocode-srv - A geocoding service using the Google Geocoding API
- hailo-srv - A service for the hailo taxi service developer api
- monitor-srv - A monitoring service for Micro services
- place-srv - A microservice to store and retrieve places (includes Google Place Search API)
- slack-srv - The slack bot API as a go-micro RPC service
- trace-srv - A distributed tracing microservice in the realm of dapper, zipkin, etc
- twitter-srv - A microservice for the twitter API
- user-srv - A microservice for user management and authentication
Community
Find contributions from the community via the explorer
- go-shopping - A sample product with a suite of services
Dependencies
Service Discovery
All services require service discovery. The default is Consul or MDNS.
Consul
Install
brew install consul
Run
consul agent -dev
Multicast DNS
Use flag --registry=mdns for a zero dependency configuration
Protobuf
Protobuf is used for code generation of message types and client/hander stubs.
If making changes recompile the protos.
Install
go get github.com/micro/protobuf/{proto,protoc-gen-go}Compile Proto
protoc -I$GOPATH/src --go_out=plugins=micro:$GOPATH/src \
$GOPATH/src/github.com/micro/examples/service/proto/greeter.proto