Discovery server is a microservice which layers on the registry to provide heartbeating, in memory caching and much more. It subscribes to heartbeats and maintains a registry based on liveness.
It's built with the Eureka 2.0 design in mind. The Discovery service acts as a read layer cache where the usage of a Registry like Consul, Etcd, Zookeeper act as the write layer. With the combination of the Registry, Discovery and Platform we can develop a highly available discovery system.
-
Install Consul
Consul is the default registry/discovery for go-micro apps. It's however pluggable. https://www.consul.io/intro/getting-started/install.html
-
Run Consul
$ consul agent -server -bootstrap-expect 1 -data-dir /tmp/consul -
Download and start the service
go get github.com/micro/discovery-srv discovery-srv
OR as a docker container
docker run microhq/discovery-srv --registry_address=YOUR_REGISTRY_ADDRESS
Discovery server implements the following RPC Methods
micro query go.micro.srv.discovery Discovery.Heartbeats
{
"heartbeats": [
{
"id": "foo-123",
"interval": 1,
"service": {
"endpoints": [
{
"metadata": {
"index": "Handles index requests"
},
"name": "/index",
"request": {
"name": "request",
"type": "Request"
},
"response": {
"name": "response",
"type": "Response"
}
}
],
"metadata": {
"foo": "bar"
},
"name": "go.micro.srv.foo",
"nodes": [
{
"address": "localhost",
"id": "foo-123",
"metadata": {
"bar": "baz"
},
"port": 8080
}
],
"version": "latest"
},
"timestamp": 1.451177551e+09,
"ttl": 5
}
]
}micro query go.micro.srv.discovery Discovery.Endpoints
{
"endpoints": [
{
"endpoint": {
"metadata": {
"index": "Handles index requests"
},
"name": "/index",
"request": {
"name": "request",
"type": "Request"
},
"response": {
"name": "response",
"type": "Response"
}
},
"service": "go.micro.srv.foo",
"version": "latest"
}
]
}Heartbeats are sent to the discovery service using go-platform/discovery