Merge pull request #17225 from sethmanheim/guang2-28

sethmanheim · web-flow · commit 6087a9233c00 · 2025-02-28T11:32:01.000-08:00
AKS: pull commits from public repo
diff --git a/.openpublishing.redirection.aks.json b/.openpublishing.redirection.aks.json
diff --git a/AKS-Arc/TOC.yml b/AKS-Arc/TOC.yml
@@ -144,7 +144,7 @@
             href: kubernetes-monitor-metrics.md
   - name: Troubleshooting
     items:
-    - name: Troubleshoot & known issues
+    - name: Troubleshoot and known issues
       href: aks-troubleshoot.md
     - name: Control plane configuration validation errors
       href: control-plane-validation-errors.md
@@ -157,11 +157,15 @@
     - name: KubeAPIServer unreachable error
       href: kube-api-server-unreachable.md
     - name: Can't see VM SKUs on Azure portal
-      href: tsg-check-vm-sku.md
+      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: Azure Advisor upgrade recommendation
+      href: azure-advisor-upgrade.md
+    - name: Issues after deleting storage volumes
+      href: delete-storage-volume.md
   - name: Reference
     items:
     - name: Azure CLI
diff --git a/AKS-Arc/aks-troubleshoot.md b/AKS-Arc/aks-troubleshoot.md
@@ -3,7 +3,7 @@ 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: 11/22/2024
+ms.date: 02/28/2025
 ms.author: sethm 
 ms.lastreviewed: 02/27/2024
 ms.reviewer: guanghu
@@ -12,22 +12,27 @@ ms.reviewer: guanghu
 
 # Troubleshoot common issues in AKS enabled by Azure Arc
 
-This article describes how to find solutions for issues you encounter when using AKS enabled by Azure Arc. Known issues and errors are organized by functional area. You can use the links provided in this article to find solutions and workarounds to resolve them.
+This section describes how to find solutions for issues you encounter when using AKS enabled by Azure Arc.
 
 ## Open a support request
 
-See the [Get support](/azure/aks/hybrid/help-support?tabs=aksee) article for information about how to use the Azure portal to get support or open a support request for AKS Arc.
+To open a support request, see the [Get support](/azure/aks/hybrid/help-support) article for information about how to use the Azure portal to get support or open a support request for AKS Arc.
 
-## Upgrade
+## Known issues
 
-### Azure Advisor upgrade recommendation
+The following sections describe known issues and workarounds for AKS enabled by Azure Arc:
 
-If you continually see an [Azure Advisor](/azure/advisor/) upgrade recommendation that says "Upgrade to the latest version of AKS enabled by Azure Arc," follow these steps to disable the recommendation:
-
-- Ensure that you update your Azure Local solution to the latest version. For more information, see [About updates for Azure Local, version 23H2](/azure-stack/hci/update/about-updates-23h2).
-- If you use any of the Azure SDKs, ensure that you're using the latest version of that SDK. You can find the Azure SDKs by searching for "HybridContainerService" on the [Azure SDK releases](https://azure.github.io/azure-sdk/) page.
+- [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)
 
 ## Next steps
 
-- [Troubleshoot K8sVersionValidation error](cluster-k8s-version.md)
-- [Use diagnostic checker](aks-arc-diagnostic-checker.md)
+[What is AKS enabled by Azure Arc?](aks-overview.md)
diff --git a/AKS-Arc/azure-advisor-upgrade.md b/AKS-Arc/azure-advisor-upgrade.md
@@ -0,0 +1,28 @@
+---
+title: Azure Advisor upgrade recommendation
+description: Learn how to disable Azure Advisor upgrade recommendation alerts.
+author: sethmanheim
+ms.author: sethm
+ms.topic: troubleshooting
+ms.date: 02/28/2025
+
+---
+
+# Azure Advisor upgrade recommendation
+
+This article describes how to disable recurring Azure Advisor upgrade recommendation alerts for AKS enabled by Azure Arc.
+
+## Symptoms
+
+You continually see an Azure Advisor upgrade recommendation that says **Upgrade to the latest version of AKS enabled by Azure Arc**.
+
+## Workaround
+
+Follow these steps to disable the recommendation:
+
+- Ensure that you update your Azure Local solution to the latest version. For more information, see [About updates for Azure Local, version 23H2](/azure-stack/hci/update/about-updates-23h2).
+- If you use any of the Azure SDKs, ensure that you're using the latest version of that SDK. You can find the Azure SDKs by searching for "HybridContainerService" on the [Azure SDK releases](https://azure.github.io/azure-sdk/) page.
+
+## Next steps
+
+[Troubleshoot issues in AKS enabled by Azure Arc](aks-troubleshoot.md)
diff --git a/AKS-Arc/check-vm-sku.md b/AKS-Arc/check-vm-sku.md
@@ -1,6 +1,6 @@
 ---
 title: Troubleshoot no VM sizes listed on Azure portal
-description: Learn how to troubleshoot no VM sizes listed on Azure portal when you create an AKS Arc cluster
+description: Learn how to troubleshoot no VM sizes listed on Azure portal when you create an AKS Arc cluster.
 ms.topic: troubleshooting
 author: sethmanheim
 ms.author: sethm
@@ -9,7 +9,7 @@ ms.reviewer: sumsmith
 
 ---
 
-# Troubleshoot no VM sizes listed on Azure portal when you create an AKS Arc cluster
+# No VM sizes listed on Azure portal when you create an AKS Arc cluster
 
 When you try to create an AKS Arc cluster from the Azure portal, you can see that there are no VM sizes listed. This can happen if the **skus/default** resource in Azure is not yet created, or was deleted for some reason. This scenario can happen in Azure Local releases 2408 or older, when the default resource was not created as a part of the Azure Local deployment.
 
diff --git a/AKS-Arc/control-plane-validation-errors.md b/AKS-Arc/control-plane-validation-errors.md
@@ -3,7 +3,7 @@ title: Control plane configuration validation errors
 description: Learn details about each control plane configuration validation error.
 author: sethmanheim
 ms.author: sethm
-ms.topic: concept-article
+ms.topic: troubleshooting
 ms.date: 02/26/2025
 
 ---
diff --git a/AKS-Arc/delete-storage-volume.md b/AKS-Arc/delete-storage-volume.md
@@ -0,0 +1,28 @@
+---
+title: AKS on Azure Local issues after deleting storage volumes
+description: Learn how to mitigate issues after deleting storage volumes.
+author: sethmanheim
+ms.author: sethm
+ms.topic: troubleshooting
+ms.date: 02/28/2025
+
+---
+
+# AKS on Azure Local issues after deleting storage volumes
+
+This article describes how to mitigate cluster issues if a storage volume is deleted.
+
+## Symptoms
+
+AKS Arc workload data is stored on Azure Local storage volumes, including the AKS Arc node disks and persistent volumes of data disks. If the storage volume is accidentally deleted, the AKS Arc cluster doesn't work properly, as its data is removed as well.
+
+## Workaround
+
+To manage storage volumes on Azure Local, follow these steps:
+
+- Ensure that you deleted all the storage path(s) that are created on that storage volume. Deleting storage paths raises an alert to indicate the workload that was stored on it. To delete the storage path, see [Delete a storage path](/azure/azure-local/manage/create-storage-path?view=azloc-24112&preserve-view=true&tabs=azurecli#delete-a-storage-path).
+- If you have an AKS Arc cluster that must be deleted, see [Delete the AKS Arc cluster](aks-create-clusters-cli.md#delete-the-cluster).
+
+## Next steps
+
+[Troubleshoot issues in AKS enabled by Azure Arc](aks-troubleshoot.md)
diff --git a/AKS-Arc/load-balancer-issues.md b/AKS-Arc/load-balancer-issues.md
@@ -3,7 +3,7 @@ title: Intermittent connectivity issues with MetalLB or Kubernetes services of t
 description: Learn how to mitigate connection issues with MetalLB or Kubernetes services of type Load Balancer.
 author: sethmanheim
 ms.author: sethm
-ms.topic: concept-article
+ms.topic: troubleshooting
 ms.date: 02/26/2025
 
 ---
