Skip to content

Commit 350f883

Browse files
Merge pull request #3718 from MicrosoftDocs/main638868998495537364sync_temp
For protected branch, push strategy should use PR and merge to target branch method to work around git push error
2 parents 5053137 + 46f8ba3 commit 350f883

14 files changed

+62
-31
lines changed

AKS-Arc/TOC.yml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -159,12 +159,14 @@
159159
items:
160160
- name: Troubleshoot and known issues
161161
href: aks-troubleshoot.md
162+
- name: Get support
163+
href: help-support.md
164+
- name: Use diagnostic checker
165+
href: aks-arc-diagnostic-checker.md
162166
- name: Control plane configuration validation errors
163167
href: control-plane-validation-errors.md
164168
- name: K8sVersionValidation error
165169
href: cluster-k8s-version.md
166-
- name: Use diagnostic checker
167-
href: aks-arc-diagnostic-checker.md
168170
- name: KubeAPIServer unreachable error
169171
href: kube-api-server-unreachable.md
170172
- name: Can't create/scale AKS cluster due to image issues
@@ -607,8 +609,6 @@
607609
href: known-issues.yml
608610
- name: Support policies
609611
href: support-policies.md
610-
- name: Get support
611-
href: help-support.md
612612
- name: File bugs
613613
href: https://aka.ms/AKS-hybrid-issues
614614
- name: Release notes

AKS-Arc/aks-arc-diagnostic-checker.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn how to diagnose common causes for failures in AKS Arc.
44
ms.topic: troubleshooting
55
author: sethmanheim
66
ms.author: sethm
7-
ms.date: 01/30/2025
7+
ms.date: 06/27/2025
88
ms.reviewer: abha
99

1010
#Customer intent: As an AKS user, I want to use the diagnostic checker to run diagnostic checks on my AKS cluster to find out common causes for AKS cluster create failure.
@@ -13,14 +13,14 @@ ms.reviewer: abha
1313

1414
# Use the diagnostic checker to diagnose and fix environment issues for AKS cluster creation failure (preview)
1515

16-
It can be difficult to identify environment-related issues, such as networking configurations, that can result in an AKS cluster creation failure. The diagnostic checker is a PowerShell-based tool that can help you identify AKS cluster creation failures due to potential issues in the environment.
16+
It can be difficult to identify environment-related issues, such as networking configuration, that can result in an AKS cluster creation failure. The diagnostic checker is a PowerShell tool that can help you identify AKS cluster creation failures due to potential issues in the environment.
1717

1818
> [!NOTE]
19-
> You can only use the diagnostic checker tool if an AKS cluster was created, but is in a failed state. You can't use the tool if you don't see an AKS cluster on the Azure portal. If the AKS cluster creation fails before an Azure Resource Manager resource is created, [file a support request](aks-troubleshoot.md#open-a-support-request).
19+
> You can only use the diagnostic checker tool if an AKS cluster was created, but is in a failed state. You can't use the tool if you don't see an AKS cluster on the Azure portal. If the AKS cluster creation fails before an Azure Resource Manager resource is created, [file a support request](help-support.md).
2020
2121
## Before you begin
2222

23-
Before you begin, make sure you have the following prerequisites. If you don't meet the requirements for running the diagnostic checker tool, [file a support request](aks-troubleshoot.md#open-a-support-request):
23+
Before you begin, make sure you have the following prerequisites. If you don't meet the requirements for running the diagnostic checker tool, [file a support request](help-support.md):
2424

2525
- Direct access to the Azure Local cluster where you created the AKS cluster. This access can be through remote desktop (RDP), or you can also sign in to one of the Azure Local physical nodes.
2626
- Review the [networking concepts for creating an AKS cluster](aks-hci-network-system-requirements.md) and the [AKS cluster architecture](cluster-architecture.md).
@@ -43,17 +43,17 @@ VMName IPAddresses
4343
<cluster-name>-XXXXXX-control-plane-XXXXXX {172.16.0.10, 172.16.0.4, fe80::ec:d3ff:fea0:1}
4444
```
4545

46-
If you don't see a control plane VM as shown in the previous output, [file a support request](aks-troubleshoot.md#open-a-support-request).
46+
If you don't see a control plane VM as shown in the previous output, [file a support request](help-support.md).
4747

4848
If you see a control plane VM, and it has:
4949

50-
- 0 IPv4 addresses: file a [support request](aks-troubleshoot.md#open-a-support-request).
50+
- 0 IPv4 addresses: file a [support request](help-support.md).
5151
- 1 IP address: use the IPv4 address as the input for `vmIP` parameter.
5252
- 2 IP addresses: use any one of the IPv4 address as an input for `vmIP` parameter in the diagnostic checker.
5353

5454
## Run the diagnostic checker script
5555

56-
Copy the following PowerShell script `run_diagnostic.ps1` into any one node of your Azure Local cluster:
56+
Copy the following PowerShell script named `run_diagnostic.ps1` into any one node of your Azure Local cluster:
5757

5858
```powershell
5959
<#
@@ -288,4 +288,4 @@ The following table provides a summary of each test performed by the script, inc
288288

289289
## Next steps
290290

291-
If the problem persists, collect [AKS cluster logs](get-on-demand-logs.md) before you [create a support request](aks-troubleshoot.md#open-a-support-request).
291+
If the problem persists, collect [AKS cluster logs](get-on-demand-logs.md) before you [create a support request](help-support.md).

AKS-Arc/help-support.md

Lines changed: 44 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,44 +1,71 @@
11
---
2-
title: Get support for AKS on Windows Server
3-
description: Learn about how to get support and open a support request for AKS on Windows Server.
2+
title: Get support for AKS on Azure Local
3+
description: Learn about how to get support and open a support request for AKS on Azure Local.
4+
author: sethmanheim
45
ms.topic: how-to
5-
ms.date: 04/03/2025
6+
ms.date: 06/30/2025
67
ms.custom: fasttrack-edit
78
ms.author: sethm
8-
ms.lastreviewed: 1/14/2022
9-
author: sethmanheim
9+
ms.reviewer: abha
10+
ms.lastreviewed: 06/30/2025
1011

1112
# Intent: As an IT Pro, I want to find out what options are available to get help and support, such as creating a ticket.
1213
# Keyword: AKS support AKS help support requests
1314
---
1415

15-
# Get support for AKS on Windows Server
16+
# Get support for AKS on Azure Local
1617

17-
If you encounter an issue with AKS on Windows Server, this article describes how to open a support request.
18+
If you encounter an issue with AKS on Azure Local, this article describes how to open a support request.
1819

19-
## Go to Support + troubleshooting in the Azure portal
20+
## Go to Support + Troubleshooting in the Azure portal
2021

2122
1. Sign in to the [Azure portal](https://portal.azure.com).
22-
1. Browse to the subscription you're using for Azure Kubernetes Services on Windows Server. Select the subscription to open its dashboard.
23-
1. From the **Support + troubleshooting** category in the navigation menu in the left-hand pane, select **New Support Request**:
23+
1. Browse to the subscription you're using for AKS on Azure Local. Select the subscription to open its dashboard.
24+
1. From the **Help** menu in the left-hand navigation pane, select **Support + Troubleshooting**:
25+
26+
:::image type="content" source="media/help-support/help-left-menu.png" alt-text="Screenshot of the Azure portal Help and Support sidebar.":::
27+
28+
1. In the text box, briefly describe the issue type, then select **Go**:
29+
30+
:::image type="content" source="media/help-support/issue-help.png" alt-text="Screenshot of service type selection." lightbox="media/help-support/issue-help.png":::
31+
32+
1. If **Azure Kubernetes Service on Azure Local** doesn't appear in the list of predefined services, select **None of the above**.
33+
1. Begin typing **Kubernetes** in the **Search Options** box of the **Select a service** dropdown.
34+
1. Select **Azure Kubernetes Service on Azure Local** from the dropdown list.
35+
36+
:::image type="content" source="media/help-support/new-request.png" alt-text="Screenshot of service selection." lightbox="media/help-support/new-request.png":::
37+
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.
2445

25-
:::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":::
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":::
2647

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**.
2757
1. From the dropdown, select the **Technical** issue type:
2858

29-
:::image type="content" source="media/help-support/select-type.png" alt-text="Screenshot of issue type selection." lightbox="media/help-support/select-type.png":::
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":::
3060

3161
1. Your subscription name should auto-populate in the **Subscription** field. If it doesn't, select it from the dropdown.
32-
33-
1. Select the **All services** button, then select the **Service type** dropdown. Begin typing **Azure Kubernetes Service** in the search box to locate the **Azure Kubernetes Service on Windows Server** service in the **Compute** category.
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.
3463

3564
:::image type="content" source="media/help-support/service-type.png" alt-text="Screenshot showing service selection." lightbox="media/help-support/service-type.png":::
3665

3766
1. Add a short description of your issue in the **Summary** field.
3867

39-
1. Select the appropriate **Problem type** from the dropdown menu for your issue (for example, **Kubernetes**):
40-
41-
:::image type="content" source="media/help-support/problem-type.png" alt-text="Screenshot of completed problem type form." lightbox="media/help-support/problem-type.png":::
68+
1. Select the appropriate **Problem type** from the dropdown menu for your issue (for example, **Setup, deployment, and configuration**).
4269

4370
1. Select **Next**.
4471

@@ -60,8 +87,6 @@ If you encounter an issue with AKS on Windows Server, this article describes how
6087

6188
1. Select **Next**. Review the information you submitted. If anything is incorrect, select **Previous** and correct it. When all looks correct, select **Create**.
6289

63-
:::image type="content" source="media/help-support/review-create.png" alt-text="Screenshot of confirmation screen to create support request." lightbox="media/help-support/review-create.png":::
64-
6590
## Next steps
6691

6792
- [Review support policies for AKS Arc](support-policies.md)
4.1 KB
Loading
16.2 KB
Loading
40.6 KB
Loading
28.5 KB
Loading
28.3 KB
Loading
-118 KB
Binary file not shown.
-140 KB
Binary file not shown.

0 commit comments

Comments
 (0)