Skip to content

Comments

docs: Updated the troubleshooting guide and added the ACRBuildAndPushGuide#564

Merged
Roopan-Microsoft merged 3 commits intodevfrom
psl-troubleshoot-ACRupdate
Sep 26, 2025
Merged

docs: Updated the troubleshooting guide and added the ACRBuildAndPushGuide#564
Roopan-Microsoft merged 3 commits intodevfrom
psl-troubleshoot-ACRupdate

Conversation

@Prekshith-Microsoft
Copy link
Contributor

…file.

Purpose

This pull request updates the documentation to improve deployment troubleshooting guidance and adds a new guide for building and pushing Docker images to Azure Container Registry (ACR). The main improvements include expanded troubleshooting steps for common Azure deployment errors, corrections to error names and links, and the addition of a comprehensive step-by-step guide for ACR workflows.

Documentation Enhancements

  • Added a new file docs/ACRBuildAndPushGuide.md with step-by-step instructions for building and pushing Docker images for WebApp and Backend services to Azure Container Registry, including prerequisites, verification, and manual update steps.
  • Expanded docs/TroubleShootingSteps.md with detailed troubleshooting steps for new Azure deployment errors such as InvalidRequestContent, ReadOnlyDisabledSubscription, SkuNotAvailable, CrossTenantDeploymentNotPermitted, FlagMustBeSetForRestore, PrincipalNotFound, RedundancyConfigurationNotAvailableInRegion, DeploymentNotFound, ResourceGroupDeletionTimeout, SubscriptionDoesNotHaveServer, BadRequest, SpecialFeatureOrQuotaIdRequired, and ContainerAppOperationError. Each error now includes causes, resolution steps, and relevant documentation links.

Corrections and Improvements

  • Corrected error names for consistency (e.g., ParentResourceNotfound to ParentResourceNotFound) and updated documentation links for resource provider registration errors. [1] [2]
  • Improved error grouping and descriptions, such as combining related errors (DeploymentModelNotSupported/InvalidResourceProperties) and removing obsolete error codes. [1] [2]
  • Minor formatting improvement at the top of the troubleshooting guide for better readability.

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

  • I have built and tested the code locally and in a deployed app
  • For frontend changes, I have pulled the latest code from main, built the frontend, and committed all static files.
  • This is a change for all users of this app. No code or asset is specific to my use case or my organization.

Other Information

@Roopan-Microsoft Roopan-Microsoft merged commit 46dd3ea into dev Sep 26, 2025
5 checks passed
@github-actions
Copy link
Contributor

🎉 This PR is included in version 1.6.1 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

@Prekshith-Microsoft Prekshith-Microsoft deleted the psl-troubleshoot-ACRupdate branch November 24, 2025 07:03
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.

2 participants