Skip to content

Conversation

NirajC-Microsoft
Copy link
Contributor

@NirajC-Microsoft NirajC-Microsoft commented Aug 26, 2025

This pull request adds a comprehensive troubleshooting guide for Azure resource deployment errors and updates the deployment documentation to reference this new resource. The main goal is to help users quickly resolve common deployment issues by providing error explanations and step-by-step solutions.

Documentation Enhancements

  • Added a "Troubleshooting" section to the deployment guide, directing users to a new troubleshooting document for detailed error resolutions.

New Troubleshooting Resource

  • Created docs/TroubleShootingSteps.md, which lists frequent Azure deployment error codes, their causes, and actionable steps to resolve them. This includes examples, command-line instructions, and links to relevant Azure documentation for further reference.

User Guidance Improvements

  • The troubleshooting guide covers errors related to subscription, quotas, resource naming, region availability, provisioning, and more, helping users unblock deployments efficiently.

Support and Escalation

  • Provided links to official Azure documentation and the project's GitHub issues page for users who need additional help or want to report bugs.## Purpose
  • ...

Does this introduce a breaking change?

  • Yes
  • No

Golden Path Validation

  • I have tested the primary workflows (the "golden path") to ensure they function correctly without errors.

Deployment Validation

  • I have validated the deployment process successfully and all services are running as expected with this change.

What to Check

Verify that the following are valid

  • ...

Other Information

Priyanka-Microsoft and others added 30 commits July 25, 2025 13:41
…tingpr

fix: model deployment when reusing existing foundry
* fixed opent telemetry issue CustomDomainInUse, FlagMustBeSetForRestore (#618) (#619)

Co-authored-by: VishalS-Microsoft <v-vishshinde@microsoft.com>

* directory update in dependabot template (#634)

---------

Co-authored-by: NirajC-Microsoft <v-nirajcha@microsoft.com>
Co-authored-by: VishalS-Microsoft <v-vishshinde@microsoft.com>
Co-authored-by: Prajwal-Microsoft <v-dcprajwal@microsoft.com>
* Agent deletion handled successfully

* use get azure credentials

* remove unused import

---------

Co-authored-by: Shreyas-Microsoft <v-swaikar@microsft.com>
feat: Add required environment variables for local debugging in .env generated by azd up
fix: Sample data processing script fails when using cross-subscription existing AI project resource ID
chore: Down merge from main to dev
Prasanjeet-Microsoft and others added 4 commits August 18, 2025 13:05
Removed Commented-out code

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
`project_client` is always initialized before thread creation, so `if thread:` is sufficient.
* Added Troubleshoot.md files for BYOC-Client Advisor

* fixed Check Markdown Broken Links

* updated troubleshotingsteps file

* Changed MACAE Github issues link with BYOC issue link

---------

Co-authored-by: NirajC-Microsoft <v-nirajcha@microsoft.com>
Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This pull request adds comprehensive troubleshooting documentation to help users resolve common Azure deployment errors. The main goal is to provide quick reference guides with error explanations and step-by-step solutions for deployment issues.

  • Added a new troubleshooting document with 20+ common Azure error codes and their resolutions
  • Updated the deployment guide to reference the new troubleshooting resource
  • Provided detailed command-line examples and links to Azure documentation for further support

Reviewed Changes

Copilot reviewed 2 out of 4 changed files in this pull request and generated 5 comments.

File Description
docs/TroubleShootingSteps.md New comprehensive troubleshooting guide with Azure error codes, causes, and step-by-step solutions
docs/DeploymentGuide.md Added troubleshooting section with reference to the new troubleshooting document

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
…teps.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
…entifier for better formatting and readability.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
…y, and the total value matches the asset value displayed in the left panel. (#651)
@Roopan-Microsoft Roopan-Microsoft changed the title docs: Troubleshooting document Dev to Main changes chore: Troubleshooting document and bug fix Dev to Main changes Sep 1, 2025
@Roopan-Microsoft Roopan-Microsoft merged commit a5e80c8 into main Sep 1, 2025
19 checks passed
Copy link

github-actions bot commented Sep 8, 2025

🎉 This PR is included in version 1.8.2 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

Copy link

🎉 This PR is included in version 1.9.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.