Use fooRef naming convention for object references

Rename fields that are object references in order to follow the community
API conventions.

* api/v1alpha1/gateway_types.go (Listener): Rename "extension" field to
"extensionRef".
(ListenerTLS): Rename "certificates" field to "certificateRefs".
* api/v1alpha1/gatewayclass_types.go (GatewayClassSpec): Rename
"parameters" field to "parametersRef".
* api/v1alpha1/httproute_types.go (HTTPRouteHost, HTTPRouteMatch)
(HTTPRouteFilter, HTTPRouteAction): Rename "extension" fields to
"extensionRef".
(HTTPRouteAction): Rename "forwardTo" field to "forwardTargetRef".
(HTTPRouteStatus): Rename "gateways" field to "gatewayRefs".
* api/v1alpha1/generated.pb.go:
* api/v1alpha1/generated.proto:
* api/v1alpha1/zz_generated.deepcopy.go:
* config/crd/bases/networking.x-k8s.io_gatewayclasses.yaml:
* config/crd/bases/networking.x-k8s.io_gateways.yaml:
* config/crd/bases/networking.x-k8s.io_httproutes.yaml: Regenerate.

Author: Miciah

api/v1alpha1/gateway_types.go

@@ -115,16 +115,16 @@ type Listener struct {
 	//
 	// +optional
 	TLS *ListenerTLS `json:"tls,omitempty" protobuf:"bytes,5,opt,name=tls"`
-	// Extension for this Listener.  The resource may be "configmaps" or an
-	// implementation-defined resource (for example, resource "mylisteners"
-	// in group "networking.acme.io").  Omitting or specifying the empty
-	// string for both the resource and group indicates that the resource is
-	// "configmaps".  If the referent cannot be found, the listener's
-	// "InvalidListener" status condition will be true.
+	// ExtensionRef for this Listener.  The resource may be "configmaps" or
+	// an implementation-defined resource (for example, resource
+	// "mylisteners" in group "networking.acme.io").  Omitting or specifying
+	// the empty string for both the resource and group indicates that the
+	// resource is "configmaps".  If the referent cannot be found, the
+	// listener's "InvalidListener" status condition will be true.
 	//
 	// Support: custom.
 	// +optional
-	Extension *ListenerExtensionObjectReference `json:"extension,omitempty" protobuf:"bytes,6,opt,name=extension"`
+	ExtensionRef *ListenerExtensionObjectReference `json:"extensionRef,omitempty" protobuf:"bytes,6,opt,name=extensionRef"`
 }
 
 // AddressType defines how a network address is represented as a text string.
@@ -180,7 +180,7 @@ const (
 // - aws: https://docs.aws.amazon.com/elasticloadbalancing/latest/application/create-https-listener.html#describe-ssl-policies
 // - azure: https://docs.microsoft.com/en-us/azure/app-service/configure-ssl-bindings#enforce-tls-1112
 type ListenerTLS struct {
-	// Certificates is a list of references to Kubernetes objects that each
+	// CertificateRefs is a list of references to Kubernetes objects that each
 	// contain an identity certificate that is bound to the listener.  The
 	// host name in a TLS SNI client hello message is used for certificate
 	// matching and route host name selection.  The SNI server_name must
@@ -196,7 +196,7 @@ type ListenerTLS struct {
 	// Support: Implementation-specific (Other resource types)
 	//
 	// +required
-	Certificates []CertificateObjectReference `json:"certificates,omitempty" protobuf:"bytes,1,rep,name=certificates"`
+	CertificateRefs []CertificateObjectReference `json:"certificateRefs,omitempty" protobuf:"bytes,1,rep,name=certificateRefs"`
 	// MinimumVersion of TLS allowed. It is recommended to use one of
 	// the TLS_* constants above. Note: this is not strongly
 	// typed to allow implementation-specific versions to be used without

api/v1alpha1/gatewayclass_types.go

@@ -110,7 +110,7 @@ type GatewayClassSpec struct {
 	//
 	// +optional
 	// +protobuf=false
-	ParametersRef *GatewayClassParametersObjectReference `json:"parameters,omitempty" protobuf:"bytes,4,opt,name=parametersRef"`
+	ParametersRef *GatewayClassParametersObjectReference `json:"parametersRef,omitempty" protobuf:"bytes,4,opt,name=parametersRef"`
 }
 
 // GatewayClassParametersObjectReference identifies a parameters object for a

api/v1alpha1/generated.pb.go

@@ -55,7 +55,7 @@ type HTTPRouteHost struct {
 	// Rules are a list of HTTP matchers, filters and actions.
 	Rules []HTTPRouteRule `json:"rules" protobuf:"bytes,2,rep,name=rules"`
 
-	// Extension is an optional, implementation-specific extension to the
+	// ExtensionRef is an optional, implementation-specific extension to the
 	// "host" block.  The resource may be "configmaps" (omit or specify the
 	// empty string for the group) or an implementation-defined resource
 	// (for example, resource "myroutehosts" in group "networking.acme.io").
@@ -67,7 +67,7 @@ type HTTPRouteHost struct {
 	// Support: custom
 	//
 	// +optional
-	Extension *RouteHostExtensionObjectReference `json:"extension" protobuf:"bytes,3,opt,name=extension"`
+	ExtensionRef *RouteHostExtensionObjectReference `json:"extensionRef" protobuf:"bytes,3,opt,name=extensionRef"`
 }
 
 // HTTPRouteRule is the configuration for a given path.
@@ -125,7 +125,7 @@ type HTTPRouteMatch struct {
 	// +optional
 	Header map[string]string `json:"header" protobuf:"bytes,4,rep,name=header"`
 
-	// Extension is an optional, implementation-specific extension to the
+	// ExtensionRef is an optional, implementation-specific extension to the
 	// "match" behavior.  The resource may be "configmap" (use the empty
 	// string for the group) or an implementation-defined resource (for
 	// example, resource "myroutematchers" in group "networking.acme.io").
@@ -137,7 +137,7 @@ type HTTPRouteMatch struct {
 	// Support: custom
 	//
 	// +optional
-	Extension *RouteMatchExtensionObjectReference `json:"extension" protobuf:"bytes,5,opt,name=extension"`
+	ExtensionRef *RouteMatchExtensionObjectReference `json:"extensionRef" protobuf:"bytes,5,opt,name=extensionRef"`
 }
 
 // RouteMatchExtensionObjectReference identifies a route-match extension object
@@ -155,7 +155,7 @@ type HTTPRouteFilter struct {
 	// +optional
 	Headers *HTTPHeaderFilter `json:"headers" protobuf:"bytes,1,opt,name=headers"`
 
-	// Extension is an optional, implementation-specific extension to the
+	// ExtensionRef is an optional, implementation-specific extension to the
 	// "filter" behavior.  The resource may be "configmap" (use the empty
 	// string for the group) or an implementation-defined resource (for
 	// example, resource "myroutefilters" in group "networking.acme.io").
@@ -167,7 +167,7 @@ type HTTPRouteFilter struct {
 	// Support: custom
 	//
 	// +optional
-	Extension *RouteFilterExtensionObjectReference `json:"extension" protobuf:"bytes,2,opt,name=extension"`
+	ExtensionRef *RouteFilterExtensionObjectReference `json:"extensionRef" protobuf:"bytes,2,opt,name=extensionRef"`
 }
 
 // RouteFilterExtensionObjectReference identifies a route-filter extension
@@ -220,17 +220,17 @@ type HTTPHeaderFilter struct {
 
 // HTTPRouteAction is the action taken given a match.
 type HTTPRouteAction struct {
-	// ForwardTo sends requests to the referenced object.  The resource may
-	// be "services" (omit or use the empty string for the group), or an
-	// implementation may support other resources (for example, resource
-	// "myroutetargets" in group "networking.acme.io").  Omitting or
-	// specifying the empty string for both the resource and group indicates
-	// that the resource is "services".  If the referent cannot be found,
-	// the "InvalidRoutes" status condition on any Gateway that includes the
-	// HTTPRoute will be true.
-	ForwardTo *RouteActionTargetObjectReference `json:"forwardTo" protobuf:"bytes,1,opt,name=forwardTo"`
-
-	// Extension is an optional, implementation-specific extension to the
+	// ForwardTargetRef sends requests to the referenced object.  The
+	// resource may be "services" (omit or use the empty string for the
+	// group), or an implementation may support other resources (for
+	// example, resource "myroutetargets" in group "networking.acme.io").
+	// Omitting or specifying the empty string for both the resource and
+	// group indicates that the resource is "services".  If the referent
+	// cannot be found, the "InvalidRoutes" status condition on any Gateway
+	// that includes the HTTPRoute will be true.
+	ForwardTargetRef *RouteActionTargetObjectReference `json:"forwardTargetRef" protobuf:"bytes,1,opt,name=forwardTargetRef"`
+
+	// ExtensionRef is an optional, implementation-specific extension to the
 	// "action" behavior.  The resource may be "configmaps" (use the empty
 	// string for the group) or an implementation-defined resource (for
 	// example, resource "myrouteactions" in group "networking.acme.io").
@@ -242,7 +242,7 @@ type HTTPRouteAction struct {
 	// Support: custom
 	//
 	// +optional
-	Extension *RouteActionExtensionObjectReference `json:"extension" protobuf:"bytes,2,opt,name=extension"`
+	ExtensionRef *RouteActionExtensionObjectReference `json:"extensionRef" protobuf:"bytes,2,opt,name=extensionRef"`
 }
 
 // RouteActionTargetObjectReference identifies a target object for a route
@@ -265,7 +265,7 @@ type RouteHostExtensionObjectReference = LocalObjectReference
 
 // HTTPRouteStatus defines the observed state of HTTPRoute.
 type HTTPRouteStatus struct {
-	Gateways []GatewayObjectReference `json:"gateways" protobuf:"bytes,1,rep,name=gateways"`
+	GatewayRefs []GatewayObjectReference `json:"gatewayRefs" protobuf:"bytes,1,rep,name=gatewayRefs"`
 }
 
 // GatewayObjectReference identifies a Gateway object.

api/v1alpha1/generated.proto

@@ -146,7 +146,7 @@ spec:
                 names (https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names).
                 \n Support: Core"
               type: string
-            parameters:
+            parametersRef:
               description: "ParametersRef is a controller specific resource containing
                 the configuration parameters corresponding to this class. This is
                 optional if the controller does not require any additional configuration.