Python Appservice Deploy

Python on Azure App Service — Code Deploy

Deploys Python (Flask, Django, FastAPI, generic) code to Azure App Service Linux (P0v3, Python 3.14). Creates RG + Plan + Web App if missing. Hand off to azure-prepare for VNet, Key Vault, databases, or IaC.

MCP tools used: mcp_azure_mcp_subscription_list, mcp_azure_mcp_group_list, mcp_azure_mcp_appservice, mcp_azure_mcp_azd (when azure.yaml is present).

Workflow

Prerequisite: Verify the latest stable Azure CLI; update with approval and recheck if needed.

1. Resolve context — smart defaults, minimal prompts. Only the app name is interactive; RG (-rg), Plan (-plan), region (current az default or eastus2), subscription are derived. create-app.md §1.
2. Detect framework (advisory, never blocks). detect.md.
3. Choose path — azure.yaml host: appservice → deploy-azd.md; else deploy-azcli.md.
4. Ensure RG → Plan (P0v3 --is-linux) → Web App (--runtime "PYTHON:3.14") exist. Before creating a plan, invoke azure-quotas to check quota availability. On transient ARM errors, follow transient-retry.md. create-app.md.
5. Set startup — Flask/Django: none (Oryx auto-detects). FastAPI: always python -m uvicorn main:app --host 0.0.0.0. Other: warn. startup-commands.md.
6. Set SCM_DO_BUILD_DURING_DEPLOYMENT=true.
7. Deploy — azd deploy or az webapp deploy --type zip --track-status false --enriched-errors true.
8. STOP. Print the post-deploy message (post-deploy-message.md) and end the turn.

Hard rules

• LINUX SCRIPTS — normalize selected shell/startup files to LF, then verify no CR bytes remain. Stop on normalization, validation or packaging failure; deploy only a fresh package.
• DJANGO REMOTE BUILDS — require STATIC_ROOT and successful system/collectstatic checks before packaging.
• ⛔ NO POST-DEPLOY VERIFICATION — after deploy returns, do not run az webapp log tail, curl, Invoke-WebRequest, or any health probe. App Service needs 2–3 min to warm; a quiet log or early 5xx is not failure.
• ⛔ SHELL SAFETY — for --runtime always use "PYTHON:3.14" (colon). Never "PYTHON|3.14" (pipe is a shell operator).
• ⛔ NEVER az webapp up — deprecated. Use Step 7 commands.
• ✅ URL FORMAT — present endpoints as https://... URLs.

Error Handling