Merge pull request #3579 from MicrosoftDocs/main638791237648229368sync_temp

For protected branch, push strategy should use PR and merge to target branch method to work around git push error

Author: learn-build-service-prod[bot]

AKS-Arc/TOC.yml

@@ -151,20 +151,20 @@
       href: aks-troubleshoot.md
     - name: Control plane configuration validation errors
       href: control-plane-validation-errors.md
-    - name: Connectivity issues with MetalLB
-      href: load-balancer-issues.md 
     - name: K8sVersionValidation error
       href: cluster-k8s-version.md
     - name: Use diagnostic checker
       href: aks-arc-diagnostic-checker.md
     - name: KubeAPIServer unreachable error
       href: kube-api-server-unreachable.md
-    - name: Can't see VM SKUs on Azure portal
-      href: check-vm-sku.md
     - name: Deleted AKS Arc cluster still visible on Azure portal
       href: deleted-cluster-visible.md
     - name: Can't fully delete AKS Arc cluster with PodDisruptionBudget (PDB) resources
       href: delete-cluster-pdb.md
+    - name: Can't see VM SKUs on Azure portal
+      href: check-vm-sku.md
+    - name: Connectivity issues with MetalLB
+      href: load-balancer-issues.md 
     - name: Azure Advisor upgrade recommendation
       href: azure-advisor-upgrade.md
     - name: Issues after deleting storage volumes

AKS-Arc/aks-create-clusters-cli.md

@@ -4,7 +4,7 @@ description: Learn how to create Kubernetes clusters in Azure Local using Azure
 ms.topic: how-to
 ms.custom: devx-track-azurecli
 author: sethmanheim
-ms.date: 02/18/2025
+ms.date: 03/31/2025
 ms.author: sethm 
 ms.lastreviewed: 01/25/2024
 ms.reviewer: guanghu
@@ -44,7 +44,7 @@ az extension add -n connectedk8s --upgrade
 
 ## Create a Kubernetes cluster
 
-Use the `az aksarc create` command to create a Kubernetes cluster in AKS Arc. Make sure you sign in to Azure before running this command. If you have multiple Azure subscriptions, select the appropriate subscription ID using the [az account set](/cli/azure/account#az-account-set) command.
+Use the [`az aksarc create`](/cli/azure/aksarc#az-aksarc-create) command to create a Kubernetes cluster in AKS Arc. Make sure you sign in to Azure before you run this command. If you have multiple Azure subscriptions, select the appropriate subscription ID using the [`az account set`](/cli/azure/account#az-account-set) command. With the  `az aksarc create` command, we recommend that you use the `--validate` flag, which validates the input parameters that you intend to use. Once the input parameters are validated, you can run the  `az aksarc create` command without the `--validate` flag to create the Kubernetes cluster. 
 
 ```azurecli
 az aksarc create -n $aksclustername -g $resource_group --custom-location $customlocationID --vnet-ids $logicnetId --aad-admin-group-object-ids $aadgroupID --generate-ssh-keys 

AKS-Arc/aks-troubleshoot.md

@@ -3,9 +3,9 @@ title: Troubleshoot common issues in AKS enabled by Azure Arc
 description: Learn about common issues and workarounds in AKS enabled by Arc.
 ms.topic: how-to
 author: sethmanheim
-ms.date: 02/28/2025
+ms.date: 04/01/2025
 ms.author: sethm 
-ms.lastreviewed: 02/27/2024
+ms.lastreviewed: 04/01/2025
 ms.reviewer: guanghu
 
 ---
@@ -20,18 +20,26 @@ To open a support request, see the [Get support](/azure/aks/hybrid/help-support)
 
 ## Known issues
 
-The following sections describe known issues and workarounds for AKS enabled by Azure Arc:
-
-- [Control plane configuration validation errors](control-plane-validation-errors.md)
-- [Connectivity issues with MetalLB](load-balancer-issues.md)
-- [K8sVersionValidation error](cluster-k8s-version.md)
-- [Use diagnostic checker](aks-arc-diagnostic-checker.md)
-- [KubeAPIServer unreachable error](kube-api-server-unreachable.md)
-- [Can't see VM SKUs on Azure portal](check-vm-sku.md)
-- [Deleted AKS Arc cluster still visible on Azure portal](deleted-cluster-visible.md)
-- [Can't fully delete AKS Arc cluster with PodDisruptionBudget (PDB) resources](delete-cluster-pdb.md)
-- [Azure Advisor upgrade recommendation message](azure-advisor-upgrade.md)
-- [Issues after deleting storage volume](delete-storage-volume.md)
+The following sections describe known issues for AKS enabled by Azure Arc:
+
+| AKS Arc CRUD operation | Issue | Fix status |
+|------------------------|-------|------------|
+| AKS cluster delete     | [Deleted AKS Arc cluster still visible on Azure portal](deleted-cluster-visible.md) | Active |
+| AKS cluster delete     | [Can't fully delete AKS Arc cluster with PodDisruptionBudget (PDB) resources](delete-cluster-pdb.md) | Fixed in 2503 release |
+| Azure portal           | [Can't see VM SKUs on Azure portal](check-vm-sku.md) | Fixed in 2411 release |
+| MetalLB Arc extension  | [Connectivity issues with MetalLB](load-balancer-issues.md) | Fixed in 2411 release | 
+
+
+## Guides to diagnose and troubleshoot Kubernetes CRUD failures
+
+| AKS Arc operation | Issue | 
+|------------------------|-------|
+| Create validation      | [Control plane configuration validation errors](control-plane-validation-errors.md) 
+| Create validation      | [K8sVersionValidation error](cluster-k8s-version.md)   
+| Create validation      | [KubeAPIServer unreachable error](kube-api-server-unreachable.md)  
+| Network configuration issues | [Use diagnostic checker](aks-arc-diagnostic-checker.md)
+| Kubernetes steady state   | [Issues after deleting storage volume](delete-storage-volume.md)
+| Release validation     | [Azure Advisor upgrade recommendation message](azure-advisor-upgrade.md)
 
 ## Next steps
 

AKS-Arc/aks-whats-new-23h2.md

@@ -2,11 +2,11 @@
 title: What's new in AKS on Azure Local, version 23H2
 description: Learn about what's new in AKS on Azure Local, version 23H2.
 ms.topic: overview
-ms.date: 11/19/2024
+ms.date: 04/01/2025
 author: sethmanheim
 ms.author: sethm 
 ms.reviewer: guanghu
-ms.lastreviewed: 06/25/2024
+ms.lastreviewed: 04/01/2025
 
 ---
 
@@ -42,6 +42,23 @@ By integrating these components, Azure Arc offers a unified and efficient Kubern
 
 This section lists the new features and improvements in AKS Arc in each release of Azure Local, version 23H2.
 
+### Release 2503
+
+The following Kubernetes cluster deployment and management capabilities are available:
+
+- **Large VM SKUs for Kubernetes nodepools**: Added two new VM SKUs - `Standard_D32s_v3`: 32 vCPU, 128 GiB and `Standard_D16s_v3`: 16 vCPU, 64 GiB - to support larger nodepools on an AKS cluster. For more information about supported VM sizes, see [supported scale options](scale-requirements.md).
+- **Improved log collection experience**: Improved log collection for AKS control plane node VMs and nodepool VMs, with support for passing multiple IP addresses and SSH key or directory path. For more information, see [on-demand log collection](get-on-demand-logs.md) and [az aksarc get-logs CLI](/cli/azure/aksarc#az-aksarc-get-logs).
+- **Improved diagnosability**: The [Diagnostic Checker tool](aks-arc-diagnostic-checker.md) is automatically run in case of Kubernetes cluster create failure, and added new test cases.
+- **Improved Kubernetes cluster delete**: Fixed deletion issues; for example, due to [pod disruption budgets](delete-cluster-pdb.md?tabs=aks-on-azure-local).
+- **Improved AKS Arc image download**: Fixed issues with AKS Arc image downloads.
+- **Improved GPU support**: Improved error handling for Kubernetes cluster creation with GPU enabled nodepools. Fixed known issues with attaching persistent volumes on GPU enabled nodepools.
+
+To get started with these features in the 2503 release, make sure to update your [AKSArc CLI extension](/cli/azure/aksarc) to version 1.5.37 or higher.
+
+#### Supported Kubernetes versions for 2503
+
+The Kubernetes versions supported in the 2503 release are: 1.28.12, 1.28.14, 1.29.7, 1.29.9, 1.30.3 and 1.30.4.
+
 ### Release 2411
 
 The following Kubernetes cluster deployment and management capabilities are available:

AKS-Arc/delete-cluster-pdb.md

@@ -4,7 +4,7 @@ description: Learn how to troubleshoot when deleted workload cluster resources c
 ms.topic: troubleshooting
 author: sethmanheim
 ms.author: sethm
-ms.date: 12/12/2024
+ms.date: 04/01/2025
 ms.reviewer: leslielin
 
 ---
@@ -15,7 +15,13 @@ ms.reviewer: leslielin
 
 When you delete an AKS Arc cluster that has [PodDisruptionBudget](https://kubernetes.io/docs/tasks/run-application/configure-pdb/) (PDB) resources, the deletion might fail to remove the PDB resources. By default, PDB is installed in the workload identity-enabled AKS Arc cluster.
 
-## Workaround
+## Mitigation
+
+This issue was fixed in [AKS on Azure Local, version 2503](aks-whats-new-23h2.md#release-2503).
+
+If you're on an older build, please update to Azure Local, version 2503. Once you update to 2503, you can retry deleting the AKS cluster. If the retry doesn't work, follow this workaround. File a support case if the retry does not delete the AKS cluster.
+
+## Workaround for AKS Edge Essentials and prior versions of AKS on Azure Local.
 
 Before you delete the AKS Arc cluster, access the AKS Arc cluster's **kubeconfig** and delete all PDBs:
 

AKS-Arc/get-on-demand-logs.md

@@ -28,13 +28,13 @@ Before log collection, you must have the SSH key you obtained when you created t
 You can collect logs using IPs or the `kubeconfig` parameter. If an IP is used, it collects the log from a particular node. If `kubeconfig` is used, it collects logs from all cluster nodes. This command generates a .zip file on the local disk. For other parameters, see the [Az CLI reference](/cli/azure/aksarc/logs#az-aksarc-logs-hci).
 
 ```azurecli
-az aksarc logs hci --ip 192.168.200.25 --credentials-dir ./.ssh --out-dir ./logs
+az aksarc get-logs --ip 192.168.200.25 --credentials-dir ./.ssh --out-dir ./logs
 ```
 
 Or
 
 ```azurecli
-az aksarc logs hci --kubeconfig ./.kube/config --credentials-dir ./.ssh --out-dir ./logs
+az aksarc get-logs --kubeconfig ./.kube/config --credentials-dir ./.ssh --out-dir ./logs
 ```
 
 ## Send logs to Microsoft Support

AKS-Arc/scale-requirements.md

@@ -49,20 +49,22 @@ This article describes the maximum and minimum supported scale count for AKS on
 
 | VM Size                     | CPU  | Memory (GB)  |
 |-----------------------------|------|--------------|
+| Standard_K8S3_v1            | 4    | 6            |
 | Standard_A4_v2              | 4    | 8            |
 | Standard_D4s_v3             | 4    | 16           |
 | Standard_D8s_v3             | 8    | 32           |
-| Standard_K8S3_v1            | 4    | 6            |
 
 ## Supported values for worker node sizes
 
 | VM Size                     | CPU  | Memory (GB)  |
 |-----------------------------|------|--------------|
-| Standard_A4_v2              | 4    | 8            |
 | Standard_A2_v2              | 2    | 4            |
+| Standard_K8S3_v1            | 4    | 6            |
+| Standard_A4_v2              | 4    | 8            |
 | Standard_D4s_v3             | 4    | 16           |
 | Standard_D8s_v3             | 8    | 32           |
-| Standard_K8S3_v1            | 4    | 6            |
+| Standard_D16s_v3            | 16   | 64           |
+| Standard_D8s_v3             | 32   | 128          |
 
 For more worker node sizes with GPU support, see the next section.
 

AKS-Arc/supported-kubernetes-versions.md

@@ -42,16 +42,17 @@ You should install the latest patch release of the minor version you're running.
 
 |  K8s minor version | Supported Azure Local versions | Current status | Last release with Kubernetes patch/CVE updates |
 |--------------|-------------------|--------------|------------|
-| 1.30 | TBD | Upcoming | TBD |
-| 1.29 | [2411](aks-whats-new-23h2.md#features-and-improvements), [2408](aks-whats-new-23h2.md#release-2408) | Generally available | TBD |
-| 1.28 | [2411](aks-whats-new-23h2.md#features-and-improvements), [2408](aks-whats-new-23h2.md#release-2408), [2405](aks-whats-new-23h2.md#release-2405) | Generally available | TBD |
-| 1.27 | [2411](aks-whats-new-23h2.md#features-and-improvements), [2408](aks-whats-new-23h2.md#release-2408), [2405](aks-whats-new-23h2.md#release-2405), 2402 | Generally available | 2411 release |
+| 1.30 | [2503](aks-whats-new-23h2.md#features-and-improvements) | Generally Available | TBD |
+| 1.29 | [2503](aks-whats-new-23h2.md#features-and-improvements), [2411](aks-whats-new-23h2.md#features-and-improvements), [2408](aks-whats-new-23h2.md#release-2408) | Generally available | TBD |
+| 1.28 | [2503](aks-whats-new-23h2.md#features-and-improvements), [2411](aks-whats-new-23h2.md#features-and-improvements), [2408](aks-whats-new-23h2.md#release-2408), [2405](aks-whats-new-23h2.md#release-2405) | No more patch versions/CVE updates | 2503 release |
+| 1.27 | [2411](aks-whats-new-23h2.md#features-and-improvements), [2408](aks-whats-new-23h2.md#release-2408), [2405](aks-whats-new-23h2.md#release-2405), 2402 | No more patch versions/CVE updates | 2411 release |
 | 1.26 | [2405](aks-whats-new-23h2.md#release-2405), 2402 and older | No more patch versions/CVE updates | 2405 release |
 
 ### AKS Arc supported Kubernetes minor and patch versions per release
 
 | Release             | Supported minor & patch versions                 |
 |---------------------|--------------------------------------------------|
+| 2503                | 1.28.12, 1.28.14, 1.29.7, 1.29.9, 1.30.3, 1.30.4  |
 | 2411                | 1.27.7, 1.27.9, 1.28.5, 1.28.9, 1.29.2, 1.29.4   |
 | 2408                | 1.27.7, 1.27.9, 1.28.5, 1.28.9, 1.29.2, 1.29.4   |
 | 2405                | 1.26.10, 1.26.12, 1.27.7, 1.27.9, 1.28.3, 1.28.5 |