Skip to content

Commit 1f6d0fa

Browse files
Enhance troubleshooting documentation with new errors
1 parent 933f80e commit 1f6d0fa

File tree

1 file changed

+25
-0
lines changed

1 file changed

+25
-0
lines changed

docs/TroubleShootingSteps.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -465,6 +465,31 @@ For more details, refer to [Azure Storage redundancy documentation](https://lear
465465
- To avoid the DeploymentNotFound error, Do not change the location when redeploying a deleted RG, or Use new names for the RG and environment during redeployment.
466466
</details>
467467
468+
<details><summary><b>DeploymentCanceled(user.canceled)</b></summary>
469+
470+
- Indicates the deployment was manually canceled by the user (Portal, CLI, or pipeline).
471+
472+
- Check deployment history and logs to confirm who/when it was canceled.
473+
474+
- If accidental, retry the deployment.
475+
476+
- For pipelines, ensure no automation or timeout is triggering cancellation.
477+
478+
- Use deployment locks or retry logic to prevent accidental cancellations.
479+
480+
</details>
481+
482+
<details><summary><b>ResourceGroupDeletionTimeout</b></summary>
483+
484+
- Some resources in the resource group may be stuck deleting or have dependencies; check RG resources and status.
485+
486+
- Ensure no resource locks or Azure Policies are blocking deletion.
487+
488+
- Retry deletion via CLI/PowerShell `(az group delete --name <RG_NAME> --yes --no-wait)`.
489+
490+
- Check Activity Log to identify failing resources; escalate to Azure Support if deletion is stuck.
491+
492+
</details>
468493
469494
💡 Note: If you encounter any other issues, you can refer to the [Common Deployment Errors](https://learn.microsoft.com/en-us/azure/azure-resource-manager/troubleshooting/common-deployment-errors) documentation.
470495
If the problem persists, you can also raise an bug in our [MACAE Github Issues](https://github.com/microsoft/Multi-Agent-Custom-Automation-Engine-Solution-Accelerator/issues) for further support.

0 commit comments

Comments
 (0)