tree: b419a5cfb0da8c35ffd3259b64efa25f6cf54223 [path history] [tgz]
  1. client/
  2. server/
  3. README.md
examples/features/xds/README.md

gRPC xDS example

xDS is the protocol initially used by Envoy, that is evolving into a universal data plan API for service mesh.

The xDS example is a Hello World client/server capable of being configured with the XDS management protocol. Out-of-the-box it behaves the same as our other hello world example. The server replies with responses including its hostname.

xDS environment setup

This example doesn't include instructions to setup xDS environment. Please refer to documentation specific for your xDS management server. Examples will be added later.

The client also needs a bootstrap file. See gRFC A27 for the bootstrap format.

The client

The client application needs to import the xDS package to install the resolver and balancers:

_ "google.golang.org/grpc/xds" // To install the xds resolvers and balancers.

Then, use xds target scheme for the ClientConn.

$ export GRPC_XDS_BOOTSTRAP=/path/to/bootstrap.json
$ go run client/main.go "xDS world" xds:///target_service