Skip to content

Conversation

Dhruvkumar-Microsoft
Copy link
Contributor

Purpose

This pull request introduces significant improvements and modernization to the Azure deployment templates and documentation for the solution accelerator. The changes focus on simplifying and standardizing parameter names, enhancing support for production (WAF-aligned) deployments, improving documentation for deployment prerequisites and configuration, and modularizing the Bicep infrastructure code.

Key changes:

Infrastructure Parameter Standardization and Modernization

  • Standardized and renamed deployment parameters across infra/main.parameters.json, infra/main.waf.parameters.json, and GitHub Actions workflows for consistency (e.g., environmentNamesolutionName, solutionLocationlocation, aiDeploymentsLocationazureAiServiceLocation, modelDeploymentTypegptModelDeploymentType). [1] [2] [3] [4]
  • Removed legacy and redundant parameters (such as explicit backend/frontend resource definitions and existence flags) to streamline the parameter files.
  • Updated container image tag parameters to use new names and default values for both backend and frontend. [1] [2]

Enhanced Production/Well-Architected (WAF) Support

  • Added a new infra/main.waf.parameters.json file for WAF-aligned, production-ready deployments, enabling telemetry, monitoring, private networking, scalability, and explicit VM admin credentials.
  • Updated GitHub Actions workflows (deploy.yml and deploy-waf.yml) to use the new standardized parameter names and to enable relevant production features for WAF deployments. [1] [2]

Documentation Improvements

  • Documented the requirement for Azure Developer CLI (azd) version 1.18.0 or higher, with upgrade instructions for all major operating systems.
  • Clarified the difference between sandbox and WAF-aligned deployments, and provided updated instructions for selecting and customizing deployment configurations.
  • Added documentation for configuring VM administrator credentials via environment variables, including fallback to random GUIDs if not set.
  • Updated the parameter reference documentation to include new VM credential environment variables.

Bicep Module Enhancements

  • Added a new ai-project.bicep module for deploying AI Foundry projects, with outputs for name, resource ID, and API endpoint.
  • Added a new ai-services-deployments.bicep module for deploying Cognitive Services model deployments and role assignments, including support for a wide range of built-in role names.

These changes collectively improve the clarity, maintainability, and production-readiness of the deployment process, making it easier to configure, deploy, and operate the solution in both development and enterprise environments.

Does this introduce a breaking change?

  • Yes
  • No

How to Test

  • Get the code
git clone [repo-address]
cd [repo-name]
git checkout [branch-name]
npm install
  • Test the code

What to Check

Verify that the following are valid

  • ...

Other Information

alguadam and others added 30 commits August 6, 2025 12:36
…tiple modules and update dependencies in pyproject.toml
- Simplified the output structure in `ai-project.bicep` by directly outputting project name, resource ID, and API endpoint instead of using a separate output type.
- Deleted the `ai-services.bicep`, `dependencies.bicep`, and `keyVaultExport.bicep` modules as they are no longer needed.
- Introduced a new module `ai-services-model-deployments.bicep` to handle cognitive services account deployments and role assignments.
- Updated role assignment handling to utilize built-in role names for better clarity and maintainability.
… subscription ID assignment for existing AI projects
refactor: consolidate AI Foundry AVM + custom code
feat: Refactor private DNS zone creation and add support for reusing existing Foundry project and Log Analytics workspace
…rk access is enabled for Container App Environment and Web App.
@Roopan-Microsoft Roopan-Microsoft merged commit 96f6a36 into main Sep 2, 2025
13 checks passed
@github-actions
Copy link

🎉 This PR is included in version 2.2.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

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.

5 participants