126 lines
3.0 KiB
Markdown
126 lines
3.0 KiB
Markdown
# Go Micro - a microservices client/server library
|
|
|
|
This a minimalistic step into microservices using HTTP/RPC and protobuf. It's the first implementation of a microservices "spec" called [Micro](https://github.com/asim/micro).
|
|
|
|
An example server can be found in go-micro/template.
|
|
|
|
[](https://godoc.org/github.com/asim/go-micro)
|
|
|
|
## Prerequisites
|
|
|
|
Consul is the default discovery mechanism provided in go-micro. Discovery is however pluggable.
|
|
|
|
### Install Consul
|
|
[https://www.consul.io/intro/getting-started/install.html](https://www.consul.io/intro/getting-started/install.html)
|
|
|
|
## Getting Started
|
|
|
|
### Run Consul
|
|
```
|
|
$ consul agent -server -bootstrap-expect 1 -data-dir /tmp/consul
|
|
```
|
|
|
|
### Run Service
|
|
```
|
|
$ go run go-micro/template/main.go
|
|
|
|
1416690099281057746 [Debug] Rpc handler /_rpc
|
|
1416690099281092588 [Debug] Starting server go.micro.service.template id go.micro.service.template-c0bfcb44-728a-11e4-b099-68a86d0d36b6
|
|
1416690099281192941 [Debug] Listening on [::]:58264
|
|
1416690099281215346 [Debug] Registering go.micro.service.template-c0bfcb44-728a-11e4-b099-68a86d0d36b6
|
|
```
|
|
|
|
### Test Service
|
|
```
|
|
$ go run go-micro/examples/service_client.go
|
|
|
|
go.micro.service.template-c0bfcb44-728a-11e4-b099-68a86d0d36b6: Hello John
|
|
```
|
|
|
|
## Writing a service
|
|
|
|
### Create request/response proto
|
|
`go-micro/template/proto/example/example.proto`:
|
|
|
|
```
|
|
package go.micro.service.template.example;
|
|
|
|
message Request {
|
|
required string name = 1;
|
|
}
|
|
|
|
message Response {
|
|
required string msg = 1;
|
|
}
|
|
```
|
|
|
|
Compile proto `protoc -I$GOPATH/src --go_out=$GOPATH/src $GOPATH/src/github.com/asim/go-micro/template/proto/example/example.proto`
|
|
|
|
### Create request handler
|
|
`go-micro/template/handler/example.go`:
|
|
|
|
```go
|
|
package handler
|
|
|
|
import (
|
|
"code.google.com/p/go.net/context"
|
|
"code.google.com/p/goprotobuf/proto"
|
|
|
|
"github.com/asim/go-micro/server"
|
|
example "github.com/asim/go-micro/template/proto/example"
|
|
log "github.com/golang/glog"
|
|
)
|
|
|
|
type Example struct{}
|
|
|
|
func (e *Example) Call(ctx context.Context, req *example.Request, rsp *example.Response) error {
|
|
log.Info("Received Example.Call request")
|
|
|
|
rsp.Msg = proto.String(server.Id + ": Hello " + req.GetName())
|
|
|
|
return nil
|
|
}
|
|
```
|
|
|
|
### Init server
|
|
`go-micro/template/main.go`:
|
|
|
|
```go
|
|
package main
|
|
|
|
import (
|
|
"github.com/asim/go-micro/server"
|
|
"github.com/asim/go-micro/template/handler"
|
|
log "github.com/golang/glog"
|
|
)
|
|
|
|
func main() {
|
|
server.Name = "go.micro.service.template"
|
|
|
|
// Initialise Server
|
|
server.Init()
|
|
|
|
// Register Handlers
|
|
server.Register(
|
|
server.NewReceiver(
|
|
new(handler.Example),
|
|
),
|
|
)
|
|
|
|
// Run server
|
|
if err := server.Run(); err != nil {
|
|
log.Fatal(err)
|
|
}
|
|
}
|
|
```
|
|
|
|
### Run service
|
|
```
|
|
$ go run go-micro/template/main.go
|
|
|
|
1416690099281057746 [Debug] Rpc handler /_rpc
|
|
1416690099281092588 [Debug] Starting server go.micro.service.template id go.micro.service.template-c0bfcb44-728a-11e4-b099-68a86d0d36b6
|
|
1416690099281192941 [Debug] Listening on [::]:58264
|
|
1416690099281215346 [Debug] Registering go.micro.service.template-c0bfcb44-728a-11e4-b099-68a86d0d36b6
|
|
```
|