Versioning

Envoy has API versions for both the xDS transport, i.e. the wire protocol for moving resources between a management server and Envoy, and for resources. These are known as the transport and resource API version respectively.

Both the transport and resource API versions follow the API versioning support and deprecation policy.

Envoy will internally operate at the latest xDS resource version and all supported versioned resources will be transparently upgrading to this latest version on configuration ingestion. For example, v2 and v3 resources, delivered over either a v2 or v3 transport, or any mix thereof, will be internally converted into v3 resources.