| name | azd-aca-deploy |
| description | Deploy to Azure Container Apps using azd (provision + deploy workflow) |
Azure Container Apps Deployment Skill
Use this skill when asked to:
- "deploy to Azure"
- "azd up"
- "provision infrastructure"
- "update the app in Azure"
Prerequisites
Before deploying:
- azd installed:
azd version - Logged in:
azd auth login - Environment selected:
azd env list
Deployment Strategies
Full Deployment (First Time)
azd up
This runs provision + deploy in one command.
Incremental Updates
| Change Type | Command | Speed |
|---|---|---|
| Bicep/Infra only | azd provision |
Slower |
| App code only | azd deploy |
Fast |
| Both | azd up |
Full |
Recommended Workflow
For Code Changes
# 1. Run quality checks
uv run python .github/skills/python-quality/scripts/check.py
# 2. Deploy app only (fast)
azd deploy
For Infrastructure Changes
# 1. Preview changes
az deployment group what-if \
--resource-group <rg> \
--template-file infra/main.bicep
# 2. Apply changes
azd provision
Environment Management
# List environments
azd env list
# Create new environment
azd env new <name>
# Switch environment
azd env select <name>
# Delete environment (and resources)
azd down
Troubleshooting
Common Issues
- Auth expired: Run
azd auth login - Wrong subscription: Check
az account show - Resource conflicts: Run
azd downandazd upfresh
View Logs
# Container Apps logs
az containerapp logs show \
--name <app-name> \
--resource-group <rg> \
--type console
Quick Script
For automated deployment:
uv run python .github/skills/azd-aca-deploy/scripts/deploy.py