✨ Add .spec.upgrade.external.generateUpgradePlanExtension field to ClusterClass

api/core/v1beta1/conversion.go

@@ -250,6 +250,8 @@ func (src *ClusterClass) ConvertTo(dstRaw conversion.Hub) error {
 
 	dst.Spec.KubernetesVersions = restored.Spec.KubernetesVersions
 
+	dst.Spec.Upgrade.External.GenerateUpgradePlanExtension = restored.Spec.Upgrade.External.GenerateUpgradePlanExtension
+
 	return nil
 }
 

api/core/v1beta2/clusterclass_types.go

@@ -136,6 +136,10 @@ type ClusterClassSpec struct {
 	// +kubebuilder:validation:MaxItems=1000
 	Patches []ClusterClassPatch `json:"patches,omitempty"`
 
+	// upgrade defines the upgrade configuration for clusters using this ClusterClass.
+	// +optional
+	Upgrade ClusterClassUpgrade `json:"upgrade,omitempty,omitzero"`
+
 	// kubernetesVersions is the list of Kubernetes versions that can be
 	// used for clusters using this ClusterClass.
 	// The list of version must be ordered from the older to the newer version, and there should be
@@ -1252,6 +1256,24 @@ type ClusterClassPatch struct {
 	External *ExternalPatchDefinition `json:"external,omitempty"`
 }
 
+// ClusterClassUpgrade defines the upgrade configuration for clusters using the ClusterClass.
+// +kubebuilder:validation:MinProperties=1
+type ClusterClassUpgrade struct {
+	// external defines external runtime extensions for upgrade operations.
+	// +optional
+	External ClusterClassUpgradeExternal `json:"external,omitempty,omitzero"`
+}
+
+// ClusterClassUpgradeExternal defines external runtime extensions for upgrade operations.
+// +kubebuilder:validation:MinProperties=1
+type ClusterClassUpgradeExternal struct {
+	// generateUpgradePlanExtension references an extension which is called to generate upgrade plan.
+	// +optional
+	// +kubebuilder:validation:MinLength=1
+	// +kubebuilder:validation:MaxLength=512
+	GenerateUpgradePlanExtension string `json:"generateUpgradePlanExtension,omitempty"`
+}
+
 // PatchDefinition defines a patch which is applied to customize the referenced templates.
 type PatchDefinition struct {
 	// selector defines on which templates the patch should be applied.

internal/api/core/v1alpha4/conversion.go

@@ -263,6 +263,7 @@ func (src *ClusterClass) ConvertTo(dstRaw conversion.Hub) error {
 		dst.Spec.Workers.MachineDeployments[i].Rollout.Strategy = restored.Spec.Workers.MachineDeployments[i].Rollout.Strategy
 	}
 	dst.Status = restored.Status
+	dst.Spec.Upgrade.External.GenerateUpgradePlanExtension = restored.Spec.Upgrade.External.GenerateUpgradePlanExtension
 
 	return nil
 }