grpc-go/examples/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.4
• Requires that GOPATH is set

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

INSTALL

$ go get -u github.com/grpc/grpc-go/examples/greeter_client
$ go get -u github.com/grpc/grpc-go/examples/greeter_server

TRY IT!

• Run the server

$ greeter_server &

• Run the client

$ greeter_client

OPTIONAL - Rebuilding the generated code

1 First install protoc

• For now, this needs to be installed from source
• This is will change once proto3 is officially released

2 Install the protoc Go plugin.

$ go get -a github.com/golang/protobuf/protoc-gen-go
$
$ # from this dir; invoke protoc
$ protoc -I ./helloworld/proto/ ./helloworld/proto/helloworld.proto --go_out=plugins=grpc:helloworld