Agent skill · software engineering · aiskillstore
azd-deployment
Deploy containerized frontend + backend applications to Azure Container Apps with remote builds, managed identity, and idempotent infrastructure.
Why this skill is useful
Adds executable scripts and configuration patterns for deploying applications to Azure Container Apps that are not commonly found in public documentation.
What it needs
Requires azure-cli, docker installed locally. Requires azure account access. About 4k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Azure Developer CLI (azd) Container Apps Deployment Deploy containerized frontend + backend applications to Azure Container Apps with remote builds, managed identity, and idempotent infrastructure. Quick Start Core File Structure azure.yaml Configuration Minimal Configuration Full Configuration with Hooks Key azure.yaml Options Option Description -------- ------------- remoteBuild: true Build images in Azure Container Registry (recommended) context: . Docker build context relative to project path host: containerapp Deploy to Azure Container Apps infra.provider: bicep Use Bicep for infrastructure Environment Variables Flow Three-Level Configuration 1. Local .env - For local development only 2. .azure/<env>/.env - azd-managed, auto-populated from Bicep outputs 3. main.parameters.json - Maps env vars to Bicep parameters Parameter Injection Pattern Syntax: ${VARNAME} or ${VARNAME=defaultvalue} Setting Environment Variables Bicep Output → Environment Variable Idempotent Deployments Why azd up is Idempotent 1. Bicep is declarative - Resources reconcile to desired state 2. Remote builds tag uniquely - Image tags include deployment timestamp 3. ACR reuses layers - Only changed layers upload Preserving Manual Changes Custom domains added via Portal can be lost on redeploy. Preserve with hooks: Handling Existing Resources Container App Service Discovery Internal HTTP routing between Container Apps in same environment: Frontend nginx proxies to internal URL: Managed Identity & RBAC Enable System-Assigned Identity Post-Provision RBAC Assignment Common Commands Reference Files Bicep patterns: See references/bicep-patterns.md for Container Apps modules Troubleshooting: See references/troubleshooting.md for common issues azure.yaml schema: See references/azure-yaml-schema.md for full options Critical Reminders 1. Always use remoteBuild: true - Local builds fail on M1/ARM Macs deploying to AMD64 2. Bicep outputs auto-populate .azure/<env>/.env - Don't manually edit 3. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/azd-deployment