# Service

This is an example of creating a micro service using the top level interface.

## Prereqs

Micro services need a discovery system so they can find each other. Micro uses consul by default but 
its easily swapped out with etcd, kubernetes, or various other systems. We'll run consul for convenience.

1. Follow the install instructions - [https://www.consul.io/intro/getting-started/install.html](https://www.consul.io/intro/getting-started/install.html)

2. Run Consul

```shell
$ consul agent -dev -advertise=127.0.0.1
```

## Run the example

1. Get the service

```shell
go get github.com/micro/go-micro/examples/service
```

2. Run the server

```shell
$GOPATH/bin/service
```

3. Run the client

```shell
$GOPATH/bin/service --client
```

And that's all there is to it.