/azure-prepare

Static Web Apps - Deployment

azd Deploy (Default)

Standard deployment via Azure Developer CLI:

azd deploy

GitHub-Linked Deployments

For CI/CD builds on Azure (instead of azd deploy):

properties: {
  repositoryUrl: 'https://github.com/owner/repo'
  branch: 'main'
  buildProperties: {
    appLocation: 'src'
    apiLocation: 'api'
    outputLocation: 'dist'
  }
}

Deployment Token

⚠️ Security Warning: Do NOT expose deployment tokens in ARM/Bicep outputs. Deployment outputs are visible in Azure portal deployment history and logs.

Recommended approach - retrieve token via Azure CLI and store directly in secret store:

# Capture token to variable (never echo or log)
DEPLOYMENT_TOKEN=$(az staticwebapp secrets list --name <app-name> --query "properties.apiKey" -o tsv)

# Store directly in Key Vault
az keyvault secret set --vault-name <vault-name> --name swa-deployment-token --value "$DEPLOYMENT_TOKEN" --output none

Do NOT do this (exposes token in deployment history):

// ❌ INSECURE - token visible in deployment history
// output deploymentToken string = staticWebApp.listSecrets().properties.apiKey

Terraform Deployment

⚠️ Use azurerm_static_web_app — NOT Storage Account static_website. Storage Account static websites require anonymous blob access, which is blocked by enterprise Azure Policies. See terraform.md for correct patterns.

Terraform-based deployments use azd deploy the same way as Bicep:

azd deploy

The azd-service-name tag on the azurerm_static_web_app resource tells azd where to deploy.

Do NOT do this (exposes token in Terraform state):

# ❌ INSECURE - token stored in Terraform state
# output "deployment_token" {
#   value     = azurerm_static_web_app.web.api_key
#   sensitive = true
# }