chore: add v2alpha1 group and add ControlPlane type

Makefile

@@ -176,6 +176,7 @@ generate.clientsets: client-gen
 		--input incubator/v1alpha1 \
 		--input gateway-operator/v1alpha1 \
 		--input gateway-operator/v1beta1 \
+		--input gateway-operator/v2alpha1 \
 		--output-dir pkg/ \
 		--output-pkg $(REPO_URL)/pkg/
 

api/gateway-operator/v1beta1/controlplane_types.go

@@ -31,6 +31,7 @@ func init() {
 // ControlPlane is the Schema for the controlplanes API
 //
 // +genclient
+// +kubebuilder:storageversion
 // +k8s:deepcopy-gen:interfaces=k8s.io/apimachinery/pkg/runtime.Object
 // +kubebuilder:object:root=true
 // +kubebuilder:subresource:status

api/gateway-operator/v2alpha1/controlplane_types.go

@@ -0,0 +1,264 @@
+/*
+Copyright 2025 Kong Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+package v2alpha1
+
+import (
+	metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
+	gatewayv1 "sigs.k8s.io/gateway-api/apis/v1"
+
+	commonv1alpha1 "github.com/kong/kubernetes-configuration/api/common/v1alpha1"
+	operatorv1beta1 "github.com/kong/kubernetes-configuration/api/gateway-operator/v1beta1"
+)
+
+func init() {
+	SchemeBuilder.Register(&ControlPlane{}, &ControlPlaneList{})
+}
+
+// ControlPlane is the Schema for the controlplanes API
+//
+// +genclient
+// +k8s:deepcopy-gen:interfaces=k8s.io/apimachinery/pkg/runtime.Object
+// +kubebuilder:object:root=true
+// +kubebuilder:subresource:status
+// +kubebuilder:resource:shortName=kocp,categories=kong;all
+// +kubebuilder:printcolumn:name="Ready",description="The Resource is ready",type=string,JSONPath=`.status.conditions[?(@.type=='Ready')].status`
+// +apireference:kgo:include
+// +kong:channels=gateway-operator
+type ControlPlane struct {
+	metav1.TypeMeta   `json:",inline"`
+	metav1.ObjectMeta `json:"metadata,omitempty"`
+
+	Spec   ControlPlaneSpec   `json:"spec,omitempty"`
+	Status ControlPlaneStatus `json:"status,omitempty"`
+}
+
+// ControlPlaneList contains a list of ControlPlane
+//
+// +kubebuilder:object:root=true
+// +apireference:kgo:include
+type ControlPlaneList struct {
+	metav1.TypeMeta `json:",inline"`
+	metav1.ListMeta `json:"metadata,omitempty"`
+	Items           []ControlPlane `json:"items"`
+}
+
+// ControlPlaneSpec defines the desired state of ControlPlane
+//
+// +apireference:kgo:include
+type ControlPlaneSpec struct {
+	ControlPlaneOptions `json:",inline"`
+
+	// GatewayClass indicates the Gateway resources which this ControlPlane
+	// should be responsible for configuring routes for (e.g. HTTPRoute,
+	// TCPRoute, UDPRoute, TLSRoute, etc.).
+	//
+	// Required for the ControlPlane to have any effect: at least one Gateway
+	// must be present for configuration to be pushed to the data-plane and
+	// only Gateway resources can be used to identify data-plane entities.
+	//
+	// +optional
+	GatewayClass *gatewayv1.ObjectName `json:"gatewayClass,omitempty"`
+
+	// IngressClass enables support for the older Ingress resource and indicates
+	// which Ingress resources this ControlPlane should be responsible for.
+	//
+	// Routing configured this way will be applied to the Gateway resources
+	// indicated by GatewayClass.
+	//
+	// If omitted, Ingress resources will not be supported by the ControlPlane.
+	//
+	// +optional
+	IngressClass *string `json:"ingressClass,omitempty"`
+}
+
+// ControlPlaneOptions indicates the specific information needed to
+// deploy and connect a ControlPlane to a DataPlane object.
+//
+// +apireference:kgo:include
+// +kubebuilder:validation:XValidation:message="Extension not allowed for ControlPlane",rule="has(self.extensions) ? self.extensions.all(e, (e.group == 'konnect.konghq.com' && e.kind == 'KonnectExtension') || (e.group == 'gateway-operator.konghq.com' && e.kind == 'DataPlaneMetricsExtension')) : true"
+type ControlPlaneOptions struct {
+	// DataPlane designates the target data plane to configure.
+	//
+	// It can be either a URL to an externally managed DataPlane (e.g. installed
+	// independently with Helm) or a name of a DataPlane resource that is
+	// managed by the operator.
+	//
+	// +required
+	DataPlane ControlPlaneDataPlaneTarget `json:"dataplane,omitempty"`
+
+	// Extensions provide additional or replacement features for the ControlPlane
+	// resources to influence or enhance functionality.
+	//
+	// +optional
+	// +kubebuilder:validation:MaxItems=2
+	Extensions []commonv1alpha1.ExtensionRef `json:"extensions,omitempty"`
+
+	// WatchNamespaces indicates the namespaces to watch for resources.
+	//
+	// +optional
+	// +kubebuilder:default={type: all}
+	WatchNamespaces *operatorv1beta1.WatchNamespaces `json:"watchNamespaces,omitempty"`
+
+	// FeatureGates is a list of feature gates that are enabled for this ControlPlane.
+	//
+	// +optional
+	// +listType=map
+	// +listMapKey=name
+	// +kubebuilder:validation:MaxItems=32
+	FeatureGates []ControlPlaneFeatureGate `json:"featureGates,omitempty"`
+
+	// Controllers defines the controllers that are enabled for this ControlPlane.
+	//
+	// +optional
+	// +listType=map
+	// +listMapKey=name
+	// +kubebuilder:validation:MaxItems=32
+	Controllers []ControlPlaneController `json:"controllers,omitempty"`
+
+	// AdminAPI defines the configuration for the Kong Admin API.
+	//
+	// +optional
+	AdminAPI *ControlPlaneAdminAPI `json:"adminAPI,omitempty"`
+}
+
+// ControlPlaneDataPlaneTarget defines the target for the DataPlane that the ControlPlane
+// is responsible for configuring.
+//
+// +kubebuilder:validation:XValidation:message="URL has to be provided when type is set to url",rule="self.type != 'url' || has(self.url)"
+// +kubebuilder:validation:XValidation:message="Name cannot be provided when type is set to url",rule="self.type != 'url' || !has(self.name)"
+// +kubebuilder:validation:XValidation:message="Name has to be provided when type is set to name",rule="self.type != 'name' || has(self.name)"
+// +kubebuilder:validation:XValidation:message="URL cannot be provided when type is set to name",rule="self.type != 'name' || !has(self.url)"
+type ControlPlaneDataPlaneTarget struct {
+	// Type indicates the type of the DataPlane target.
+	//
+	// +kubebuilder:validation:Enum=url;name
+	// +kubebuilder:validation:Required
+	Type ControlPlaneDataPlaneTargetType `json:"type,omitempty"`
+
+	// URL is the URL of the DataPlane target. This is used for configuring
+	// externally managed DataPlanes like those installed independently with Helm.
+	//
+	// +optional
+	// +kubebuilder:validation:XValidation:message="URL has to be a valid URL",rule="isURL(self)"
+	URL *string `json:"url,omitempty"`
+
+	// Name is the name of the DataPlane to configure.
+	//
+	// +optional
+	Name *string `json:"name,omitempty"`
+}
+
+// ControlPlaneDataPlaneTargetType defines the type of the DataPlane target
+// that the ControlPlane is responsible for configuring.
+type ControlPlaneDataPlaneTargetType string
+
+const (
+	// ControlPlaneDataPlaneTargetURL indicates that the DataPlane target is a URL.
+	ControlPlaneDataPlaneTargetURL ControlPlaneDataPlaneTargetType = "url"
+
+	// ControlPlaneDataPlaneTargetName indicates that the DataPlane target is a name
+	// of a DataPlane resource managed by the operator.
+	ControlPlaneDataPlaneTargetName ControlPlaneDataPlaneTargetType = "name"
+)
+
+// ControlPlaneAdminAPI defines the configuration for the DataPlane Kong Admin API.
+type ControlPlaneAdminAPI struct {
+	// Workspace indicates the Kong Workspace to use for the ControlPlane.
+	// If left empty then no Kong workspace will be used.
+	//
+	// +optional
+	Workspace string `json:"workspace,omitempty"`
+}
+
+// ControlPlaneController defines a controller state for the ControlPlane.
+// It overrides the default behavior as defined in the deployed operator version.
+//
+// +apireference:kgo:include
+type ControlPlaneController struct {
+	// Name is the name of the controller.
+	//
+	// +kubebuilder:validation:Required
+	// +kubebuilder:validation:MinLength=1
+	Name string `json:"name,omitempty"`
+
+	// Enabled indicates whether the controller is enabled or not.
+	//
+	// +kubebuilder:validation:Required
+	Enabled *bool `json:"enabled"`
+}
+
+// ControlPlaneFeatureGate defines a feature gate state for the ControlPlane.
+// It overrides the default behavior as defined in the deployed operator version.
+//
+// +apireference:kgo:include
+type ControlPlaneFeatureGate struct {
+	// Name is the name of the feature gate.
+	//
+	// +kubebuilder:validation:Required
+	// +kubebuilder:validation:MinLength=1
+	Name string `json:"name,omitempty"`
+
+	// Enabled indicates whether the feature gate is enabled or not.
+	//
+	// +kubebuilder:validation:Required
+	Enabled *bool `json:"enabled"`
+}
+
+// ControlPlaneStatus defines the observed state of ControlPlane
+//
+// +apireference:kgo:include
+type ControlPlaneStatus struct {
+	// Conditions describe the current conditions of the Gateway.
+	//
+	// +optional
+	// +listType=map
+	// +listMapKey=type
+	// +kubebuilder:validation:MaxItems=8
+	// +kubebuilder:default={{type: "Scheduled", status: "Unknown", reason:"NotReconciled", message:"Waiting for controller", lastTransitionTime: "1970-01-01T00:00:00Z"}}
+	Conditions []metav1.Condition `json:"conditions,omitempty"`
+
+	// FeatureGates is a list of effective feature gates for this ControlPlane.
+	//
+	// +optional
+	// +listType=map
+	// +listMapKey=name
+	// +kubebuilder:validation:MaxItems=32
+	FeatureGates []ControlPlaneFeatureGate `json:"featureGates,omitempty"`
+
+	// Controllers is a list of enabled and disabled controllers for this ControlPlane.
+	//
+	// +optional
+	// +listType=map
+	// +listMapKey=name
+	// +kubebuilder:validation:MaxItems=32
+	Controllers []ControlPlaneController `json:"controllers,omitempty"`
+}
+
+// GetConditions returns the ControlPlane Status Conditions
+func (c *ControlPlane) GetConditions() []metav1.Condition {
+	return c.Status.Conditions
+}
+
+// SetConditions sets the ControlPlane Status Conditions
+func (c *ControlPlane) SetConditions(conditions []metav1.Condition) {
+	c.Status.Conditions = conditions
+}
+
+// GetExtensions retrieves the ControlPlane Extensions
+func (c *ControlPlane) GetExtensions() []commonv1alpha1.ExtensionRef {
+	return c.Spec.Extensions
+}

api/gateway-operator/v2alpha1/doc.go

@@ -0,0 +1,21 @@
+/*
+Copyright 2025 Kong, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+// Package v2alpha1 contains API Schema definitions for the gateway-operator.konghq.com v2alpha1 API group.
+// +kubebuilder:object:generate=true
+// +groupName=gateway-operator.konghq.com
+// +groupGoName=GatewayOperator
+package v2alpha1

api/gateway-operator/v2alpha1/groupversion_info.go

@@ -0,0 +1,36 @@
+/*
+Copyright 2025 Kong Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+// Package v2alpha1 contains API Schema definitions for the gateway-operator.konghq.com v2alpha1 API group
+// +kubebuilder:object:generate=true
+// +groupName=gateway-operator.konghq.com
+package v2alpha1
+
+import (
+	"k8s.io/apimachinery/pkg/runtime/schema"
+	"sigs.k8s.io/controller-runtime/pkg/scheme"
+)
+
+var (
+	// SchemeGroupVersion is group version used to register these objects
+	SchemeGroupVersion = schema.GroupVersion{Group: "gateway-operator.konghq.com", Version: "v2alpha1"}
+
+	// SchemeBuilder is used to add go types to the GroupVersionKind scheme
+	SchemeBuilder = &scheme.Builder{GroupVersion: SchemeGroupVersion}
+
+	// AddToScheme adds the types in this group-version to the given scheme.
+	AddToScheme = SchemeBuilder.AddToScheme
+)

api/gateway-operator/v2alpha1/gvrs.go

@@ -0,0 +1,12 @@
+package v2alpha1
+
+import "k8s.io/apimachinery/pkg/runtime/schema"
+
+// ControlPlaneGVR returns current package ControlPlane GVR.
+func ControlPlaneGVR() schema.GroupVersionResource {
+	return schema.GroupVersionResource{
+		Group:    SchemeGroupVersion.Group,
+		Version:  SchemeGroupVersion.Version,
+		Resource: "controlplanes",
+	}
+}