quic: Add a DataSource option for server preferred address config (#34946)

This allows for cases when the control plane does not know the correct configuration for the server preferred address, but the needed addresses are available in the context Envoy is running in.

Signed-off-by: Greg Greenway <ggreenway@apple.com>

Mirrored from https://github.com/envoyproxy/envoy @ dbe8cca3787cc0e15f4c3b8d9bed9ab17816e5e3

envoy/extensions/quic/server_preferred_address/v3/datasource.proto

@@ -0,0 +1,53 @@
+syntax = "proto3";
+
+package envoy.extensions.quic.server_preferred_address.v3;
+
+import "envoy/config/core/v3/base.proto";
+
+import "xds/annotations/v3/status.proto";
+
+import "udpa/annotations/status.proto";
+import "validate/validate.proto";
+
+option java_package = "io.envoyproxy.envoy.extensions.quic.server_preferred_address.v3";
+option java_outer_classname = "DatasourceProto";
+option java_multiple_files = true;
+option go_package = "github.com/envoyproxy/go-control-plane/envoy/extensions/quic/server_preferred_address/v3;server_preferred_addressv3";
+option (udpa.annotations.file_status).package_version_status = ACTIVE;
+
+// [#protodoc-title: QUIC DataSource server preferred address config]
+// [#extension: envoy.quic.server_preferred_address.datasource]
+
+// Configuration for DataSourceServerPreferredAddressConfig.
+message DataSourceServerPreferredAddressConfig {
+  // [#comment:TODO(danzh2010): discuss with API shepherds before removing WiP status.]
+
+  option (xds.annotations.v3.message_status).work_in_progress = true;
+
+  // Addresses for server preferred address for a single address family (IPv4 or IPv6).
+  message AddressFamilyConfig {
+    // The server preferred address sent to clients. The data must contain an IP address string.
+    config.core.v3.DataSource address = 1 [(validate.rules).message = {required: true}];
+
+    // The server preferred address port sent to clients. The data must contain a integer port value.
+    //
+    // If this is not specified, the listener's port is used.
+    //
+    // Note: Envoy currently must receive all packets for a QUIC connection on the same port, so unless
+    // :ref:`dnat_address <envoy_v3_api_field_extensions.quic.server_preferred_address.v3.DataSourceServerPreferredAddressConfig.AddressFamilyConfig.dnat_address>`
+    // is configured, this must be left unset.
+    config.core.v3.DataSource port = 2;
+
+    // If there is a DNAT between the client and Envoy, the address that Envoy will observe
+    // server preferred address packets being sent to. If this is not specified, it is assumed
+    // there is no DNAT and the server preferred address packets will be sent to the address advertised
+    // to clients for server preferred address.
+    config.core.v3.DataSource dnat_address = 3;
+  }
+
+  // The IPv4 address to advertise to clients for Server Preferred Address.
+  AddressFamilyConfig ipv4_config = 1;
+
+  // The IPv6 address to advertise to clients for Server Preferred Address.
+  AddressFamilyConfig ipv6_config = 2;
+}

envoy/extensions/quic/server_preferred_address/v3/fixed_server_preferred_address_config.proto

@@ -14,7 +14,7 @@ option java_multiple_files = true;
 option go_package = "github.com/envoyproxy/go-control-plane/envoy/extensions/quic/server_preferred_address/v3;server_preferred_addressv3";
 option (udpa.annotations.file_status).package_version_status = ACTIVE;
 
-// [#protodoc-title: QUIC server preferred address config]
+// [#protodoc-title: QUIC fixed server preferred address config]
 // [#extension: envoy.quic.server_preferred_address.fixed]
 
 // Configuration for FixedServerPreferredAddressConfig.