New Template

micro new [service]

The micro new command is a quick way to generate boilerplate templates for micro services.

Usage

Create a new service by specifying a directory path relative to your $GOPATH

  1. micro new github.com/micro/foo

Here it is in action

  1. micro new github.com/micro/foo
  3. creating service go.micro.srv.foo
  4. creating /Users/asim/checkouts/src/github.com/micro/foo
  5. creating /Users/asim/checkouts/src/github.com/micro/foo/main.go
  6. creating /Users/asim/checkouts/src/github.com/micro/foo/handler
  7. creating /Users/asim/checkouts/src/github.com/micro/foo/handler/example.go
  8. creating /Users/asim/checkouts/src/github.com/micro/foo/subscriber
  9. creating /Users/asim/checkouts/src/github.com/micro/foo/subscriber/example.go
  10. creating /Users/asim/checkouts/src/github.com/micro/foo/proto/example
  11. creating /Users/asim/checkouts/src/github.com/micro/foo/proto/example/example.proto
  12. creating /Users/asim/checkouts/src/github.com/micro/foo/Dockerfile
  13. creating /Users/asim/checkouts/src/github.com/micro/foo/README.md
  15. download protobuf for micro:
  17. go get github.com/micro/protobuf/{proto,protoc-gen-go}
  19. compile the proto file example.proto:
  21. protoc -I/Users/asim/checkouts/src \
  22.     --go_out=plugins=micro:/Users/asim/checkouts/src \
  23.     /Users/asim/checkouts/src/github.com/micro/foo/proto/example/example.proto

Options

Specify more options such as namespace, type, fqdn and alias

  1. micro new --fqdn com.example.srv.foo github.com/micro/foo

Help

  1. NAME:
  2.    micro new - Create a new micro service
  4. USAGE:
  5.    micro new [command options] [arguments...]
  7. OPTIONS:
  8.    --namespace "go.micro"    Namespace for the service e.g com.example
  9.    --type "srv"            Type of service e.g api, srv, web
  10.    --fqdn             FQDN of service e.g com.example.srv.service (defaults to namespace.type.alias)
  11.    --alias             Alias is the short name used as part of combined name if specified