diff --git a/docs/book/src/security/pod-security-standards.md b/docs/book/src/security/pod-security-standards.md index c8ab7801a560..4a9fb8512ad2 100644 --- a/docs/book/src/security/pod-security-standards.md +++ b/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: ... diff --git a/docs/book/src/tasks/experimental-features/cluster-class/operate-cluster.md b/docs/book/src/tasks/experimental-features/cluster-class/operate-cluster.md index dd2e4a383f82..b90e4227855d 100644 --- a/docs/book/src/tasks/experimental-features/cluster-class/operate-cluster.md +++ b/docs/book/src/tasks/experimental-features/cluster-class/operate-cluster.md @@ -284,15 +284,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 ... ``` @@ -307,14 +307,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: @@ -334,13 +334,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 ... diff --git a/docs/book/src/tasks/experimental-features/cluster-class/write-clusterclass.md b/docs/book/src/tasks/experimental-features/cluster-class/write-clusterclass.md index 2eeb416ed1fc..1744a3631714 100644 --- a/docs/book/src/tasks/experimental-features/cluster-class/write-clusterclass.md +++ b/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,32 @@ 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: + maxUnhealthy: 33% + nodeStartupTimeoutSeconds: 900 unhealthyNodeConditions: - type: Ready status: Unknown - timeout: 300s + timeoutSeconds: 300 - type: Ready status: "False" - timeout: 300s + timeoutSeconds: 300 + workers: + machineDeployments: + - class: default-worker + ... + healthCheck: + checks: + unhealthyRange: "[0-2]" + nodeStartupTimeoutSeconds: 600 + unhealthyNodeConditions: + - type: Ready + status: Unknown + timeoutSeconds: 300 + - type: Ready + status: "False" + timeoutSeconds: 300 ``` ## ClusterClass with patches @@ -479,7 +474,7 @@ spec: matchConstraints: resourceRules: - apiGroups: ["cluster.x-k8s.io"] - apiVersions: ["v1beta1"] + apiVersions: ["v1beta2"] operations: ["CREATE", "UPDATE"] resources: ["clusters"] validations: @@ -537,7 +532,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 +544,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 +657,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: diff --git a/docs/book/src/tasks/experimental-features/runtime-sdk/implement-topology-mutation-hook.md b/docs/book/src/tasks/experimental-features/runtime-sdk/implement-topology-mutation-hook.md index b556632ccd88..e9a0de81da07 100644 --- a/docs/book/src/tasks/experimental-features/runtime-sdk/implement-topology-mutation-hook.md +++ b/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: