You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: AKS-Hybrid/cluster-k8s-version.md
+31-11Lines changed: 31 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,7 +11,7 @@ ms.reviewer: abha
11
11
12
12
# Troubleshoot K8sVersionValidation error code
13
13
14
-
This article discusses how to identify and resolve the K8sVersionValidation error code that occurs when you try to create and deploy an AKS enabled by Azure Arc cluster.
14
+
This article discusses how to identify and resolve the K8sVersionValidation error code that occurs when you try to create and deploy an AKS cluster on Azure Local.
15
15
16
16
## Symptoms
17
17
@@ -23,19 +23,20 @@ OR
23
23
24
24
> Kubernetes version 1.26.12 is not supported. Please go to https://aka.ms/aksarcsupportedversions for details about the supported Kubernetes version on this platform.
25
25
26
-
## Error messages
26
+
OR
27
27
28
-
### Kubernetes version 1.27.7 is not ready for use on Linux. Please go to https://aka.ms/aksarccheckk8sversions for details of how to check the readiness of Kubernetes versions
28
+
> Admission webhook \'vhybridakscluster.kb.io\' denied the request: Kubernetes version 1.26.12 is not available"
29
29
30
-
#### Issue 1: Linux VHD download has not completed
31
30
32
-
When you install Azure Stack HCI, you download a Linux VHD of approximately 4-5GB in size. This Linux VHD is used to create the underlying VMs for the Kubernetes nodes in your AKS Arc cluster. One cause of the error message is if your Linux VHD has not finished downloading. To resolve this issue, you should wait sometime based on how long it takes for your internet connection to finish downloading the Linux VHD image.
31
+
## Error messages
33
32
34
-
#### Issue 2: The **kubernetesVersions/default** or the **skus/default** resource in Azure is not yet created, or was deleted for some reason.
33
+
###Kubernetes version 1.27.7 is not ready for use on Linux. Please go to https://aka.ms/aksarccheckk8sversions for details of how to check the readiness of Kubernetes versions
35
34
36
-
This scenario can happen in older releases when the default resource for Kubernetes version (or VM sizes) was not created as a part of the Azure Stack HCI deployment.
35
+
#### Linux VHD download has not completed
37
36
38
-
To resolve this issue, run the following command:
37
+
When you install Azure Local, you download a Linux VHD of approximately 4-5GB in size. This Linux VHD is used to create the underlying VMs for the Kubernetes nodes in your AKS Arc cluster. One cause of the error message is if your Linux VHD has not finished downloading. To resolve this issue, you should wait sometime based on how long it takes for your internet connection to finish downloading the Linux VHD image.
38
+
39
+
To check if the image download is in progress or has finished, run the below command:
If the above command says that the K8s versions are ready, and you're running Azure Local, [release 2411](/azure/aks/hybrid/aks-whats-new-23h2#release-2411) or newer, file a [support request](/help-support.md).
51
+
52
+
If you're running Azure Local release 2408 or older, proceed to the below section.
53
+
54
+
#### Recreate **kubernetesVersions/default**
50
55
51
-
Sometimes, you may have to recreate the **kubernetesVersions/default**. You can run the following commands to do so:
56
+
If you redeploy Azure Local with the same name and parameters, you may have to recreate the **kubernetesVersions/default**. You can run the following commands to do so:
52
57
53
58
```azurecli
54
59
$subscription = <subscription_id>
@@ -69,9 +74,24 @@ az rest --headers "Authorization=Bearer $token" "Content-Type=application/json;c
69
74
az aksarc get-versions --custom-location $cl_id
70
75
```
71
76
77
+
#### I cannot see the Kubernetes versions or VM size options on the Azure portal
78
+
79
+
This scenario can happen in Azure Local releases 2408 or older, when the default resource for Kubernetes version (or VM sizes) was not created as a part of the Azure Local deployment.
# Get the kubernetes version or the VM sizes using CLI (it automatically creates the **kubernetesVersions/default** or the **skus/default** azure resource).
87
+
88
+
az aksarc get-versions --custom-location $cl_id
89
+
az aksarc vmsize list --custom-location $cl_id
90
+
```
91
+
72
92
### Kubernetes version 1.26.12 is not supported. Please go to https://aka.ms/aksarcsupportedversions for details about the supported Kubernetes version on this platform.
73
93
74
-
Azure Stack HCI supports specific Kubernetes versions in each of its releases. As stated in the error message, navigate to https://aka.ms/aksarcsupportedversions for list of supported Kubernetes versions based on your deployed Azure Stack HCI release.
94
+
Azure Local supports specific Kubernetes versions in each of its releases. As stated in the error message, navigate to https://aka.ms/aksarcsupportedversions for list of supported Kubernetes versions based on your deployed Azure Local release.
0 commit comments