AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

azure-prepare

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Terraform), and Dockerfiles for the Azure Developer CLI (azd) workflow. USE ONLY when the user explicitly wants to use azd as the deployment tool, or the project already has an azure.yaml file. DO NOT USE FOR: non-azd deployments, Python App Service code-only deploys (use python-appservice-deploy), or cross-cloud migration (use azure-cloud-migrate). WHEN: prepare app for azd, create azure.yaml, set up azd infrastructure, modernize app for Azure with azd, deploy with azd, function app, timer trigger, service bus trigger, event-driven function, managed identity, generate Bicep, generate Terraform, create and deploy to Azure.

Original source
microsoft
License
MIT
Pinned revision
3f5b461b2314e01c400564051e92469114c5b68f

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

This skill also requires local files or dependencies. Remote reading alone may not be enough.

Ask your assistant

Use Agentic Memory skills to read microsoft--azure-prepare at revision 3f5b461b2314e01c400564051e92469114c5b68f, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 164

references/services/static-web-apps/terraform.md

Static Web Apps — Terraform Patterns — REFERENCE ONLY

⛔ DO NOT COPY THIS CODE DIRECTLY

This file contains reference patterns for understanding Azure Static Web Apps Terraform structure. Infrastructure for Static Web Apps must be composed using the Azure Prepare skill workflow, not copied directly from this reference.

When composing infrastructure:

  • Start from an approved base template for Static Web Apps defined by your platform or template team.
  • Use azurerm_static_web_app — NEVER use Storage Account static_website for static web app hosting.

Hand-writing Terraform from these patterns will result in missing tags, broken azd deploy, and policy violations.

⚠️ WARNING: Do NOT use Storage Account static website hosting. Storage Account static_website requires anonymous blob access, which violates enterprise Azure Policies (RequestDisallowedByPolicy: "Anonymous blob access is not allowed"). Always use azurerm_static_web_app instead — it is fully managed and policy-compliant.

Basic Resource

resource "azurerm_static_web_app" "web" {
  name                = "swa-${var.environment_name}-${var.service_name}-${var.unique_hash}"
  resource_group_name = azurerm_resource_group.main.name
  location            = var.location

  # sku_tier defaults to "Free"; set to "Standard" for production features
  sku_tier = "Standard"

  # Required for azd deploy to find this resource
  tags = merge(var.tags, {
    "azd-service-name" = var.service_name
  })
}

⚠️ Region availability is limited. Check region-availability.md before selecting a region.

💡 Key Points:

  • No Storage Account, Service Plan, or other supporting resources required
  • Static Web Apps is a fully managed service — storage is built-in
  • The azd-service-name tag is required for azd deploy to locate the resource

Custom Domain

resource "azurerm_static_web_app_custom_domain" "example" {
  static_web_app_id = azurerm_static_web_app.web.id
  domain_name       = "www.example.com"
  validation_type   = "cname-delegation"
}

Application Settings

For the integrated API backend:

resource "azurerm_static_web_app_function_app_registration" "api" {
  static_web_app_id = azurerm_static_web_app.web.id
  function_app_id   = azurerm_linux_function_app.api.id
}

Environment variables for the SWA (available to both frontend and managed Functions API):

resource "azurerm_static_web_app" "web" {
  # ... (base configuration from above)

  app_settings = {
    "DATABASE_URL" = "@Microsoft.KeyVault(VaultName=${azurerm_key_vault.kv.name};SecretName=db-url)"
  }
}

Outputs

output "WEB_URL" {
  value = azurerm_static_web_app.web.default_host_name
}

output "STATIC_WEB_APP_NAME" {
  value = azurerm_static_web_app.web.name
}

💡 Tip: Output names in UPPERCASE are automatically set as azd environment variables.

Deployment Token

⚠️ Security Warning: Do NOT expose deployment tokens in Terraform outputs.

See deployment.md for secure token handling.

azure.yaml Integration

services:
  web:
    project: ./src/web
    language: js
    host: staticwebapp
    dist: dist

References