Skip to content

fix: Standardize azd parameter names and update documentation#606

Open
Prachig-Microsoft wants to merge 7 commits intodevfrom
psl-standardize-parameter-bicep
Open

fix: Standardize azd parameter names and update documentation#606
Prachig-Microsoft wants to merge 7 commits intodevfrom
psl-standardize-parameter-bicep

Conversation

@Prachig-Microsoft
Copy link
Copy Markdown
Contributor

This pull request standardizes environment variable names and parameters across multiple GitHub Actions workflows, focusing on Azure AI service and Log Analytics workspace integration. The changes improve clarity and consistency in naming, making the workflows easier to maintain and less error prone.

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

- Replace AZURE_ENV_OPENAI_LOCATION with AZURE_ENV_AI_SERVICE_LOCATION
- Replace AZURE_ENV_MODEL_CAPACITY with AZURE_ENV_GPT_MODEL_CAPACITY
- Replace AZURE_ENV_EMBEDDING_MODEL_CAPACITY with AZURE_ENV_EMBEDDING_DEPLOYMENT_CAPACITY

Updated files:
- .github/workflows/azure-dev.yml
- .github/workflows/azd-template-validation.yml
- Correct AZURE_ENV_GPT_MODEL_NAME default: gpt-4.1 → gpt-4.1-mini
- Correct AZURE_ENV_GPT_MODEL_VERSION default: 2024-08-06 → 2025-04-14
- Fix AZURE_ENV_EMBEDDING_MODEL_NAME: Add missing backticks
- Fix AZURE_ENV_EMBEDDING_MODEL_VERSION: Correct default from 200 to 1
- Fix AZURE_ENV_EMBEDDING_DEPLOYMENT_CAPACITY: Type int, default 100
- Improve descriptions for capacity parameters
- Reorganize AZURE_ENV_EXISTING_LOG_ANALYTICS_WORKSPACE_RID entry
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Standardizes azd parameter/environment variable naming across infra templates and GitHub Actions workflows, and updates documentation to match the new names for Azure AI service location and Log Analytics workspace reuse.

Changes:

  • Renamed infra parameter aiDeploymentsLocation to azureAiServiceLocation and updated references in Bicep/ARM and parameter files.
  • Renamed several AZURE_ENV_* variables (notably OpenAI location, GPT model settings, embedding capacity, and Log Analytics workspace resource ID) across workflows and docs.
  • Added resource-group tagging support during RG creation in the deploy workflow.

Reviewed changes

Copilot reviewed 14 out of 14 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
infra/main.waf.parameters.json Updates parameter/env-var names to standardized Azure AI + Log Analytics naming.
infra/main.parameters.json Mirrors standardized parameter/env-var names for the non-WAF parameter file.
infra/main.json Renames ARM parameter and its usages to azureAiServiceLocation (regenerated template metadata).
infra/main.bicep Renames Bicep parameter and updates module input to align with standardized naming.
docs/re-use-log-analytics.md Updates the documented azd env set variable name for reusing Log Analytics.
docs/CustomizingAzdParameters.md Updates the parameter reference table and examples for new env-var names.
.github/workflows/job-deploy.yml Renames workflow inputs/outputs/env-vars and adds RG tags to az group create.
.github/workflows/job-deploy-linux.yml Renames workflow inputs and env-var usage; updates Log Analytics variable name end-to-end.
.github/workflows/job-cleanup-deployment.yml Renames OpenAI location input/env-var to AI service location.
.github/workflows/deploy-v2.yml Renames Log Analytics input/output plumbing to the new *_RID name.
.github/workflows/deploy-orchestrator.yml Propagates renamed inputs/outputs (AI service location + Log Analytics RID).
.github/workflows/azure-dev.yml Updates local dev workflow to set the new AI service location env-var.
.github/workflows/azd-template-validation.yml Updates validation workflow env-vars to the new standardized capacity/location names.
.github/workflows/CI.yml Updates ARM parameter call-site to azureAiServiceLocation.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread .github/workflows/job-deploy.yml
Comment thread .github/workflows/job-deploy-linux.yml
Comment thread docs/re-use-log-analytics.md
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 14 out of 14 changed files in this pull request and generated 6 comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread .github/workflows/job-deploy.yml
Comment thread .github/workflows/job-deploy.yml
Comment thread .github/workflows/job-deploy.yml
Comment thread infra/main.bicep
Comment thread .github/workflows/job-deploy-linux.yml Outdated
Comment thread docs/CustomizingAzdParameters.md
Comment thread .github/workflows/job-deploy-linux.yml Outdated
Keep using the existing GitHub secret name instead of renaming to match
the standardized environment variable name. This prevents breaking the
workflow which depends on the secret configured in repository settings.
Comment thread infra/main.parameters.json Outdated
Comment thread infra/main.parameters.json Outdated
- Rename gptModelCapacity to gptDeploymentCapacity
- Rename embeddingModelCapacity to embeddingDeploymentCapacity
- Update all references in bicep, parameter files, and CI workflow
- Regenerate main.json from bicep template

This aligns parameter names with their actual usage as deploymentCapacity
and matches the environment variable naming convention.
Comment thread infra/main.parameters.json Outdated
…entType

- Renamed parameter 'gptModelDeploymentType' to 'deploymentType' across all files
- Updated infra/main.bicep parameter definition and references
- Updated infra/main.parameters.json and main.waf.parameters.json
- Updated .github/workflows/CI.yml deployment command
- Rebuilt infra/main.json (ARM template) with updated parameter
- Mapped to azd environment variable: AZURE_ENV_MODEL_DEPLOYMENT_TYPE
Copy link
Copy Markdown
Contributor

@Harsh-Microsoft Harsh-Microsoft left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

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.

3 participants