Skip to content

Commit 11d6286

Browse files
Update cluster-k8s-version.md
1 parent ecfb4e9 commit 11d6286

File tree

1 file changed

+31
-11
lines changed

1 file changed

+31
-11
lines changed

AKS-Hybrid/cluster-k8s-version.md

Lines changed: 31 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ ms.reviewer: abha
1111

1212
# Troubleshoot K8sVersionValidation error code
1313

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.
1515

1616
## Symptoms
1717

@@ -23,19 +23,20 @@ OR
2323

2424
> 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.
2525
26-
## Error messages
26+
OR
2727

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"
2929
30-
#### Issue 1: Linux VHD download has not completed
3130

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
3332

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
3534

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
3736

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:
3940

4041
```azurecli
4142
$cl_id = "/subscriptions/<subscription_id>/resourceGroups/<resource_group_name>/providers/Microsoft.ExtendedLocation/customLocations/<custom_location_name>"
@@ -46,9 +47,13 @@ az aksarc get-versions --custom-location $cl_id
4647
az aksarc vmsize list --custom-location $cl_id
4748
```
4849

49-
#### Issue 3: Recreate **kubernetesVersions/default**
50+
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**
5055

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:
5257

5358
```azurecli
5459
$subscription = <subscription_id>
@@ -69,9 +74,24 @@ az rest --headers "Authorization=Bearer $token" "Content-Type=application/json;c
6974
az aksarc get-versions --custom-location $cl_id
7075
```
7176

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.
80+
81+
To resolve this issue, run the following command:
82+
83+
```azurecli
84+
$cl_id = "/subscriptions/<subscription_id>/resourceGroups/<resource_group_name>/providers/Microsoft.ExtendedLocation/customLocations/<custom_location_name>"
85+
86+
# 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+
7292
### 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.
7393

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.
7595

7696

7797
## Next steps

0 commit comments

Comments
 (0)