Add API for GEP-3171 (#3283)

* Create index.md

* Create metadata.yaml

* Update index.md

* Update metadata.yaml

* Remove 'omitempty' from Fraction fields

* Split MirrorPercent into two fields: MirrorPercent and MirrorFraction.

* Update index.md

* Add config examples.

* Add Existing Support Table

* Update field names to avoid 'stuttering' in names.

* Update geps/gep-3171/index.md

Co-authored-by: Rob Scott <[email protected]>

* Add Fraction type

* Add percent and fraction to HTTPRequestMirrorFilter

* Update apis/v1/httproute_types.go

Co-authored-by: Rob Scott <[email protected]>

* Update apis/v1/shared_types.go

Co-authored-by: Rob Scott <[email protected]>

* Add CEL validation to Fraction type

* Add CEL validation to HttpRequestMirrorFilter

Also updated field descriptions to match the validation. Removed the default value for Percent.

* Add CEL validation test for HTTPRequestMirrorFilter

* Ran /hack/update-codegen.sh

* Update httproute_experimental_test.go

* Update httproute_experimental_test.go

* Update httproute_experimental_test.go

* Update httproute_types.go

* Reran /hack/update-codegen.sh

* Update httproute_experimental_test.go

* Make Denominator field a pointer to distinguish between 0 and unset

Co-authored-by: Rob Scott <[email protected]>

* Change Percent to be a pointer to distinguish between 0 and unset

Co-authored-by: Rob Scott <[email protected]>

* Update httproute_experimental_test.go

* Update httproute_experimental_test.go

* Format httproute_types.go

* Make Fraction a pointer

* Update httproute_experimental_test.go

* Reran hack/update-codegen.sh

* Updating to test CEL validation

* Updating to test CEL validation

* Update httproute_types.go

* Update httproute_experimental_test.go

* Update httproute_experimental_test.go

* Update httproute_experimental_test.go

* Update httproute_types.go

* Update httproute_experimental_test.go

* Update httproute_types.go

* Update httproute_types.go

* testing

* Update httproute_types.go

* Ran hack/update-codegen.sh

* format shared_types.go

* Update httproute_types.go

* Update httproute_experimental_test.go

* Update httproute_types.go

* Update httproute_types.go

* reran hack/update-codegen.sh

* Update httproute_types.go

* Update httproute_experimental_test.go

* Reran hack/update-codegen.sh

* Added RequestMirror validation to GRPCRoute

* Create grcproute_experimental_test.go

* Update grcproute_experimental_test.go

* Update grpcroute_types.go

* Update grcproute_experimental_test.go

* Ran hack/update-codegen.sh

* Update grcproute_experimental_test.go

* Update grcproute_experimental_test.go

* Update Copyright Year

* Update pkg/test/cel/grcproute_experimental_test.go

Co-authored-by: Rob Scott <[email protected]>

* Update httproute_experimental_test.go

* Update grcproute_experimental_test.go

---------

Co-authored-by: Rob Scott <[email protected]>

Author: jakebennert

apis/applyconfiguration/apis/v1/fraction.go

@@ -550,6 +550,8 @@ type GRPCRouteFilter struct {
 	// Support: Extended
 	//
 	// +optional
+	//
+	// <gateway:experimental:validation:XValidation:message="Only one of percent or fraction may be specified in HTTPRequestMirrorFilter",rule="!(has(self.percent) && has(self.fraction))">
 	RequestMirror *HTTPRequestMirrorFilter `json:"requestMirror,omitempty"`
 
 	// ExtensionRef is an optional, implementation-specific extension to the

apis/applyconfiguration/apis/v1/httprequestmirrorfilter.go

@@ -757,6 +757,8 @@ type HTTPRouteFilter struct {
 	// Support: Extended
 	//
 	// +optional
+	//
+	// <gateway:experimental:validation:XValidation:message="Only one of percent or fraction may be specified in HTTPRequestMirrorFilter",rule="!(has(self.percent) && has(self.fraction))">
 	RequestMirror *HTTPRequestMirrorFilter `json:"requestMirror,omitempty"`
 
 	// RequestRedirect defines a schema for a filter that responds to the
@@ -1153,6 +1155,29 @@ type HTTPRequestMirrorFilter struct {
 	//
 	// Support: Implementation-specific for any other resource
 	BackendRef BackendObjectReference `json:"backendRef"`
+
+	// Percent represents the percentage of requests that should be
+	// mirrored to BackendRef. Its minimum value is 0 (indicating 0% of
+	// requests) and its maximum value is 100 (indicating 100% of requests).
+	//
+	// Only one of Fraction or Percent may be specified. If neither field
+	// is specified, 100% of requests will be mirrored.
+	//
+	// +optional
+	// +kubebuilder:validation:Minimum=0
+	// +kubebuilder:validation:Maximum=100
+	// <gateway:experimental>
+	Percent *int32 `json:"percent,omitempty"`
+
+	// Fraction represents the fraction of requests that should be
+	// mirrored to BackendRef.
+	//
+	// Only one of Fraction or Percent may be specified. If neither field
+	// is specified, 100% of requests will be mirrored.
+	//
+	// +optional
+	// <gateway:experimental>
+	Fraction Fraction `json:"fraction,omitempty"`
 }
 
 // HTTPBackendRef defines how a HTTPRoute forwards a HTTP request.

apis/applyconfiguration/internal/internal.go

@@ -855,3 +855,14 @@ const (
 	// Support: Extended
 	PermanentCookieLifetimeType CookieLifetimeType = "Permanent"
 )
+
+// +kubebuilder:validation:XValidation:message="numerator must be less than or equal to denominator",rule="self.numerator <= self.denominator"
+type Fraction struct {
+	// +kubebuilder:validation:Minimum=0
+	Numerator int32 `json:"numerator"`
+
+	// +optional
+	// +kubebuilder:default=100
+	// +kubebuilder:validation:Minimum=1
+	Denominator *int32 `json:"denominator,omitempty"`
+}