Skip to content

Commit 7bf8423

Browse files
authored
Sync release-local-disconnectednew with main
Sync release-local-disconnectednew with main
2 parents ea74b81 + 11c462b commit 7bf8423

13 files changed

+208
-156
lines changed

AKS-Arc/aks-edge-help-support.md

Lines changed: 11 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Get support for AKS Edge Essentials
33
description: Learn about how to get support and open a support request for AKS Edge Essentials.
44
author: sethmanheim
55
ms.topic: how-to
6-
ms.date: 04/07/2025
6+
ms.date: 07/21/2025
77
ms.author: sethm
88

99
# Intent: As an IT Pro, I want to find out what options are available to get help and support, such as creating a ticket.
@@ -14,49 +14,25 @@ ms.author: sethm
1414

1515
If you encounter an issue with AKS Edge Essentials, this article describes how to open a support request.
1616

17-
## Go to Support + troubleshooting in the Azure portal
17+
## Go to Support + Troubleshooting in the Azure portal
1818

1919
1. Sign in to the [Azure portal](https://portal.azure.com).
2020
1. Browse to the subscription you're using for AKS Edge Essentials. Select the subscription to open its dashboard.
21-
1. From the **Support + troubleshooting** category in the navigation menu in the left-hand pane, select **New Support Request**:
21+
1. From the **Help** menu in the left-hand navigation pane, select **Support + Troubleshooting**:
2222

23-
:::image type="content" source="media/help-support/new-support-request-sidebar.png" alt-text="Screenshot of the Azure portal Help and Support sidebar." lightbox="media/help-support/new-support-request-sidebar.png":::
23+
:::image type="content" source="media/help-support/help-left-menu.png" alt-text="Screenshot of the Azure portal Help and Support sidebar.":::
2424

25-
1. From the dropdown, select the **Technical** issue type:
25+
1. In the text box, briefly describe the issue type, then select **Go**:
2626

27-
:::image type="content" source="media/help-support/select-type.png" alt-text="Screenshot of issue type selection." lightbox="media/help-support/select-type.png":::
27+
:::image type="content" source="media/help-support/issue-help.png" alt-text="Screenshot of service type selection." lightbox="media/help-support/issue-help.png":::
2828

29-
1. Your subscription name should auto-populate in the **Subscription** field. If it doesn't, select it from the dropdown.
29+
1. If **AKS Edge Essentials** doesn't appear in the list of predefined services, select **None of the above**.
30+
1. Begin typing **Edge Essentials** in the **Search Options** box of the **Select a service** dropdown.
31+
1. Select **AKS Edge Essentials** from the dropdown list.
3032

31-
1. Select the **All services** button, then select the **Service type** dropdown. Begin typing **Edge** in the search box to locate the **AKS Edge Essentials** service in the **Compute** category.
33+
:::image type="content" source="media/help-support/aks-edge-new-request.png" alt-text="Screenshot of service selection." lightbox="media/help-support/aks-edge-new-request.png":::
3234

33-
:::image type="content" source="media/help-support/service-type-edge.png" alt-text="Screenshot showing service selection." lightbox="media/help-support/service-type-edge.png":::
34-
35-
1. Add a short description of your issue in the **Summary** field.
36-
37-
1. Select the appropriate **Problem type** from the dropdown menu for your issue (for example, **Setup and configuration**). Also, select a **Problem subtype** (for example, **Deployment**):
38-
39-
:::image type="content" source="media/help-support/problem-type-edge.png" alt-text="Screenshot of completed problem type form." lightbox="media/help-support/problem-type-edge.png":::
40-
41-
1. Select **Next**.
42-
43-
1. Review the proposed **Solutions** to determine if they address your issue.
44-
45-
1. If the solutions are not applicable, select **Return to support request** at the top of the page.
46-
47-
1. Select **Next**.
48-
49-
1. Fill in the problem details and description in the appropriate fields:
50-
51-
:::image type="content" source="media/help-support/service-request-details.png" alt-text="Screenshot showing details of service request." lightbox="media/help-support/service-request-details.png":::
52-
53-
1. Scroll down and fill in your preferred support method of contact:
54-
55-
:::image type="content" source="media/help-support/service-request-support-method.png" alt-text="Screenshot showing support method preferences." lightbox="media/help-support/service-request-support-method.png":::
56-
57-
1. Select **Next**. Review the information you submitted. If anything is incorrect, select **Previous** and correct it. When all looks correct, select **Create**.
58-
59-
:::image type="content" source="media/help-support/review-create-edge.png" alt-text="Screenshot of confirmation screen to create support request." lightbox="media/help-support/review-create-edge.png":::
35+
[!INCLUDE [help-support-portal](includes/help-support-portal.md)]
6036

6137
## Next steps
6238

AKS-Arc/aks-troubleshoot.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -3,10 +3,10 @@ title: Troubleshoot common issues in AKS enabled by Azure Arc
33
description: Learn about common issues and workarounds in AKS enabled by Arc.
44
ms.topic: how-to
55
author: sethmanheim
6-
ms.date: 06/27/2025
6+
ms.date: 07/17/2025
77
ms.author: sethm
8-
ms.lastreviewed: 04/01/2025
9-
ms.reviewer: abha
8+
ms.lastreviewed: 07/17/2025
9+
ms.reviewer: rcheeran
1010

1111
---
1212

@@ -24,10 +24,10 @@ The following sections describe known issues for AKS enabled by Azure Arc:
2424

2525
| AKS Arc CRUD operation | Issue | Fix status |
2626
|------------------------|-------|------------|
27-
| AKS cluster create | [Can't create AKS cluster or scale node pool because of issues with AKS Arc images](gallery-image-not-usable.md) | Partially fixed in 2503 release |
28-
| AKS steady state | [AKS Arc telemetry pod consumes too much memory and CPU](telemetry-pod-resources.md) | Active |
29-
| AKS steady state | [Disk space exhaustion on control plane VMs due to accumulation of kube-apiserver audit logs](kube-apiserver-log-overflow.md) | Active |
3027
| AKS cluster delete | [Deleted AKS Arc cluster still visible on Azure portal](deleted-cluster-visible.md) | Active |
28+
| AKS steady state | [AKS Arc telemetry pod consumes too much memory and CPU](telemetry-pod-resources.md) | Fixed in 2507 release |
29+
| AKS cluster create | [Can't create AKS cluster or scale node pool because of issues with AKS Arc images](gallery-image-not-usable.md) | Fixed in 2507 release |
30+
| AKS steady state | [Disk space exhaustion on control plane VMs due to accumulation of kube-apiserver audit logs](kube-apiserver-log-overflow.md) | Fixed in 2507 release |
3131
| AKS cluster upgrade | [AKS Arc cluster stuck in "Upgrading" state](cluster-upgrade-status.md) | Fixed in 2505 release |
3232
| AKS cluster delete | [Can't fully delete AKS Arc cluster with PodDisruptionBudget (PDB) resources](delete-cluster-pdb.md) | Fixed in 2503 release |
3333
| Azure portal | [Can't see VM SKUs on Azure portal](check-vm-sku.md) | Fixed in 2411 release |
@@ -43,7 +43,7 @@ The following sections describe known issues for AKS enabled by Azure Arc:
4343
| Create validation | [KubeAPIServer unreachable error](kube-api-server-unreachable.md) |
4444
| Network configuration issues | [Use diagnostic checker](aks-arc-diagnostic-checker.md) |
4545
| Kubernetes steady state | [Resolve issues due to out-of-band deletion of storage volumes](delete-storage-volume.md) |
46-
| Kubernetes steady state | [Repeated Entra authentication prompts when running kubectl with Kubernetes RBAC](entra-prompts.md) |
46+
| Kubernetes steady state | [Repeated Entra authentication prompts when running kubectl with Kubernetes RBAC](entra-prompts.md) |
4747
| Release validation | [Azure Advisor upgrade recommendation message](azure-advisor-upgrade.md) |
4848
| Network validation | [Network validation error due to .local domain](network-validation-error-local.md) |
4949
| Network validation | [Troubleshoot BGP with FRR in AKS Arc environments](connectivity-troubleshoot.md) |

AKS-Arc/gallery-image-not-usable.md

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,8 @@ description: Learn about a known issue with Kubernetes cluster create or nodepoo
44
ms.topic: troubleshooting
55
author: sethmanheim
66
ms.author: sethm
7-
ms.date: 04/01/2025
8-
ms.reviewer: abha
7+
ms.date: 07/17/2025
8+
ms.reviewer: rcheeran
99

1010
---
1111

@@ -43,9 +43,10 @@ When you run `az aksarc get-versions`, you see the following errors:
4343

4444
## Mitigation
4545

46-
- This issue was fixed in [AKS on Azure Local, version 2503](aks-whats-new-23h2.md#release-2503).
47-
- Upgrade your Azure Local deployment to the 2503 build.
48-
- Once updated, confirm that the images have been downloaded successfully by running the `az aksarc get-versions` command.
46+
This issue was fixed in [AKS on Azure Local, version 2507](/azure/azure-local/whats-new?view=azloc-2507&preserve-view=true#features-and-improvements-in-2507). Upgrade your Azure Local deployment to the 2507 build.
47+
48+
- Upgrade your Azure Local deployment to the 2507 build.
49+
- Once updated, confirm that the images were downloaded successfully by running the `az aksarc get-versions` command.
4950
- For new AKS clusters: new AKS clusters should now be created successfully.
5051
- For scaling existing AKS clusters: scaling existing AKS clusters continues to encounter issues. Please file a support case.
5152

AKS-Arc/help-support.md

Lines changed: 1 addition & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -35,57 +35,7 @@ If you encounter an issue with AKS on Azure Local, this article describes how to
3535

3636
:::image type="content" source="media/help-support/new-request.png" alt-text="Screenshot of service selection." lightbox="media/help-support/new-request.png":::
3737

38-
1. Select **Next**.
39-
1. Your subscription name should auto-populate in the **Subscription** field. If it doesn't, select it from the dropdown. Then select **Next**.
40-
1. Select one of the predefined issues, or select **None of the above** if your issue doesn't relate to a specific predefined issue. Then select **Next**:
41-
42-
:::image type="content" source="media/help-support/issue-select.png" alt-text="Screenshot of issue type selection." lightbox="media/help-support/issue-select.png":::
43-
44-
If you select **None of the above**, you're prompted to select a problem type from a dropdown menu. From the dropdown, select a problem type.
45-
46-
:::image type="content" source="media/help-support/issues-none.png" alt-text="Screenshot of portal showing none of the above issues selected." lightbox="media/help-support/issues-none.png":::
47-
48-
1. Select **Next**.
49-
50-
1. Review the proposed solutions to determine if they address your issue:
51-
52-
:::image type="content" source="media/help-support/solutions-page.png" alt-text="Screenshot of proposed solutions." lightbox="media/help-support/solutions-page.png":::
53-
54-
1. If you made a mistake or want to choose a different problem type, select **Start again** at the top of the page. If the issues and solutions are not applicable, select **Create a support request** at the top of the page.
55-
56-
1. Select **Next**.
57-
1. From the dropdown, select the **Technical** issue type:
58-
59-
:::image type="content" source="media/help-support/select-type.png" alt-text="Screenshot of problem type selection." lightbox="media/help-support/select-type.png":::
60-
61-
1. Your subscription name should auto-populate in the **Subscription** field. If it doesn't, select it from the dropdown.
62-
1. Your service name should auto-populate in the **Service** field. If it doesn't, select it from the dropdown. The **Summary**, **Problem type**, and **Problem subtype** fields should also auto-populate based on your previous selections. If they don't, select the appropriate values from the dropdown menus.
63-
64-
:::image type="content" source="media/help-support/service-type.png" alt-text="Screenshot showing service selection." lightbox="media/help-support/service-type.png":::
65-
66-
1. Add a short description of your issue in the **Summary** field.
67-
68-
1. Select the appropriate **Problem type** from the dropdown menu for your issue (for example, **Setup, deployment, and configuration**).
69-
70-
1. Select **Next**.
71-
72-
1. Review the proposed **Solutions** to determine if they address your issue:
73-
74-
:::image type="content" source="media/help-support/solutions-page.png" alt-text="Screenshot of proposed solutions." lightbox="media/help-support/solutions-page.png":::
75-
76-
1. If the solutions are not applicable, select **Return to support request** at the top of the page.
77-
78-
1. Select **Next**.
79-
80-
1. Fill in the problem details and description in the appropriate fields:
81-
82-
:::image type="content" source="media/help-support/service-request-details.png" alt-text="Screenshot showing details of service request." lightbox="media/help-support/service-request-details.png":::
83-
84-
1. Scroll down and fill in your preferred support method of contact:
85-
86-
:::image type="content" source="media/help-support/service-request-support-method.png" alt-text="Screenshot showing support method preferences." lightbox="media/help-support/service-request-support-method.png":::
87-
88-
1. Select **Next**. Review the information you submitted. If anything is incorrect, select **Previous** and correct it. When all looks correct, select **Create**.
38+
[!INCLUDE [help-support-portal](includes/help-support-portal.md)]
8939

9040
## Next steps
9141

Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
---
2+
author: sethmanheim
3+
ms.author: sethm
4+
ms.topic: include
5+
ms.date: 07/21/2025
6+
ms.reviewer: sumsmith
7+
ms.lastreviewed: 07/21/2025
8+
9+
---
10+
## Select issue type and solution
11+
12+
1. Select **Next**.
13+
1. Your subscription name should auto-populate in the **Subscription** field. If it doesn't, select it from the dropdown. Then select **Next**.
14+
1. Select one of the predefined issues, or select **None of the above** if your issue doesn't relate to a specific predefined issue. Then select **Next**:
15+
16+
:::image type="content" source="../media/help-support/issue-select.png" alt-text="Screenshot of issue type selection." lightbox="../media/help-support/issue-select.png":::
17+
18+
If you select **None of the above**, you're prompted to select a problem type from a dropdown menu. From the dropdown, select a problem type.
19+
20+
:::image type="content" source="../media/help-support/issues-none.png" alt-text="Screenshot of portal showing none of the above issues selected." lightbox="../media/help-support/issues-none.png":::
21+
22+
1. Select **Next**.
23+
24+
1. Review the proposed solutions to determine if they address your issue:
25+
26+
:::image type="content" source="../media/help-support/solutions-page.png" alt-text="Screenshot of proposed solutions." lightbox="../media/help-support/solutions-page.png":::
27+
28+
1. If you made a mistake or want to choose a different problem type, select **Start again** at the top of the page. If the issues and solutions are not applicable, select **Create a support request** at the top of the page.
29+
30+
1. Select **Next**.
31+
1. From the dropdown, select the **Technical** issue type:
32+
33+
:::image type="content" source="../media/help-support/select-type.png" alt-text="Screenshot of problem type selection." lightbox="../media/help-support/select-type.png":::
34+
35+
1. Your subscription name should auto-populate in the **Subscription** field. If it doesn't, select it from the dropdown.
36+
1. Your service name should auto-populate in the **Service** field. If it doesn't, select it from the dropdown. The **Summary**, **Problem type**, and **Problem subtype** fields should also auto-populate based on your previous selections. If they don't, select the appropriate values from the dropdown menus.
37+
38+
:::image type="content" source="../media/help-support/service-type.png" alt-text="Screenshot showing service selection." lightbox="../media/help-support/service-type.png":::
39+
40+
1. Add a short description of your issue in the **Summary** field.
41+
42+
1. Select the appropriate **Problem type** from the dropdown menu for your issue (for example, **Setup, deployment, and configuration**).
43+
44+
1. Select **Next**.
45+
46+
1. Review the proposed **Solutions** to determine if they address your issue:
47+
48+
:::image type="content" source="../media/help-support/solutions-page.png" alt-text="Screenshot of proposed solutions." lightbox="../media/help-support/solutions-page.png":::
49+
50+
1. If the solutions are not applicable, select **Return to support request** at the top of the page.
51+
52+
1. Select **Next**.
53+
54+
1. Fill in the problem details and description in the appropriate fields:
55+
56+
:::image type="content" source="../media/help-support/service-request-details.png" alt-text="Screenshot showing details of service request." lightbox="../media/help-support/service-request-details.png":::
57+
58+
1. Scroll down and fill in your preferred support method of contact:
59+
60+
:::image type="content" source="../media/help-support/service-request-support-method.png" alt-text="Screenshot showing support method preferences." lightbox="../media/help-support/service-request-support-method.png":::
61+
62+
1. Select **Next**. Review the information you submitted. If anything is incorrect, select **Previous** and correct it. When all looks correct, select **Create**.

AKS-Arc/kube-apiserver-log-overflow.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn about a known issue with disk space exhaustion on the control
44
ms.topic: troubleshooting
55
author: sethmanheim
66
ms.author: sethm
7-
ms.date: 04/01/2025
7+
ms.date: 07/17/2025
88
ms.reviewer: abha
99

1010
---
@@ -44,6 +44,10 @@ The issue occurs because the `--audit-log-maxbackup` value is set to 0. This set
4444

4545
## Mitigation
4646

47+
This issue was fixed in [AKS on Azure Local, version 2507](/azure/azure-local/whats-new?view=azloc-2507&preserve-view=true#features-and-improvements-in-2507). Upgrade your Azure Local deployment to the 2507 build.
48+
49+
### Workaround for Azure Local versions 2503 or 2504
50+
4751
To resolve the issue temporarily, you must manually clean up the old audit logs. Follow these steps:
4852

4953
- SSH into the control plane virtual machine (VM) of your AKS Arc cluster.
22 KB
Loading

0 commit comments

Comments
 (0)