The Go implementation of gRPC: A high performance, open source, general RPC framework that puts mobile and HTTP/2 first. For more information see the gRPC Quick Start: Go guide.
To install this package, you need to install Go and setup your Go workspace on your computer. The simplest way to install the library is to run:
$ go get -u google.golang.org/grpc
With Go module support (Go 1.11+), simply import "google.golang.org/grpc"
in
your source code and go [build|run|test]
will automatically download the
necessary dependencies (Go modules
ref).
If you are trying to access grpc-go from within China, please see the FAQ below.
gRPC-Go requires Go 1.9 or later.
- See godoc for package and API descriptions.
- Documentation on specific topics can be found in the Documentation directory.
- Examples can be found in the examples directory.
Performance benchmark data for grpc-go and other languages is maintained in this dashboard.
General Availability Google Cloud Platform Launch Stages.
The golang.org
domain may be blocked from some countries. go get
usually
produces an error like the following when this happens:
$ go get -u google.golang.org/grpc
package google.golang.org/grpc: unrecognized import path "google.golang.org/grpc" (https fetch: Get https://google.golang.org/grpc?go-get=1: dial tcp 216.239.37.1:443: i/o timeout)
To build Go code, there are several options:
-
Set up a VPN and access google.golang.org through that.
-
Without Go module support:
< 700D div class="snippet-clipboard-content notranslate position-relative overflow-auto" data-snippet-clipboard-copy-content="git clone https://github.com/grpc/grpc-go.git $GOPATH/src/google.golang.org/grpc">git clone
the repo manually:git clone https://github.com/grpc/grpc-go.git $GOPATH/src/google.golang.org/grpc