README.md

gRPC in 3 minutes (Go)

BACKGROUND

For this sample, we've already generated the server and client stubs from helloworld.proto.

PREREQUISITES

• This requires Go 1.6 or later
• Requires that GOPATH is set

$ go help gopath
$ # ensure the PATH contains $GOPATH/bin
$ export PATH=$PATH:$GOPATH/bin

INSTALL

$ go get -u google.golang.org/grpc/examples/helloworld/greeter_client
$ go get -u google.golang.org/grpc/examples/helloworld/greeter_server

TRY IT!

• Run the server

  $ greeter_server &
  

• Run the client

  $ greeter_client
  

OPTIONAL - Rebuilding the generated code

1. Install protobuf compiler

2. Install the protoc Go plugin

   $ go get -u github.com/golang/protobuf/protoc-gen-go
   

3. Rebuild the generated Go code

   $ go generate google.golang.org/grpc/examples/helloworld/...
   

   Or run protoc command (with the grpc plugin)

   $ protoc -I helloworld/ helloworld/helloworld.proto --go_out=plugins=grpc:helloworld