Documentation

Author: fabriziopandini

docs/book/src/developer/providers/migrations/v1.10-to-v1.11.md

@@ -22,7 +22,10 @@ proposal because most of the changes described below are a consequence of the wo
     * [MachineHealthCheck](#machinehealthcheck)
     * [ClusterClass](#clusterclass)
     * [KubeadmConfig](#kubeadmconfig)
+    * [KubeadmConfigTemplate](#kubeadmconfigtemplate)
     * [KubeadmControlPlane](#kubeadmcontrolplane)
+    * [KubeadmControlPlaneTemplate](#kubeadmcontrolplanetemplate)
+    * [ClusterResourceSetBinding](#clusterresourcesetbinding)
   * [Cluster API Contract changes](#cluster-api-contract-changes)
     * [Contract rules for InfraCluster](#contract-rules-for-infracluster)
     * [Contract rules for InfraMachine](#contract-rules-for-inframachine)
@@ -182,16 +185,65 @@ proposal because most of the changes described below are a consequence of the wo
 
 - KubeadmConfig (and the entire CABPK provider) now implements the v1beta2 Cluster API contract.
 - See changes that apply to [all CRDs](#all-crds)
-- The `spec.useExperimentalRetryJoin` field (deprecated in CAPI v1.2!) has been removed. 
+- ExtraArg field types have been changed from `map[string]sting` to `[]Arg`, thus aligning with kubeadm v1beta4 API;
+  however, using multiple args with the same name will be enabled only when v1beta1 is removed, tentatively tentatively in August 2026
+  - `spec.clusterConfiguration.apiServer.extraArgs` type has been changed to `[]Arg`
+  - `spec.clusterConfiguration.controllerManager.extraArgs` type has been changed to `[]Arg`
+  - `spec.clusterConfiguration.scheduler.extraArgs` type has been changed to `[]Arg`
+  - `spec.clusterConfiguration.etcd.local.nodeRegistration.extraArgs` type has been changed to `[]Arg`
+  - `spec.initConfiguration.nodeRegistration.kubeletExtraArgs` type has been changed to `[]Arg`
+  - `spec.joinConfiguration.nodeRegistration.kubeletExtraArgs` type has been changed to `[]Arg`
+- ImagePullPolicy field types have been changed from `string` to `corev1.PullPolicy`, thus aligning with kubeadm v1beta4 API
+  - `spec.initConfiguration.nodeRegistration.imagePullPolicy` type has been changed to `corev1.PullPolicy`
+  - `spec.joinConfiguration.nodeRegistration.imagePullPolicy` type has been changed to `corev1.PullPolicy`
+- Timeout fields have been aligned with kubeadm v1beta4 API, but filed name and type has been adapted according to API guidelines.
+  - `spec.initConfiguration.timeouts` struct has been added with the following fields:
+    - `controlPlaneComponentHealthCheckSeconds`
+    - `kubeletHealthCheckSeconds`
+    - `kubernetesAPICallSeconds`
+    - `etcdAPICallSeconds`
+    - `tlsBootstrapSeconds`
+    - `discoverySeconds`
+  - `spec.joinConfiguration.timeouts` field has been added with the same set of timeouts listed above.
+  - `spec.clusterConfiguration.apiServer.timeoutForControlPlane` field has been removed. Use `spec.initConfiguration.timeouts.controlPlaneComponentHealthCheckSeconds` instead.
+  - `spec.joinConfiguration.discovery.timeout` field has been removed. Use `spec.joinConfiguration.timeouts.tlsBootstrapSeconds` instead.
+- The `spec.useExperimentalRetryJoin` field (deprecated in CAPI v1.2!) has been removed.
 - Information about the initial provisioning process is now surfacing under the new `status.initialization` field.
   - `status.ready` has been replaced by `status.initialization.dataSecretCreated`
 - Support for terminal errors has been dropped (see [dataSecretCreated](#cluster-api-contract-changes)).
   - `status.failureReason` and `status.failureMessage` will continue to exist temporarily under `status.deprecated.v1beta1`.
+  
+### KubeadmConfigTemplate
+
+KubeadmConfigTemplate `spcc.template.spec` has been aligned to changes in the [KubeadmConfig](#kubeadmconfig) `spcc` struct. 
 
 ### KubeadmControlPlane
 
 - KubeadmControlPlane (and the entire KCP provider) now implements the v1beta2 Cluster API contract.
 - See changes that apply to [all CRDs](#all-crds)
+- ExtraArg field types have been changed from `map[string]sting` to `[]Arg`, thus aligning with kubeadm v1beta4 API;
+  however, using multiple args with the same name will be enabled only when v1beta1 is removed, tentatively tentatively in August 2026
+  - `spec.kubeadmConfigSpec.clusterConfiguration.apiServer.extraArgs` type has been changed to `[]Arg`
+  - `spec.kubeadmConfigSpec.clusterConfiguration.controllerManager.extraArgs` type has been changed to `[]Arg`
+  - `spec.kubeadmConfigSpec.clusterConfiguration.scheduler.extraArgs` type has been changed to `[]Arg`
+  - `spec.kubeadmConfigSpec.clusterConfiguration.etcd.local.nodeRegistration.extraArgs` type has been changed to `[]Arg`
+  - `spec.kubeadmConfigSpec.initConfiguration.nodeRegistration.kubeletExtraArgs` type has been changed to `[]Arg`
+  - `spec.kubeadmConfigSpec.joinConfiguration.nodeRegistration.kubeletExtraArgs` type has been changed to `[]Arg`
+- ImagePullPolicy field types have been changed from `string` to `corev1.PullPolicy`, thus aligning with kubeadm v1beta4 API
+  - `spec.kubeadmConfigSpec.initConfiguration.nodeRegistration.imagePullPolicy` type has been changed to `corev1.PullPolicy`
+  - `spec.kubeadmConfigSpec.joinConfiguration.nodeRegistration.imagePullPolicy` type has been changed to `corev1.PullPolicy`
+- Timeout fields have been aligned with kubeadm v1beta4 API, but filed name and type has been adapted according to API guidelines.
+  - `spec.kubeadmConfigSpec.initConfiguration.timeouts` struct has been added with the following fields:
+    - `controlPlaneComponentHealthCheckSeconds`
+    - `kubeletHealthCheckSeconds`
+    - `kubernetesAPICallSeconds`
+    - `etcdAPICallSeconds`
+    - `tlsBootstrapSeconds`
+    - `discoverySeconds`
+  - `spec.kubeadmConfigSpec.joinConfiguration.timeouts` field has been added with the same set of timeouts listed above.
+  - `spec.kubeadmConfigSpec.clusterConfiguration.apiServer.timeoutForControlPlane` field has been removed. Use `spec.kubeadmConfigSpec.initConfiguration.timeouts.controlPlaneComponentHealthCheckSeconds` instead.
+  - `spec.kubeadmConfigSpec.joinConfiguration.discovery.timeout` field has been removed. Use `spec.kubeadmConfigSpec.joinConfiguration.timeouts.tlsBootstrapSeconds` instead.
+- The `spec.kubeadmConfigSpec.useExperimentalRetryJoin` field (deprecated in CAPI v1.2!) has been removed.
 - Replica counters fields are now consistent with replica counters from other resources.
   - `status.replicas` was made a pointer and omitempty was added
   - `status.readyReplicas` has now a new semantic based on machine's `Ready` condition
@@ -204,6 +256,10 @@ proposal because most of the changes described below are a consequence of the wo
 - Support for terminal errors has been dropped.
   - `status.failureReason` and `status.failureMessage` will continue to exist temporarily under `status.deprecated.v1beta1`.
 
+### KubeadmControlPlaneTemplate
+
+KubeadmControlPlaneTemplate `spcc.template.spec` has been aligned to changes in the [KubeadmControlPlane](#kubeadmcontrolplane) `spcc` struct.
+
 ### ClusterResourceSetBinding
 
 - Remove deprecated `ClusterResourceSetBinding.DeleteBinding` func