Merge pull request #3756 from MicrosoftDocs/main638889050898530646sync_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

@@ -159,12 +159,18 @@
     items:
     - name: Troubleshoot and known issues
       href: aks-troubleshoot.md
-    - name: AKS on Azure Local support policy
-      href: aks-on-azure-local-support-policy.md
     - name: Get support
-      href: help-support.md
-    - name: Use diagnostic checker
-      href: aks-arc-diagnostic-checker.md
+      items:
+      - name: AKS on Azure Local support policy
+        href: aks-on-azure-local-support-policy.md
+      - name: Get support
+        href: help-support.md
+      - name: Use the support remediation tool
+        href: support-module.md
+      - name: Use diagnostic checker
+        href: aks-arc-diagnostic-checker.md
+    - name: Storage provisioning issue in cluster and node pool creation
+      href: storage-provision-issue.md
     - name: Control plane configuration validation errors
       href: control-plane-validation-errors.md
     - name: K8sVersionValidation error

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: 07/17/2025
+ms.date: 07/23/2025
 ms.author: sethm 
-ms.lastreviewed: 07/17/2025
+ms.lastreviewed: 07/23/2025
 ms.reviewer: rcheeran
 
 ---
@@ -24,6 +24,7 @@ The following sections describe known issues for AKS enabled by Azure Arc:
 
 | AKS Arc CRUD operation | Issue | Fix status |
 |------------------------|-------|------------|
+| AKS steady state       | [Storage provisioning issue impacting cluster and node pool creation](storage-provision-issue.md)|Active|
 | AKS cluster delete     | [Deleted AKS Arc cluster still visible on Azure portal](deleted-cluster-visible.md) | Active |
 | AKS steady state       | [AKS Arc telemetry pod consumes too much memory and CPU](telemetry-pod-resources.md) | Fixed in 2507 release  |
 | 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 |

AKS-Arc/storage-provision-issue.md

@@ -0,0 +1,60 @@
+---
+title: Troubleshoot issue in which storage provisioning fails
+description: Learn how to troubleshoot and mitigate an issue that occurs when storage provisioning fails.
+ms.topic: troubleshooting
+author: rcheeran
+ms.author: rcheeran
+ms.date: 07/23/2025
+ms.reviewer: rcheeran
+ms.lastreviewed: 07/23/2025
+
+---
+
+# Troubleshoot storage provisioning issue during cluster and node pool creation
+
+This article describes an issue in which new AKS Arc nodes are created on a single storage path/volume of the Azure Local cluster, breaking the expected round-robin distribution among volumes. Over time, this might cause insufficient disk space on that path, potentially resulting in deployment failures.
+
+## Symptoms
+
+During cluster creation or node pool creation and scale operations, you might see the following error message:
+
+```output
+The system failed to create <Azure resource name>: There is not enough space on the disk.
+```
+
+## Cause
+
+The issue is caused by a recent regression introduced in Azure Local, version 2506.
+
+## Mitigation
+
+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). However, this mitigation works only when you create new Azure Local instances with version 2507. Upgrading from Azure Local versions 2506 to 2507 does not resolve the issue.
+
+### Workaround for Azure Local version 2506
+
+This issue only affects clusters in Azure Local version 2506. Install the [support module](support-module.md) and run the commands provided in this module.
+
+First, run the following command to check for known issues in your AKS Arc environment:
+
+```powershell
+Test-SupportAksArcKnownIssues
+```
+
+Then, run the following command to fix this known issue on your deployment. This command finds all available fixes for the current version, and installs those fixes:
+
+```powershell
+Invoke-SupportAksArcRemediation
+```
+
+## Verification
+
+Once the fix is done, you should be able to create your clusters and node pools. If you still encounter issues, please [reach out to Microsoft Support](#contact-microsoft-support).  
+
+## Contact Microsoft Support
+
+If the problem persists, collect the [AKS cluster logs](get-on-demand-logs.md) before you [create a support request](help-support.md).
+
+## Next steps
+
+- [Use the diagnostic checker tool to identify common environment issues](aks-arc-diagnostic-checker.md)
+- [Review AKS on Azure Local architecture](cluster-architecture.md)

AKS-Arc/support-module.md

@@ -0,0 +1,103 @@
+---
+title: Support.AksArc diagnostic and remediation tool
+description: Learn how to run commands in the Support.AksArc PowerShell module to diagnose and remediate issues in AKS Arc environments.
+ms.topic: troubleshooting
+author: sethmanheim
+ms.author: sethm
+ms.date: 07/22/2025
+ms.reviewer: sumsmith
+ms.lastreviewed: 07/22/2025
+
+---
+
+# Support.AksArc module
+
+The [**Support.AksArc**](https://www.powershellgallery.com/packages/Support.AksArc) PowerShell module provides diagnostic and remediation capabilities for AKS Arc environments. Before you open a support request, you can run the specified commands in this module to help diagnose and potentially resolve issues.
+
+You should run the commands if you experience any of the following symptoms:
+
+- Solution upgrade fails in MOC binaries state.
+- Solution upgrade fails in Arc Resource Bridge stage.
+- MOC service doesn't stay online.
+- Arc Resource Bridge is offline.
+
+## Commands
+
+The **Support.AksArc** module contains the following PowerShell commands:
+
+- `Test-SupportAksArcKnownIssues`: tests for known issues.
+- `Invoke-SupportAksArcRemediation`: fixes identified issues.
+
+## Installation
+
+To install the module, run the following commands:
+
+```powershell
+Install-Module -Name Support.AksArc
+Import-Module Support.AksArc
+```
+
+## Usage
+
+> [!NOTE]
+> Make sure to run these PowerShell commands locally, not in a PowerShell remote session.
+
+The following command performs a health check:
+
+```powershell
+Test-SupportAksArcKnownIssues
+```
+
+This command performs auto-remediation (tests and fixes all issues):
+
+```powershell
+Invoke-SupportAksArcRemediation
+```
+
+## Example output
+
+The following example output from the `Test-SupportAksArcKnownIssues` command shows the results of a failed test::
+
+```output
+Test Name                                                  Status Message
+---------                                                  --------------
+Validate Failover Cluster Service Responsiveness           Passed Failover Cluster service is responsive.
+Validate Missing MOC Cloud Agents                          Passed No missing MOC cloud agents found.
+Validate MOC Cloud Agent Running                           Passed MOC Cloud Agent is running
+Validate Missing MOC Node Agents                           Passed All MOC nodes have the Node Agent service installed and healthy.
+Validate Missing MOC Host Agents                           Passed All nodes have MOC host agents installed and healthy
+Validate MOC is on Latest Patch Version                    Failed MOC is not on the latest patch version. Current: 1.15.5.10626, Latest: 1.15.7.10719
+Validate Expired Certificates                              Passed No expired certificates found
+Validate MOC Nodes Not Active                              Passed All MOC nodes are in the 'Active' state
+Validate Multiple MOC Cloud Agent Instances                Passed No multiple instances of MOC Cloud Agent found
+Validate Windows Event Log Running                         Passed Windows Event Log is running
+Validate Gallery Image Stuck In Deleting                   Passed No gallery images are stuck in deleting state
+Validate Virtual Machine Stuck In Pending                  Passed No virtual machines are stuck in pending state
+Validate Virtual Machine Management Service Responsiveness Passed Virtual Machine Management service is responsive
+```
+
+The following example output shows a successful result for all tests:
+
+```output
+Test Name                                                  Status Message
+---------                                                  --------------
+Validate Failover Cluster Service Responsiveness           Passed  Failover Cluster service is responsive.
+Validate Missing MOC Cloud Agents                          Passed  No missing MOC cloud agents found.
+Validate MOC Cloud Agent Running                           Passed  MOC Cloud Agent is running
+Validate Missing MOC Node Agents                           Passed  All MOC nodes have the Node Agent service installed and healthy.
+Validate Missing MOC Host Agents                           Passed  All nodes have MOC host agents installed and healthy.
+Validate MOC is on Latest Patch Version                    Passed  MOC is on the latest patch version.
+Validate Expired Certificates                              Passed  No expired certificates found.
+Validate MOC Nodes Not Active                              Passed  All NMC nodes are in the 'Active' state.
+Validate NMC Nodes Sync with Cluster Nodes                 Passed  All NMC nodes are in sync with cluster nodes.
+Validate Multiple NMC Cloud Agent Instances                Passed  No multiple instances of NMC Cloud Agent found.
+Validate NMC Powershell Not Stuck in Updating              Passed  NMC Powershell is not stuck in updating state.
+Validate Windows Event Log Running                         Passed  Windows Event Log is running
+Validate Gallery Image Stuck In Deleting                   Passed  No gallery images are stuck in deleting state.
+Validate Virtual Machine Stuck In Pending                  Passed  No virtual machines are stuck in pending state.
+Validate Virtual Machine Management Service Responsiveness Passed  Virtual Machine Management service is responsive.
+```
+
+## Next steps
+
+[Use the diagnostic checker tool to identify common environment issues](aks-arc-diagnostic-checker.md)

adaptive-cloud/index.yml

@@ -21,7 +21,7 @@ highlightedContent:
     # Card
     - title: "Ignite 2024: Session catalog"
       itemType: video
-      url: https://ignite.microsoft.com/sessions      
+      url: https://ignite.microsoft.com/archives      
     - title: "Build 2024: post-event sessions"
       itemType: video
       url: https://build.microsoft.com/en-US/home
@@ -457,4 +457,4 @@ additionalContent:
         - url: https://azure.github.io/Vision-AI-DevKit-Pages/
           text: Vision AI Developer Kit   
         - url: /visualstudio/azure/
-          text: Visual Studio Azure development
+          text: Visual Studio Azure development