greeter/

directory
v0.0.0-...-ba49760 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 31, 2017 License: Apache-2.0

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
api
rpc
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.
cli
api
srv
proto/hello
Package go_micro_srv_greeter is a generated protocol buffer package.
Package go_micro_srv_greeter is a generated protocol buffer package.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL