39 lines
		
	
	
		
			786 B
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			39 lines
		
	
	
		
			786 B
		
	
	
	
		
			Markdown
		
	
	
	
	
	
| # 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.
 |