Iac Common

azd hooks replace custom deploy.ps1 pre/post steps:

• preprovision — auth validation, banner, prerequisite checks
• postprovision — resource verification, diagnostic setup

Environment management replaces manual parameterization:

• azd env new prod / azd env new dev
• azd env set AZURE_LOCATION swedencentral

azd Environment Preflight (MANDATORY for --no-prompt Deploys)

Before azd provision --no-prompt, verify these environment values are set:

• AZURE_SUBSCRIPTION_ID — from az account show --query id -o tsv
• AZURE_RESOURCE_GROUP — target resource group name
• AZURE_ENV_NAME — environment name
• AZURE_LOCATION — target region

Run azd env get-values and check for missing values. If any are empty, set them via azd env set {KEY} {VALUE} before attempting --no-prompt.

Phased Deployment via deploy.ps1 (legacy, backward-compatible)

• Bicep: Pass -Phase {name} to deploy.ps1
• Terraform: Pass -var deployment_phase={name} to plan/apply

Single Deployment (only for <5 resources, dev/test)

Deploy everything in one operation. Still requires user approval.

Decision: azd vs deploy.ps1

Reference Index

Circuit Breaker

Deploy agents MUST read references/circuit-breaker.md before starting any deployment. It defines:

• Failure taxonomy: 6 categories (build, validation, deployment, empty, timeout, auth)
• Anomaly patterns: detection thresholds for repetitive failures
• Stopping rule: 3 consecutive same-type failures → halt + escalate
• Escalation protocol: write to session state, notify user, wait for guidance