⚠️ Add v1beta2 API for ExtensionConfig

.golangci.yml

@@ -156,7 +156,7 @@ linters:
         - pkg: sigs.k8s.io/cluster-api/exp/ipam/api/v1beta2
           alias: ipamv1
         # CAPI exp runtime
-        - pkg: sigs.k8s.io/cluster-api/exp/runtime/api/v1alpha1
+        - pkg: sigs.k8s.io/cluster-api/exp/runtime/api/v1beta2
           alias: runtimev1
         - pkg: sigs.k8s.io/cluster-api/exp/runtime/hooks/api/v1alpha1
           alias: runtimehooksv1

Makefile

@@ -494,6 +494,12 @@ generate-go-conversions-core-runtime: $(CONVERSION_GEN) ## Generate conversions
 		--go-header-file=./hack/boilerplate/boilerplate.generatego.txt \
 		./internal/runtime/test/v1alpha1 \
 		./internal/runtime/test/v1alpha2
+	$(MAKE) clean-generated-conversions SRC_DIRS="./$(EXP_DIR)/runtime/api/v1alpha1,./$(EXP_DIR)/runtime/api/v1beta2"
+	$(CONVERSION_GEN) \
+		--output-file=zz_generated.conversion.go \
+		--go-header-file=./hack/boilerplate/boilerplate.generatego.txt \
+		./$(EXP_DIR)/runtime/api/v1alpha1 \
+		./$(EXP_DIR)/runtime/api/v1beta2
 
 .PHONY: generate-go-conversions-kubeadm-bootstrap
 generate-go-conversions-kubeadm-bootstrap: $(CONVERSION_GEN) ## Generate conversions go code for kubeadm bootstrap

config/crd/kustomization.yaml

@@ -32,6 +32,7 @@ patches:
 - path: patches/webhook_in_clusterresourcesetbindings.yaml
 - path: patches/webhook_in_ipaddresses.yaml
 - path: patches/webhook_in_ipaddressclaims.yaml
+- path: patches/webhook_in_extensionconfigs.yaml
 # +kubebuilder:scaffold:crdkustomizewebhookpatch
 
 # the following config is for teaching kustomize how to do kustomization for CRDs.

config/crd/patches/webhook_in_extensionconfigs.yaml

@@ -0,0 +1,16 @@
+# The following patch enables conversion webhook for CRD
+# CRD conversion requires k8s 1.13 or later.
+apiVersion: apiextensions.k8s.io/v1
+kind: CustomResourceDefinition
+metadata:
+  name: extensionconfigs.runtime.cluster.x-k8s.io
+spec:
+  conversion:
+    strategy: Webhook
+    webhook:
+      conversionReviewVersions: ["v1", "v1beta1"]
+      clientConfig:
+        service:
+          namespace: system
+          name: webhook-service
+          path: /convert

config/default/kustomization.yaml

@@ -57,8 +57,6 @@ replacements:
       delimiter: /
     select:
       kind: CustomResourceDefinition
-    reject:
-    - name: extensionconfigs.runtime.cluster.x-k8s.io
 - source:
     fieldPath: .metadata.name
     group: cert-manager.io
@@ -90,8 +88,6 @@ replacements:
       index: 1
     select:
       kind: CustomResourceDefinition
-    reject:
-    - name: extensionconfigs.runtime.cluster.x-k8s.io
 - source:
     fieldPath: .metadata.name
     kind: Service

config/webhook/manifests.yaml

@@ -165,15 +165,15 @@ webhooks:
     service:
       name: webhook-service
       namespace: system
-      path: /mutate-runtime-cluster-x-k8s-io-v1alpha1-extensionconfig
+      path: /mutate-runtime-cluster-x-k8s-io-v1beta2-extensionconfig
   failurePolicy: Fail
   matchPolicy: Equivalent
   name: default.extensionconfig.runtime.addons.cluster.x-k8s.io
   rules:
   - apiGroups:
     - runtime.cluster.x-k8s.io
     apiVersions:
-    - v1alpha1
+    - v1beta2
     operations:
     - CREATE
     - UPDATE
@@ -415,15 +415,15 @@ webhooks:
     service:
       name: webhook-service
       namespace: system
-      path: /validate-runtime-cluster-x-k8s-io-v1alpha1-extensionconfig
+      path: /validate-runtime-cluster-x-k8s-io-v1beta2-extensionconfig
   failurePolicy: Fail
   matchPolicy: Equivalent
   name: validation.extensionconfig.runtime.cluster.x-k8s.io
   rules:
   - apiGroups:
     - runtime.cluster.x-k8s.io
     apiVersions:
-    - v1alpha1
+    - v1beta2
     operations:
     - CREATE
     - UPDATE

exp/runtime/api/v1alpha1/conversion.go

@@ -0,0 +1,104 @@
+/*
+Copyright 2025 The Kubernetes Authors.
+
+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 v1alpha1
+
+import (
+	metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
+	apimachineryconversion "k8s.io/apimachinery/pkg/conversion"
+	"sigs.k8s.io/controller-runtime/pkg/conversion"
+
+	clusterv1 "sigs.k8s.io/cluster-api/api/v1beta2"
+	runtimev1 "sigs.k8s.io/cluster-api/exp/runtime/api/v1beta2"
+)
+
+func (src *ExtensionConfig) ConvertTo(dstRaw conversion.Hub) error {
+	dst := dstRaw.(*runtimev1.ExtensionConfig)
+
+	return Convert_v1alpha1_ExtensionConfig_To_v1beta2_ExtensionConfig(src, dst, nil)
+}
+
+func (dst *ExtensionConfig) ConvertFrom(srcRaw conversion.Hub) error {
+	src := srcRaw.(*runtimev1.ExtensionConfig)
+
+	return Convert_v1beta2_ExtensionConfig_To_v1alpha1_ExtensionConfig(src, dst, nil)
+}
+
+func Convert_v1beta2_ExtensionConfigStatus_To_v1alpha1_ExtensionConfigStatus(in *runtimev1.ExtensionConfigStatus, out *ExtensionConfigStatus, s apimachineryconversion.Scope) error {
+	if err := autoConvert_v1beta2_ExtensionConfigStatus_To_v1alpha1_ExtensionConfigStatus(in, out, s); err != nil {
+		return err
+	}
+
+	// Reset conditions from autogenerated conversions
+	// NOTE: v1beta2 conditions should not be automatically be converted into legacy conditions (v1beta1).
+	out.Conditions = nil
+
+	// Retrieve legacy conditions (v1beta1) from the deprecated field.
+	if in.Deprecated != nil && in.Deprecated.V1Beta1 != nil {
+		if in.Deprecated.V1Beta1.Conditions != nil {
+			out.Conditions = in.Deprecated.V1Beta1.Conditions
+		}
+	}
+
+	// Move new conditions (v1beta2) to the v1beta2 field.
+	if in.Conditions == nil {
+		return nil
+	}
+	out.V1Beta2 = &ExtensionConfigV1Beta2Status{}
+	out.V1Beta2.Conditions = in.Conditions
+	return nil
+}
+
+func Convert_v1alpha1_ExtensionConfigStatus_To_v1beta2_ExtensionConfigStatus(in *ExtensionConfigStatus, out *runtimev1.ExtensionConfigStatus, s apimachineryconversion.Scope) error {
+	if err := autoConvert_v1alpha1_ExtensionConfigStatus_To_v1beta2_ExtensionConfigStatus(in, out, s); err != nil {
+		return err
+	}
+
+	// Reset conditions from autogenerated conversions
+	// NOTE: v1beta1 conditions should not be automatically be converted into v1beta2 conditions.
+	out.Conditions = nil
+
+	// Retrieve new conditions (v1beta2) from the v1beta2 field.
+	if in.V1Beta2 != nil {
+		out.Conditions = in.V1Beta2.Conditions
+	}
+
+	// Move legacy conditions (v1beta1) to the deprecated field.
+	if in.Conditions == nil {
+		return nil
+	}
+
+	if out.Deprecated == nil {
+		out.Deprecated = &runtimev1.ExtensionConfigDeprecatedStatus{}
+	}
+	if out.Deprecated.V1Beta1 == nil {
+		out.Deprecated.V1Beta1 = &runtimev1.ExtensionConfigV1Beta1DeprecatedStatus{}
+	}
+	if in.Conditions != nil {
+		out.Deprecated.V1Beta1.Conditions = in.Conditions
+	}
+	return nil
+}
+
+func Convert_v1_Condition_To_v1beta2_Condition(_ *metav1.Condition, _ *clusterv1.Condition, _ apimachineryconversion.Scope) error {
+	// NOTE: v1beta2 conditions should not be automatically converted into legacy (v1beta2) conditions.
+	return nil
+}
+
+func Convert_v1beta2_Condition_To_v1_Condition(_ *clusterv1.Condition, _ *metav1.Condition, _ apimachineryconversion.Scope) error {
+	// NOTE: legacy (v1beta2) conditions should not be automatically converted into v1beta2 conditions.
+	return nil
+}

exp/runtime/api/v1alpha1/conversion_test.go

@@ -0,0 +1,68 @@
+//go:build !race
+
+/*
+Copyright 2025 The Kubernetes Authors.
+
+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 v1alpha1
+
+import (
+	"reflect"
+	"testing"
+
+	fuzz "github.com/google/gofuzz"
+	"k8s.io/apimachinery/pkg/api/apitesting/fuzzer"
+	runtimeserializer "k8s.io/apimachinery/pkg/runtime/serializer"
+
+	runtimev1 "sigs.k8s.io/cluster-api/exp/runtime/api/v1beta2"
+	utilconversion "sigs.k8s.io/cluster-api/util/conversion"
+)
+
+// Test is disabled when the race detector is enabled (via "//go:build !race" above) because otherwise the fuzz tests would just time out.
+
+func TestFuzzyConversion(t *testing.T) {
+	t.Run("for ExtensionConfig", utilconversion.FuzzTestFunc(utilconversion.FuzzTestFuncInput{
+		Hub:         &runtimev1.ExtensionConfig{},
+		Spoke:       &ExtensionConfig{},
+		FuzzerFuncs: []fuzzer.FuzzerFuncs{ExtensionConfigFuzzFuncs},
+	}))
+}
+
+func ExtensionConfigFuzzFuncs(_ runtimeserializer.CodecFactory) []interface{} {
+	return []interface{}{
+		hubExtensionConfigStatus,
+		spokeExtensionConfigStatus,
+	}
+}
+
+func hubExtensionConfigStatus(in *runtimev1.ExtensionConfigStatus, c fuzz.Continue) {
+	c.FuzzNoCustom(in)
+	// Drop empty structs with only omit empty fields.
+	if in.Deprecated != nil {
+		if in.Deprecated.V1Beta1 == nil || reflect.DeepEqual(in.Deprecated.V1Beta1, &runtimev1.ExtensionConfigV1Beta1DeprecatedStatus{}) {
+			in.Deprecated = nil
+		}
+	}
+}
+
+func spokeExtensionConfigStatus(in *ExtensionConfigStatus, c fuzz.Continue) {
+	c.FuzzNoCustom(in)
+	// Drop empty structs with only omit empty fields.
+	if in.V1Beta2 != nil {
+		if reflect.DeepEqual(in.V1Beta2, &ExtensionConfigV1Beta2Status{}) {
+			in.V1Beta2 = nil
+		}
+	}
+}

exp/runtime/api/v1alpha1/doc.go

@@ -15,4 +15,5 @@ limitations under the License.
 */
 
 // Package v1alpha1 contains the v1alpha1 implementation of ExtensionConfig.
+// +k8s:conversion-gen=sigs.k8s.io/cluster-api/exp/runtime/api/v1beta2
 package v1alpha1

exp/runtime/api/v1alpha1/extensionconfig_types.go

@@ -203,7 +203,6 @@ const (
 // +kubebuilder:object:root=true
 // +kubebuilder:resource:path=extensionconfigs,shortName=ext,scope=Cluster,categories=cluster-api
 // +kubebuilder:subresource:status
-// +kubebuilder:storageversion
 // +kubebuilder:printcolumn:name="Age",type="date",JSONPath=".metadata.creationTimestamp",description="Time duration since creation of ExtensionConfig"
 
 // ExtensionConfig is the Schema for the ExtensionConfig API.

exp/runtime/api/v1alpha1/groupversion_info.go

@@ -35,6 +35,9 @@ var (
 	// AddToScheme adds the types in this group-version to the given scheme.
 	AddToScheme = schemeBuilder.AddToScheme
 
+	// localSchemeBuilder is used for type conversions.
+	localSchemeBuilder = schemeBuilder
+
 	objectTypes = []runtime.Object{}
 )