xDS API Working Group
Go to file
bsurber 2ac532fd44
keep_matching in OnMatch to skip matched Matchers (#117)
* Add a keep_matching field to OnMatch which indicates to callers that it should not enforce the matcher's action and instead continue looking for another match if possible

Signed-off-by: Brian Surber <bsurber@google.com>

* Commit synchronized, generated files

Signed-off-by: Brian Surber <bsurber@google.com>

* Add clarification of default behaviors when the field's support hasn't yet been implemented.

Signed-off-by: Brian Surber <bsurber@google.com>

---------

Signed-off-by: Brian Surber <bsurber@google.com>
2025-05-01 15:58:37 -07:00
bazel bazel: Add support for bzlmod (#96) 2024-07-23 10:28:45 -04:00
ci python: Add support for generating python proto code (#110) 2025-01-21 14:12:32 -05:00
go keep_matching in OnMatch to skip matched Matchers (#117) 2025-05-01 15:58:37 -07:00
proposals xRFC TP3: Error Propagation (#107) 2024-12-13 13:47:25 -08:00
python keep_matching in OnMatch to skip matched Matchers (#117) 2025-05-01 15:58:37 -07:00
test/build Duplicate all protos from udpa tree to xds tree (#17) 2021-10-11 10:35:35 -07:00
tools python: Add support for generating python proto code (#110) 2025-01-21 14:12:32 -05:00
udpa annotations: correct go_package (#80) 2023-11-27 19:30:11 -05:00
xds keep_matching in OnMatch to skip matched Matchers (#117) 2025-05-01 15:58:37 -07:00
.bazelrc Fix build environment following cncf/udpa -> cncf/xds migration. (#5) 2021-03-12 17:13:58 -05:00
.bazelversion bazel: Add support for bzlmod (#96) 2024-07-23 10:28:45 -04:00
.gitattributes Fix build environment following cncf/udpa -> cncf/xds migration. (#5) 2021-03-12 17:13:58 -05:00
.gitignore python: Add support for generating python proto code (#110) 2025-01-21 14:12:32 -05:00
BUILD Migrate content from https://github.com/cncf/udpa. 2021-02-10 13:29:38 +00:00
DEVELOPER.md Migrate content from https://github.com/cncf/udpa. 2021-02-10 13:29:38 +00:00
LICENSE Initial commit 2020-11-19 10:02:01 -06:00
MODULE.bazel python: Add support for generating python proto code (#110) 2025-01-21 14:12:32 -05:00
README.md Migrate content from https://github.com/cncf/udpa. 2021-02-10 13:29:38 +00:00
WORKSPACE Fix build environment following cncf/udpa -> cncf/xds migration. (#5) 2021-03-12 17:13:58 -05:00
WORKSPACE.bzlmod bazel: Add support for bzlmod (#96) 2024-07-23 10:28:45 -04:00
repokitteh.star Migrate content from https://github.com/cncf/udpa. 2021-02-10 13:29:38 +00:00

README.md

xDS API Working Group (xDS-WG)

Goal

The objective of the xDS API Working Group (xDS-WG) is to bring together parties across the industry interested in a common control and configuration API for data plane proxies and load balancers, based on the xDS APIs.

Vision

The xDS vision is one of a universal data plane API, articulated at https://blog.envoyproxy.io/the-universal-data-plane-api-d15cec7a. xDS aims to provide a set of APIs that provide the de facto standard for L4/L7 data plane configuration, similar to the role played by OpenFlow at L2/L3/L4 in SDN.

The existing Envoy xDS APIs constitute the basis for this vision and will incrementally evolve towards supporting a goal of client neutrality. We will evolve the xDS APIs to support additional clients, for example data plane proxies beyond Envoy, proxyless service mesh libraries, hardware load balancers, mobile clients and beyond. We will strive to be vendor and implementation agnostic to the degree possible while not regressing on support for data plane components that have committed to xDS in production (Envoy & gRPC to date).

The xDS APIs have two delineated aspects, a transport protocol and data model, The xDS transport protocol provides a low latency versioned streaming gRPC delivery of xDS resources. The data model covers common data plane concerns such as service discovery, load balancing assignments, routing discovery, listener configuration, secret discovery, load reporting, health check delegation, etc.

Repository structure

The xDS APIs are split between this repository and https://github.com/envoyproxy/envoy/tree/main/api. Our long-term goal is to move the entire API to this repository, this will be done opportunistically over time as we generalize parts of the API to be less client-specific.

Mailing list and meetings

We have an open mailing list xds-wg@lists.cncf.io for communication and announcements. We also meet on an ad hoc basis via Zoom.

To monitor activity, you can either subscribe to a GitHub watch on this repository or join the @cncf/xds-wg team for tagging on key PRs and RFCs.