grpc-go/examples
Patrice Chalin 31d22c78fb
examples: use grpc v1.30.0 rather than v1.30.0-dev.1 (#3710)
2020-06-25 14:28:39 -07:00
..
features test: replace manual.GenerateAndRegisterManualResolver with grpc.WithResolvers (#3700) 2020-06-23 09:49:44 -07:00
helloworld protoc-gen-go-grpc: add requirement of embedding UnimplementedServer in services (#3657) 2020-06-04 10:56:13 -07:00
route_guide protoc-gen-go-grpc: add requirement of embedding UnimplementedServer in services (#3657) 2020-06-04 10:56:13 -07:00
README.md internal: clean up README (#2764) 2019-04-11 10:11:17 -07:00
examples_test.sh examples: make test script output easier to read (#3711) 2020-06-25 10:40:16 -07:00
go.mod examples: use grpc v1.30.0 rather than v1.30.0-dev.1 (#3710) 2020-06-25 14:28:39 -07:00
go.sum examples: use grpc v1.30.0 rather than v1.30.0-dev.1 (#3710) 2020-06-25 14:28:39 -07:00
gotutorial.md examples: remove duplicated words (#2654) 2019-02-25 10:07:04 -08:00

README.md

gRPC in 3 minutes (Go)

BACKGROUND

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

PREREQUISITES

$ 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