README
¶
Greeter
An example Greeter application
Contents
- srv - an RPC greeter service
- cli - an RPC client that calls the service once
- api - examples of RPC API and RESTful API
- web - how to use go-web to write web services
Deps
Service discovery is required for all services. Default is Consul or MDNS. You can also use plugins from micro/plugins.
MDNS
Use the flag --registry=mdns
Consul
brew install consul
consul agent -dev
Run Service
Start go.micro.srv.greeter
go run srv/main.go
Client
Call go.micro.srv.greeter via client
go run cli/main.go
Examples of client usage via other languages can be found in the client directory.
API
HTTP based requests can be made via the micro API. Micro logically separates API services from backend services. By default the micro API accepts HTTP requests and converts to *api.Request and *api.Response types. Find them here micro/api/proto.
Run the go.micro.api.greeter API Service
go run api/api.go
Run the micro API
micro api
Call go.micro.api.greeter via API
curl http://localhost:8080/greeter/say/hello?name=John
Examples of other API handlers can be found in the API directory.
Sidecar
The sidecar is a language agnostic RPC proxy.
Run the micro sidecar
micro sidecar
Call go.micro.srv.greeter via sidecar
curl -H 'Content-Type: application/json' -d '{"name": "john"}' http://localhost:8081/greeter/say/hello
The sidecar provides all the features of go-micro as a HTTP API. Learn more at micro/car.
Web
The micro web is a web dashboard and reverse proxy to run web apps as microservices.
Run go.micro.web.greeter
go run web/web.go
Run the micro web
micro web
Browse to http://localhost:8082/greeter
Directories
¶
| Path | Synopsis |
|---|---|
|
rpc/proto/hello
Package go_micro_api_greeter is a generated protocol buffer package.
|
Package go_micro_api_greeter is a generated protocol buffer package. |
|
proto/hello
Package go_micro_srv_greeter is a generated protocol buffer package.
|
Package go_micro_srv_greeter is a generated protocol buffer package. |