Claude-skill-registry azd-aca-deploy

Deploy to Azure Container Apps using azd (provision + deploy workflow)

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/azd-aca-deploy" ~/.claude/skills/majiayu000-claude-skill-registry-azd-aca-deploy && rm -rf "$T"

manifest: skills/data/azd-aca-deploy/SKILL.md

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 down
```
and
```
azd up
```
fresh

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