feat: implement dynamic module lb policy

api/v1alpha1/dynamic_module_types.go

@@ -120,10 +120,10 @@ type DynamicModule struct {
 	// +kubebuilder:validation:Pattern=`^[a-z0-9]([a-z0-9.-]*[a-z0-9])?$`
 	Name string `json:"name"`
 
-	// FilterName identifies a specific filter implementation within the dynamic
-	// module. A single shared library can contain multiple filter implementations.
-	// This value is passed to the module's HTTP filter config init function to
-	// select the appropriate implementation.
+	// FilterName identifies a specific HTTP filter implementation within the
+	// dynamic module. A single shared library can contain multiple filter
+	// implementations; this value is passed to the module's initialization
+	// function to select one.
 	// If not specified, defaults to an empty string.
 	//
 	// +optional

api/v1alpha1/loadbalancer_types.go

@@ -51,7 +51,6 @@ type LoadBalancer struct {
 	// EnvoyProxy resource's dynamicModules allowlist.
 	//
 	// +optional
-	// +notImplementedHide
 	DynamicModule *DynamicModuleLBPolicy `json:"dynamicModule,omitempty"`
 
 	// EndpointOverride defines the configuration for endpoint override.
@@ -91,7 +90,6 @@ const (
 	// BackendUtilizationLoadBalancerType load balancer policy.
 	BackendUtilizationLoadBalancerType LoadBalancerType = "BackendUtilization"
 	// DynamicModuleLoadBalancerType load balancer policy.
-	// +notImplementedHide
 	DynamicModuleLoadBalancerType LoadBalancerType = "DynamicModule"
 )
 
@@ -236,8 +234,6 @@ type BackendUtilization struct {
 // The module must be registered in the EnvoyProxy resource's dynamicModules allowlist.
 //
 // See https://www.envoyproxy.io/docs/envoy/latest/api-v3/extensions/load_balancing_policies/dynamic_modules/v3/dynamic_modules.proto
-//
-// +notImplementedHide
 type DynamicModuleLBPolicy struct {
 	// Name references a dynamic module registered in the EnvoyProxy resource's
 	// dynamicModules list. The referenced module must exist in the registry;
@@ -248,18 +244,18 @@ type DynamicModuleLBPolicy struct {
 	// +kubebuilder:validation:Pattern=`^[a-z0-9]([a-z0-9.-]*[a-z0-9])?$`
 	Name string `json:"name"`
 
-	// LBPolicyName identifies a specific load balancer implementation within
-	// the dynamic module. A single shared library can contain multiple LB
-	// policy implementations. This value is passed to the module's
-	// initialization function to select the appropriate implementation.
+	// PolicyName identifies a specific load balancing policy implementation
+	// within the dynamic module. A single shared library can contain multiple
+	// policy implementations; this value is passed to the module's
+	// initialization function to select one.
+	// If not specified, defaults to an empty string.
 	//
-	// +kubebuilder:validation:MinLength=1
+	// +optional
 	// +kubebuilder:validation:MaxLength=253
-	LBPolicyName string `json:"lbPolicyName"`
+	PolicyName *string `json:"policyName,omitempty"`
 
-	// Config is optional configuration for the module's load balancer
-	// implementation. This is serialized and passed to the module's
-	// initialization function.
+	// Config is the configuration for the dynamic module load balancer policy.
+	// This is serialized as JSON and passed to the module's initialization function.
 	//
 	// +optional
 	Config *apiextensionsv1.JSON `json:"config,omitempty"`

charts/gateway-crds-helm/templates/generated/gateway.envoyproxy.io_backendtrafficpolicies.yaml

@@ -1197,19 +1197,9 @@ spec:
                     properties:
                       config:
                         description: |-
-                          Config is optional configuration for the module's load balancer
-                          implementation. This is serialized and passed to the module's
-                          initialization function.
+                          Config is the configuration for the dynamic module load balancer policy.
+                          This is serialized as JSON and passed to the module's initialization function.
                         x-kubernetes-preserve-unknown-fields: true
-                      lbPolicyName:
-                        description: |-
-                          LBPolicyName identifies a specific load balancer implementation within
-                          the dynamic module. A single shared library can contain multiple LB
-                          policy implementations. This value is passed to the module's
-                          initialization function to select the appropriate implementation.
-                        maxLength: 253
-                        minLength: 1
-                        type: string
                       name:
                         description: |-
                           Name references a dynamic module registered in the EnvoyProxy resource's
@@ -1219,8 +1209,16 @@ spec:
                         minLength: 1
                         pattern: ^[a-z0-9]([a-z0-9.-]*[a-z0-9])?$
                         type: string
+                      policyName:
+                        description: |-
+                          PolicyName identifies a specific load balancing policy implementation
+                          within the dynamic module. A single shared library can contain multiple
+                          policy implementations; this value is passed to the module's
+                          initialization function to select one.
+                          If not specified, defaults to an empty string.
+                        maxLength: 253
+                        type: string
                     required:
-                    - lbPolicyName
                     - name
                     type: object
                   endpointOverride:

charts/gateway-crds-helm/templates/generated/gateway.envoyproxy.io_envoyextensionpolicies.yaml

@@ -68,10 +68,10 @@ spec:
                       x-kubernetes-preserve-unknown-fields: true
                     filterName:
                       description: |-
-                        FilterName identifies a specific filter implementation within the dynamic
-                        module. A single shared library can contain multiple filter implementations.
-                        This value is passed to the module's HTTP filter config init function to
-                        select the appropriate implementation.
+                        FilterName identifies a specific HTTP filter implementation within the
+                        dynamic module. A single shared library can contain multiple filter
+                        implementations; this value is passed to the module's initialization
+                        function to select one.
                         If not specified, defaults to an empty string.
                       maxLength: 253
                       type: string
@@ -1076,19 +1076,9 @@ spec:
                               properties:
                                 config:
                                   description: |-
-                                    Config is optional configuration for the module's load balancer
-                                    implementation. This is serialized and passed to the module's
-                                    initialization function.
+                                    Config is the configuration for the dynamic module load balancer policy.
+                                    This is serialized as JSON and passed to the module's initialization function.
                                   x-kubernetes-preserve-unknown-fields: true
-                                lbPolicyName:
-                                  description: |-
-                                    LBPolicyName identifies a specific load balancer implementation within
-                                    the dynamic module. A single shared library can contain multiple LB
-                                    policy implementations. This value is passed to the module's
-                                    initialization function to select the appropriate implementation.
-                                  maxLength: 253
-                                  minLength: 1
-                                  type: string
                                 name:
                                   description: |-
                                     Name references a dynamic module registered in the EnvoyProxy resource's
@@ -1098,8 +1088,16 @@ spec:
                                   minLength: 1
                                   pattern: ^[a-z0-9]([a-z0-9.-]*[a-z0-9])?$
                                   type: string
+                                policyName:
+                                  description: |-
+                                    PolicyName identifies a specific load balancing policy implementation
+                                    within the dynamic module. A single shared library can contain multiple
+                                    policy implementations; this value is passed to the module's
+                                    initialization function to select one.
+                                    If not specified, defaults to an empty string.
+                                  maxLength: 253
+                                  type: string
                               required:
-                              - lbPolicyName
                               - name
                               type: object
                             endpointOverride: