Skip to content

Conversation

@Prajwal-Microsoft
Copy link
Contributor

Purpose

  • ...
    This pull request introduces several documentation improvements, workflow enhancements, and infrastructure updates to make Azure deployments more robust and user-friendly. The most notable changes include expanding troubleshooting guidance for deployment errors, adding a comprehensive guide for building and pushing container images to Azure Container Registry (ACR), and improving resource tagging and metadata handling in deployment templates.

Documentation enhancements:

  • Added extensive troubleshooting steps for a wide range of Azure deployment errors in docs/TroubleShootingSteps.md, covering new error types such as InvalidRequestContent, ReadOnlyDisabledSubscription, SkuNotAvailable, CrossTenantDeploymentNotPermitted, RequestDisallowedByPolicy, FlagMustBeSetForRestore, PrincipalNotFound, RedundancyConfigurationNotAvailableInRegion, DeploymentNotFound, DeploymentCanceled, ResourceGroupDeletionTimeout, SubscriptionDoesNotHaveServer, BadRequest for failed provisioning, SpecialFeatureOrQuotaIdRequired, and ContainerAppOperationError. Each error includes actionable resolution steps and relevant Microsoft documentation links. [1] [2] [3] [4]
  • Added a new docs/ACRBuildAndPushGuide.md file with step-by-step instructions for building and pushing Docker images for WebApp and Backend services to Azure Container Registry, including manual update steps and verification commands.

Infrastructure and workflow improvements:

  • In .github/workflows/CAdeploy.yml, added logic to generate a UTC timestamp for resource tagging, and enhanced deployment parameters to include detailed tags for security, purpose, and creation date.
  • Updated infra/main.bicep and infra/main.json to improve resource tagging: the createdBy parameter now captures either the username or object ID based on context, and a new Type tag distinguishes between WAF and Non-WAF deployments. Metadata descriptions were also clarified. [1] [2] [3]

Minor cleanups:

  • Removed commented-out and unused parameter definitions in infra/main.bicep for clarity. [1] [2] [3]
  • Updated template hash in infra/main.json to reflect the latest changes.

These changes collectively improve deployment reliability, make troubleshooting easier, and provide clearer guidance for working with Azure resources.

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

NirajC-Microsoft and others added 2 commits September 29, 2025 11:49
* fix: added tags in CAdeploy.yml file (#675)

* CI Pipeline fix for Client Advisor

* added tags in CAdeploy.yml file

* add my feature branch

* tags changes updated in CAdeploy.yml file

* added template name condition based

* removed my feature branch from pipeline

* Additional Troubleshooting steps

* fix: Remove createdby from pipeline and add change Createdby logic in bice… (#678)

* Remove createdby from pipeline and add change Createdby logic in bicep file

* Add 'createdBy' parameter to Azure deployment

* Add 'createdBy' parameter for tagging

* added new 'type' tag (#682)

* Update docs/TroubleShootingSteps.md

Co-authored-by: Copilot <[email protected]>

* Update GitHub Issues link in troubleshooting steps

---------

Co-authored-by: VishalS-Microsoft <[email protected]>
Co-authored-by: Harsh-Microsoft <[email protected]>
Co-authored-by: Copilot <[email protected]>
@Prajwal-Microsoft Prajwal-Microsoft changed the title Refactor refactor: Removed commented params Oct 1, 2025
@Prajwal-Microsoft Prajwal-Microsoft merged commit 68a0936 into psl-Azd-version-update Oct 1, 2025
4 of 5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants