🌱 Update examples & code snippets in Cluster API book to v1beta2 for ClusterClass (#12491)

* update doc for ClusterClass

Signed-off-by: sivchari <[email protected]>

* update spec

Signed-off-by: sivchari <[email protected]>

* fix link

Signed-off-by: sivchari <[email protected]>

* address review comment

Signed-off-by: sivchari <[email protected]>

---------

Signed-off-by: sivchari <[email protected]>

Author: sivchari

docs/book/src/security/pod-security-standards.md

@@ -12,7 +12,7 @@ By adding the following variables and patches Pod Security Standards can be adde
 ### Adding the variables to a ClusterClass
 
 ```yaml
-apiVersion: cluster.x-k8s.io/v1beta1
+apiVersion: cluster.x-k8s.io/v1beta2
 kind: ClusterClass
 spec:
   variables:
@@ -62,7 +62,7 @@ Use this patch if the following keys **already exist** inside the `KubeadmContro
 - `.spec.template.spec.kubeadmConfigSpec.files`
 
 ```yaml
-apiVersion: cluster.x-k8s.io/v1beta1
+apiVersion: cluster.x-k8s.io/v1beta2
 kind: ClusterClass
 spec:
   ...
@@ -128,7 +128,7 @@ Use this patches if the following keys **do not** exist inside the `KubeadmContr
 > **Attention:** Existing values inside the `KubeadmControlPlaneTemplate` at the mentioned keys will be replaced by this patch.
 
 ```yaml
-apiVersion: cluster.x-k8s.io/v1beta1
+apiVersion: cluster.x-k8s.io/v1beta2
 kind: ClusterClass
 spec:
   ...

docs/book/src/tasks/experimental-features/cluster-class/operate-cluster.md

@@ -285,15 +285,15 @@ This means in the following example the Cluster topology controller will always
 patches for the infrastructure ref, even if the `DockerClusterTemplate` already has a `v1beta2` apiVersion.
 
 ```yaml
-apiVersion: cluster.x-k8s.io/v1beta1
+apiVersion: cluster.x-k8s.io/v1beta2
 kind: ClusterClass
 metadata:
   name: quick-start
   namespace: default
 spec:
   infrastructure:
-    ref:
-      apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
+    templateRef:
+      apiVersion: infrastructure.cluster.x-k8s.io/v1beta2
       kind: DockerClusterTemplate
 ...
 ```
@@ -308,14 +308,14 @@ apiVersion of the referenced CRD. The following example shows how to upgrade the
 
 ClusterClass with the old apiVersion:
 ```yaml
-apiVersion: cluster.x-k8s.io/v1beta1
+apiVersion: cluster.x-k8s.io/v1beta2
 kind: ClusterClass
 metadata:
   name: quick-start
 spec:
   infrastructure:
-    ref:
-      apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
+    templateRef:
+      apiVersion: infrastructure.cluster.x-k8s.io/v1beta2
       kind: DockerClusterTemplate
 ...
   patches:
@@ -335,13 +335,13 @@ spec:
 
 ClusterClass with the new apiVersion:
 ```yaml
-apiVersion: cluster.x-k8s.io/v1beta1
+apiVersion: cluster.x-k8s.io/v1beta2
 kind: ClusterClass
 metadata:
   name: quick-start
 spec:
   infrastructure:
-    ref:
+    templateRef:
       apiVersion: infrastructure.cluster.x-k8s.io/v1beta2 # apiVersion updated
       kind: DockerClusterTemplate
 ...

docs/book/src/tasks/experimental-features/cluster-class/write-clusterclass.md

@@ -36,39 +36,33 @@ metadata:
   name: docker-clusterclass-v0.1.0
 spec:
   controlPlane:
-    ref:
+    templateRef:
       apiVersion: controlplane.cluster.x-k8s.io/v1beta2
       kind: KubeadmControlPlaneTemplate
       name: docker-clusterclass-v0.1.0
-      namespace: default
     machineInfrastructure:
-      ref:
+      templateRef:
+        apiVersion: infrastructure.cluster.x-k8s.io/v1beta2
         kind: DockerMachineTemplate
-        apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
         name: docker-clusterclass-v0.1.0
-        namespace: default
   infrastructure:
-    ref:
-      apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
+    templateRef:
+      apiVersion: infrastructure.cluster.x-k8s.io/v1beta2
       kind: DockerClusterTemplate
       name: docker-clusterclass-v0.1.0-control-plane
-      namespace: default
   workers:
     machineDeployments:
     - class: default-worker
-      template:
-        bootstrap:
-          ref:
-            apiVersion: bootstrap.cluster.x-k8s.io/v1beta2
-            kind: KubeadmConfigTemplate
-            name: docker-clusterclass-v0.1.0-default-worker
-            namespace: default
-        infrastructure:
-          ref:
-            apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
-            kind: DockerMachineTemplate
-            name: docker-clusterclass-v0.1.0-default-worker
-            namespace: default
+      bootstrap:
+        templateRef:
+          apiVersion: bootstrap.cluster.x-k8s.io/v1beta2
+          kind: KubeadmConfigTemplate
+          name: docker-clusterclass-v0.1.0-default-worker
+      infrastructure:
+        templateRef:
+          apiVersion: infrastructure.cluster.x-k8s.io/v1beta2
+          kind: DockerMachineTemplate
+          name: docker-clusterclass-v0.1.0-default-worker
 ```
 
 The following example shows a Cluster using this ClusterClass. In this case a `KubeadmControlPlane` 
@@ -142,17 +136,16 @@ spec:
   workers:
     machinePools:
     - class: default-worker
-      template:
-        bootstrap:
-          ref:
-            apiVersion: bootstrap.cluster.x-k8s.io/v1beta2
-            kind: KubeadmConfigTemplate
-            name: quick-start-default-worker-bootstraptemplate
-        infrastructure:
-          ref:
-            apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
-            kind: DockerMachinePoolTemplate
-            name: quick-start-default-worker-machinepooltemplate
+      bootstrap:
+        templateRef:
+          apiVersion: bootstrap.cluster.x-k8s.io/v1beta2
+          kind: KubeadmConfigTemplate
+          name: quick-start-default-worker-bootstraptemplate
+      infrastructure:
+        templateRef:
+          apiVersion: infrastructure.cluster.x-k8s.io/v1beta2
+          kind: DockerMachinePoolTemplate
+          name: quick-start-default-worker-machinepooltemplate
 ```
 
 They can then be similarly defined as workers in the cluster template like so:
@@ -191,30 +184,36 @@ metadata:
 spec:
   controlPlane:
     ...
-    machineHealthCheck:
-      maxUnhealthy: 33%
-      nodeStartupTimeout: 15m
-      unhealthyNodeConditions:
-      - type: Ready
-        status: Unknown
-        timeout: 300s
-      - type: Ready
-        status: "False"
-        timeout: 300s
-  workers:
-    machineDeployments:
-    - class: default-worker
-      ...
-      machineHealthCheck:
-        unhealthyRange: "[0-2]"
-        nodeStartupTimeout: 10m
+    healthCheck:
+      checks:
+        nodeStartupTimeoutSeconds: 900
         unhealthyNodeConditions:
         - type: Ready
           status: Unknown
-          timeout: 300s
+          timeoutSeconds: 300
         - type: Ready
           status: "False"
-          timeout: 300s
+          timeoutSeconds: 300
+      remediation:
+        triggerIf:
+          unhealthyLessThanOrEqualTo: 33%
+  workers:
+    machineDeployments:
+    - class: default-worker
+      ...
+      healthCheck:
+        checks:
+          nodeStartupTimeoutSeconds: 600
+          unhealthyNodeConditions:
+          - type: Ready
+            status: Unknown
+            timeoutSeconds: 300
+          - type: Ready
+            status: "False"
+            timeoutSeconds: 300
+        remediation:
+          triggerIf:
+            unhealthyInRange: "[0-2]"
 ```
 
 ## ClusterClass with patches
@@ -479,7 +478,7 @@ spec:
   matchConstraints:
     resourceRules:
     - apiGroups:   ["cluster.x-k8s.io"]
-      apiVersions: ["v1beta1"]
+      apiVersions: ["v1beta2"]
       operations:  ["CREATE", "UPDATE"]
       resources:   ["clusters"]
   validations:
@@ -537,7 +536,7 @@ spec:
   - name: workerMachineType
     definitions:
     - selector:
-        apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
+        apiVersion: infrastructure.cluster.x-k8s.io/v1beta2
         kind: AWSMachineTemplate
         matchResources:
           machineDeploymentClass:
@@ -549,7 +548,7 @@ spec:
         valueFrom:
           variable: workerMachineType
 ---
-apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
+apiVersion: infrastructure.cluster.x-k8s.io/v1beta2
 kind: AWSMachineTemplate
 metadata:
   name: aws-clusterclass-v0.1.0-default-worker
@@ -662,7 +661,7 @@ spec:
     description: "Sets the container image that is used for running dockerMachines."
     definitions:
     - selector:
-        apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
+        apiVersion: infrastructure.cluster.x-k8s.io/v1beta2
         kind: DockerMachineTemplate
         matchResources:
           machineDeploymentClass:

docs/book/src/tasks/experimental-features/runtime-sdk/implement-topology-mutation-hook.md

@@ -47,7 +47,7 @@ External variable definitions are discovered by calling the DiscoverVariables ru
 Once discovered the variable definitions are validated and stored in ClusterClass status.
 
 ```yaml
-apiVersion: cluster.x-k8s.io/v1beta1
+apiVersion: cluster.x-k8s.io/v1beta2
 kind: ClusterClass
 # metadata
 spec:
@@ -74,8 +74,8 @@ spec:
     patches:
     - name: lbImageRepository
       external:
-          generateExtension: generate-patches.k8s-upgrade-with-runtimesdk
-          validateExtension: validate-topology.k8s-upgrade-with-runtimesdk
+          generatePatchesExtension: generate-patches.k8s-upgrade-with-runtimesdk
+          validateTopologyExtension: validate-topology.k8s-upgrade-with-runtimesdk
           ## Call variable discovery for this patch.
           discoverVariablesExtension: discover-variables.k8s-upgrade-with-runtimesdk
 status: