Modernize-your-code-solution-accelerator icon indicating copy to clipboard operation
Modernize-your-code-solution-accelerator copied to clipboard

docs: Added Troubleshoot steps for some telemetry errors and ACR Build and Push document

Open NirajC-Microsoft opened this issue 2 months ago • 0 comments

Purpose

This pull request adds comprehensive troubleshooting documentation for common Azure deployment errors and introduces a new guide for building and pushing Docker images to Azure Container Registry (ACR). These additions will help developers resolve deployment issues more efficiently and follow best practices for container image management.

Documentation Additions and Improvements:

  • Added a new guide, docs/ACRBuildAndPushGuide.md, with step-by-step instructions for building and pushing Docker images for both Backend and WebApp services to Azure Container Registry, including prerequisites, verification steps, and manual update instructions for Azure Portal.
  • Expanded docs/TroubleShootingSteps.md with detailed troubleshooting sections for a wide range of Azure deployment errors, including quota issues, resource provider registration, unsupported SKUs, cross-tenant deployments, policy restrictions, principal and resource not found errors, and more. Each section includes clear resolution steps and relevant Microsoft documentation links.
  • Linked the new ACR build and push guide from troubleshooting steps for container operation errors, improving discoverability and support for container-related deployment issues.
  • ...

Does this introduce a breaking change?

  • [ ] Yes
  • [X] 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

NirajC-Microsoft avatar Sep 22 '25 04:09 NirajC-Microsoft