From 85d30eaef642ee56819763cd627df5cc9eee2231 Mon Sep 17 00:00:00 2001 From: Katherine Chen Date: Wed, 29 Jul 2026 13:29:52 +1000 Subject: [PATCH] UID2-7589: update AKS guide Kubernetes version from 1.33 to 1.36 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The AKS Private Operator integration guide showed --kubernetes-version 1.33 in its az aks create example. Azure gives each Kubernetes minor version 12 months of standard support after GA; 1.33 went GA in Jun 2025 and reached end of life in Jul 2026, so it is now Long-Term Support only. A partner following this guide verbatim would hit: ERROR: (K8sVersionNotSupported) ... is on version 1.33.13, which is only available for Long-Term Support (LTS). Bumped the example to 1.36, the latest GA release (GA Jun 2026, EOL Jun 2027), matching the version now used by the operator E2E setup script in uid2-shared-actions. Also expanded the accompanying note so readers do not depend on the example staying current: it now explains that minor versions leave standard support on a ~12-month cadence, names the K8sVersionNotSupported error so the failure is searchable, and gives the az aks get-versions command for finding the versions currently available in their region. Japanese translation intentionally left unchanged — handled by the translation pipeline. Co-Authored-By: Claude Opus 5 --- docs/guides/operator-guide-aks-enclave.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/guides/operator-guide-aks-enclave.md b/docs/guides/operator-guide-aks-enclave.md index 953e1e56e..860a715b3 100644 --- a/docs/guides/operator-guide-aks-enclave.md +++ b/docs/guides/operator-guide-aks-enclave.md @@ -280,7 +280,7 @@ az aks create \ --resource-group ${RESOURCE_GROUP} \ --name ${AKS_CLUSTER_NAME} \ --location ${LOCATION} \ - --kubernetes-version 1.33 \ + --kubernetes-version 1.36 \ --network-plugin azure \ --network-policy calico \ --vnet-subnet-id ${AKS_SUBNET_ID} \ @@ -297,7 +297,7 @@ az aks create \ --os-sku Ubuntu ``` :::note -Be sure to use the latest supported Kubernetes version, using the `--kubernetes-version` flag. If you use an earlier version, you must enable Long-Term Support (LTS). For details, see [Long-term support for Azure Kubernetes Service (AKS) versions](https://learn.microsoft.com/en-us/azure/aks/long-term-support) in the Microsoft documentation. +Be sure to use the latest supported Kubernetes version, using the `--kubernetes-version` flag. The version shown above is only an example: Azure moves each Kubernetes minor version out of standard support about 12 months after its release, and cluster creation then fails with `K8sVersionNotSupported`. To list the versions currently available in your region, run `az aks get-versions --location ${LOCATION}`. If you use a version that is no longer in standard support, you must enable Long-Term Support (LTS). For details, see [Long-term support for Azure Kubernetes Service (AKS) versions](https://learn.microsoft.com/en-us/azure/aks/long-term-support) in the Microsoft documentation. ::: #### Get the principal ID of the managed identity