docs: Updated the troubleshooting guide and added the ACRBuildAndPushGuide#564
Merged
Roopan-Microsoft merged 3 commits intodevfrom Sep 26, 2025
Merged
docs: Updated the troubleshooting guide and added the ACRBuildAndPushGuide#564Roopan-Microsoft merged 3 commits intodevfrom
Roopan-Microsoft merged 3 commits intodevfrom
Conversation
Roopan-Microsoft
approved these changes
Sep 26, 2025
Contributor
|
🎉 This PR is included in version 1.6.1 🎉 The release is available on GitHub release Your semantic-release bot 📦🚀 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
…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
docs/ACRBuildAndPushGuide.mdwith 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.docs/TroubleShootingSteps.mdwith detailed troubleshooting steps for new Azure deployment errors such asInvalidRequestContent,ReadOnlyDisabledSubscription,SkuNotAvailable,CrossTenantDeploymentNotPermitted,FlagMustBeSetForRestore,PrincipalNotFound,RedundancyConfigurationNotAvailableInRegion,DeploymentNotFound,ResourceGroupDeletionTimeout,SubscriptionDoesNotHaveServer,BadRequest,SpecialFeatureOrQuotaIdRequired, andContainerAppOperationError. Each error now includes causes, resolution steps, and relevant documentation links.Corrections and Improvements
ParentResourceNotfoundtoParentResourceNotFound) and updated documentation links for resource provider registration errors. [1] [2]DeploymentModelNotSupported/InvalidResourceProperties) and removing obsolete error codes. [1] [2]Does this introduce a breaking change?
Golden Path Validation
Deployment Validation
What to Check
Verify that the following are valid
Other Information