snapshot of https://github.com/grpc/grpc-go.git (master, 2026-09-15; blobs > 131072B omitted)

examples/features/xds/README.md

@@ -0,0 +1,35 @@
+# gRPC xDS example
+
+xDS is the protocol initially used by Envoy, that is evolving into a universal
+data plane 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](https://github.com/grpc/grpc-go/tree/master/examples/helloworld). 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](https://github.com/grpc/proposal/blob/master/A27-xds-global-load-balancing.md#xdsclient-and-bootstrap-file)
+for the bootstrap format.
+
+## The client
+
+The client application needs to import the xDS package to install the resolver and balancers:
+
+```go
+_ "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
+```