Local namespace and merging

Author: howardjohn

apis/v1/gateway_types.go

@@ -661,10 +661,30 @@ type GatewayInfrastructure struct {
 	//
 	// This follows the same semantics as GatewayClass's `parametersRef`, but on a per-Gateway basis
 	//
+	// The Gateway's GatewayClass may provide its own `parametersRef`. When both are specified,
+	// the merging behavior is implementation specific.
+	// It is generally recommended that GatewayClass provides defaults that can be overridden by a Gateway.
+	//
 	// Support: Implementation-specific
 	//
 	// +optional
-	ParametersRef *ParametersReference `json:"parametersRef,omitempty"`
+	ParametersRef *LocalParametersReference `json:"parametersRef,omitempty"`
+}
+
+// LocalParametersReference identifies an API object containing controller-specific
+// configuration resource within the namespace.
+type LocalParametersReference struct {
+	// Group is the group of the referent.
+	Group Group `json:"group"`
+
+	// Kind is kind of the referent.
+	Kind Kind `json:"kind"`
+
+	// Name is the name of the referent.
+	//
+	// +kubebuilder:validation:MinLength=1
+	// +kubebuilder:validation:MaxLength=253
+	Name string `json:"name"`
 }
 
 // GatewayConditionType is a type of condition associated with a

apis/v1/gatewayclass_types.go

@@ -95,6 +95,10 @@ type GatewayClassSpec struct {
 	// If the referent cannot be found, the GatewayClass's "InvalidParameters"
 	// status condition will be true.
 	//
+	// A Gateway for this GatewayClass may provide its own `parametersRef`. When both are specified,
+	// the merging behavior is implementation specific.
+	// It is generally recommended that GatewayClass provides defaults that can be overridden by a Gateway.
+	//
 	// Support: Implementation-specific
 	//
 	// +optional