examples/showcases/microsoft-kanban/DEPLOY.md
This guide covers deploying the Kanban application (C# backend agent + Next.js frontend) to Azure Container Apps.
Install the Azure CLI:
brew install azure-cliAfter installation, verify:
az --version
You need an active Azure subscription. Sign up for a free account at azure.microsoft.com.
The backend agent requires a GitHub token to access GitHub Models API.
Get your token:
# If you have GitHub CLI installed
gh auth token
# Or create manually:
# 1. Go to https://github.com/settings/tokens
# 2. Click "Generate new token (classic)"
# 3. Select scopes: repo (full control)
# 4. Generate and copy the token
Set the token as an environment variable:
export GITHUB_TOKEN="your_token_here"
az login
This will open a browser window for authentication.
From the project root:
./scripts/deploy-azure.sh
The script will:
After deployment completes, you'll see:
Frontend URL: https://kanban-ui.xxx.azurecontainerapps.io
Backend URL: https://kanban-agent.xxx.azurecontainerapps.io
Open the frontend URL in your browser to use the Kanban board.
When running the deployment script, you can customize:
| Option | Default | Description |
|---|---|---|
| Resource Group | kanban-demo-rg | Azure resource group name |
| Location | eastus | Azure region |
| ACR Name | kanbandemoacr | Container registry name (must be globally unique) |
| Backend App | kanban-agent | Backend container app name |
| Frontend App | kanban-ui | Frontend container app name |
If you prefer to deploy manually or customize the process:
az group create \
--name kanban-demo-rg \
--location eastus
az acr create \
--name kanbandemoacr \
--resource-group kanban-demo-rg \
--sku Basic \
--admin-enabled true
Backend:
az acr build \
--registry kanbandemoacr \
--image kanban-agent:latest \
--file agent/Dockerfile \
--context .
Frontend:
az acr build \
--registry kanbandemoacr \
--image kanban-ui:latest \
--file Dockerfile \
--context .
az containerapp env create \
--name kanban-env \
--resource-group kanban-demo-rg \
--location eastus
Get ACR credentials:
ACR_USERNAME=$(az acr credential show --name kanbandemoacr --query username -o tsv)
ACR_PASSWORD=$(az acr credential show --name kanbandemoacr --query passwords[0].value -o tsv)
Deploy backend:
az containerapp create \
--name kanban-agent \
--resource-group kanban-demo-rg \
--environment kanban-env \
--image kanbandemoacr.azurecr.io/kanban-agent:latest \
--target-port 8000 \
--ingress external \
--registry-server kanbandemoacr.azurecr.io \
--registry-username "$ACR_USERNAME" \
--registry-password "$ACR_PASSWORD" \
--secrets github-token="$GITHUB_TOKEN" \
--env-vars GitHubToken=secretref:github-token
Get backend URL:
BACKEND_URL=$(az containerapp show \
--name kanban-agent \
--resource-group kanban-demo-rg \
--query properties.configuration.ingress.fqdn \
-o tsv)
az containerapp create \
--name kanban-ui \
--resource-group kanban-demo-rg \
--environment kanban-env \
--image kanbandemoacr.azurecr.io/kanban-ui:latest \
--target-port 3000 \
--ingress external \
--registry-server kanbandemoacr.azurecr.io \
--registry-username "$ACR_USERNAME" \
--registry-password "$ACR_PASSWORD" \
--env-vars NEXT_PUBLIC_BACKEND_URL="https://$BACKEND_URL"
After making code changes:
# Rebuild and push
az acr build \
--registry kanbandemoacr \
--image kanban-agent:latest \
--file agent/Dockerfile \
--context .
# Update container app
az containerapp update \
--name kanban-agent \
--resource-group kanban-demo-rg \
--image kanbandemoacr.azurecr.io/kanban-agent:latest
# Rebuild and push
az acr build \
--registry kanbandemoacr \
--image kanban-ui:latest \
--file Dockerfile \
--context .
# Update container app
az containerapp update \
--name kanban-ui \
--resource-group kanban-demo-rg \
--image kanbandemoacr.azurecr.io/kanban-ui:latest
az containerapp logs show \
--name kanban-agent \
--resource-group kanban-demo-rg \
--follow
az containerapp logs show \
--name kanban-ui \
--resource-group kanban-demo-rg \
--follow
Access detailed logs via Azure Portal:
Container Apps auto-scale based on HTTP traffic. To configure:
az containerapp update \
--name kanban-ui \
--resource-group kanban-demo-rg \
--min-replicas 1 \
--max-replicas 5
Azure Container Apps pricing (as of 2024):
| Resource | Cost | Notes |
|---|---|---|
| Container Apps | Free tier: 180,000 vCPU-seconds/month | Should cover demo usage |
| Container Apps (beyond free) | ~$0.000012/vCPU-second | After free tier |
| Azure Container Registry (Basic) | ~$5/month | 10 GB storage included |
| Estimated total | ~$5-10/month | For demo with minimal traffic |
az group delete --name kanban-demo-rg after demosDelete all resources:
az group delete \
--name kanban-demo-rg \
--yes \
--no-wait
This removes:
Note: Deletion takes 5-10 minutes. Use --no-wait to run in background.
Error: The registry DNS name 'kanbandemoacr' is already in use.
Solution: ACR names must be globally unique. Try a different name:
ACR_NAME="kanbandemoacr$(date +%s)"
Check logs:
az containerapp logs show --name kanban-agent --resource-group kanban-demo-rg --tail 50
Common causes:
Verify backend URL:
az containerapp show \
--name kanban-agent \
--resource-group kanban-demo-rg \
--query properties.configuration.ingress.fqdn
Update frontend:
az containerapp update \
--name kanban-ui \
--resource-group kanban-demo-rg \
--set-env-vars NEXT_PUBLIC_BACKEND_URL="https://<backend-fqdn>"
Check Docker locally:
# Test backend build
docker build -t kanban-agent -f agent/Dockerfile .
# Test frontend build
docker build -t kanban-ui -f Dockerfile .
Common causes:
Install Azure CLI (see Prerequisites section).
Re-authenticate:
az logout
az login
Restrict access to Azure resources:
az role assignment create \
--assignee [email protected] \
--role Contributor \
--resource-group kanban-demo-rg
For issues specific to: