Skip to content

Conversation

@Prekshith-Microsoft
Copy link
Contributor

…file.

This pull request adds a comprehensive troubleshooting guide and a new step-by-step build and push guide for Azure Container Registry (ACR). The troubleshooting documentation now covers a broader range of Azure deployment errors, providing actionable resolutions and direct links to official Microsoft documentation. The new ACR guide helps users build and push Docker images for both Backend and WebApp services. Minor improvements and corrections have also been made to existing troubleshooting content.

Documentation Additions and Improvements:

  • Added a new file documents/ACRBuildAndPushGuide.md with detailed instructions for building and pushing Docker images to Azure Container Registry, including prerequisites, step-by-step commands, portal guidance, and verification steps.
  • Expanded documents/TroubleShootingSteps.md with over a dozen new Azure deployment error scenarios, each with explanations, step-by-step solutions, and links to Microsoft documentation (e.g., InvalidRequestContent, ReadOnlyDisabledSubscription, SkuNotAvailable, PrincipalNotFound, RedundancyConfigurationNotAvailable, SpecialFeatureOrQuotaIdRequired, ContainerAppOperationError).
  • Improved error grouping and summaries for existing troubleshooting steps, such as combining related errors and updating descriptions for clarity. [1] [2]

Corrections and Link Updates:

  • Corrected error names and documentation links for improved accuracy and user experience (e.g., ParentResourceNotFound, updated resource provider registration link). [1] [2]

General Documentation Quality:

  • Enhanced formatting, added visual aids, and clarified manual update instructions for container images in Azure Portal.

These changes significantly improve the onboarding and troubleshooting experience for developers working with Azure resources and container deployments.

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

@Roopan-Microsoft Roopan-Microsoft merged commit 6bf8cac into dev Sep 26, 2025
6 checks passed
@github-actions
Copy link
Contributor

github-actions bot commented Oct 6, 2025

🎉 This PR is included in version 3.14.1 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

@Priyanka-Microsoft Priyanka-Microsoft deleted the psl-troubleshooting-ACR branch January 5, 2026 07:47
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.

3 participants