Vhds readme (#7415)

Adds documentation for on-demand VHDS/RDS.

Signed-off-by: Brian Avery <bavery@redhat.com>

Mirrored from https://github.com/envoyproxy/envoy @ 8ea6ccb5c3e28479da1978b7376ddc9cf0c6eb3a

envoy/api/v2/discovery.proto

@@ -217,7 +217,6 @@ message Resource {
   // The resource's name, to distinguish it from others of the same type of resource.
   string name = 3;
 
-  // [#not-implemented-hide:]
   // The aliases are a list of other names that this resource can go by.
   repeated string aliases = 4;
 

envoy/api/v2/rds.proto

@@ -71,7 +71,6 @@ message RouteConfiguration {
   // on-demand discovery of virtual hosts. The contents of these two fields will be merged to
   // generate a routing table for a given RouteConfiguration, with *vhds* derived configuration
   // taking precedence.
-  // [#not-implemented-hide:]
   Vhds vhds = 9;
 
   // Optionally specifies a list of HTTP headers that the connection manager
@@ -134,7 +133,6 @@ message RouteConfiguration {
   google.protobuf.BoolValue validate_clusters = 7;
 }
 
-// [#not-implemented-hide:]
 message Vhds {
   // Configuration source specifier for VHDS.
   core.ConfigSource config_source = 1 [(validate.rules).message = {required: true}];

envoy/api/v3alpha/discovery.proto

@@ -231,7 +231,6 @@ message Resource {
   // The resource's name, to distinguish it from others of the same type of resource.
   string name = 3;
 
-  // [#not-implemented-hide:]
   // The aliases are a list of other names that this resource can go by.
   repeated string aliases = 4;
 

envoy/api/v3alpha/rds.proto

@@ -76,7 +76,6 @@ message RouteConfiguration {
   // on-demand discovery of virtual hosts. The contents of these two fields will be merged to
   // generate a routing table for a given RouteConfiguration, with *vhds* derived configuration
   // taking precedence.
-  // [#not-implemented-hide:]
   Vhds vhds = 9;
 
   // Optionally specifies a list of HTTP headers that the connection manager
@@ -139,7 +138,6 @@ message RouteConfiguration {
   google.protobuf.BoolValue validate_clusters = 7;
 }
 
-// [#not-implemented-hide:]
 message Vhds {
   option (udpa.annotations.versioning).previous_message_type = "envoy.api.v2.Vhds";
 

xds_protocol.rst

@@ -656,6 +656,8 @@ resource of a :ref:`DeltaDiscoveryResponse <envoy_api_msg_DeltaDiscoveryResponse
 returned in the name field in the resource of a
 :ref:`DeltaDiscoveryResponse <envoy_api_msg_DeltaDiscoveryResponse>`.
 
+.. _xds_protocol_delta_subscribe:
+
 Subscribing to Resources
 ^^^^^^^^^^^^^^^^^^^^^^^^