Agent Skills › microsoft/azure-skills › python-appservice-deploy

python-appservice-deploy

GitHub

将 Python (Flask/Django/FastAPI) 代码部署到 Azure App Service Linux。自动创建资源组、计划和应用服务，根据框架和配置文件选择 azd 或 az cli 进行部署，并配置启动命令。

skills/python-appservice-deploy/SKILL.md microsoft/azure-skills

Trigger Scenarios

Flask App Service Django App Service FastAPI App Service deploy Python to App Service

Install

npx skills add microsoft/azure-skills --skill python-appservice-deploy -g -y

More Options

Use without installing

npx skills use microsoft/azure-skills@python-appservice-deploy

指定 Agent (Claude Code)

npx skills add microsoft/azure-skills --skill python-appservice-deploy -a claude-code -g -y

安装 repo 全部 skill

npx skills add microsoft/azure-skills --all -g -y

预览 repo 内 skill

npx skills add microsoft/azure-skills --list

SKILL.md

Frontmatter

{
    "name": "python-appservice-deploy",
    "license": "MIT",
    "metadata": {
        "author": "Microsoft",
        "version": "1.1.1"
    },
    "description": "Deploy Python (Flask\/Django\/FastAPI) code to Azure App Service Linux. WHEN: \"Flask App Service\", \"Django App Service\", \"FastAPI App Service\", \"deploy Python to App Service\". DO NOT USE FOR: Container Apps, Functions, non-Python, Terraform\/Bicep\/IaC, full infra — use azure-prepare."
}

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

Resolve context — smart defaults, minimal prompts. Only the app name is interactive; RG (<app>-rg), Plan (<app>-plan), region (current az default or eastus2), subscription are derived. create-app.md §1.
Detect framework (advisory, never blocks). detect.md.
Choose path — azure.yaml host: appservice → deploy-azd.md; else deploy-azcli.md.
Ensure RG → Plan (P0v3 --is-linux) → Web App (--runtime "PYTHON:3.14") exist. On transient ARM errors, follow transient-retry.md. create-app.md.
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.
Set SCM_DO_BUILD_DURING_DEPLOYMENT=true.
Deploy — azd deploy or az webapp deploy --type zip --track-status false.
STOP. Print the post-deploy message (post-deploy-message.md) and end the turn.

Hard rules

⛔ 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

See errors.md for the full symptom → cause → fix matrix. Quick triage: missing plan/app → re-run Step 4; container ping timeout on 8000 → fix startup (Step 5); ModuleNotFoundError after deploy → ensure Step 6 ran, redeploy.

Version History

ea76537 Current 2026-08-20 03:59
013b97d 2026-07-25 09:46

Metadata

Files: 0
Version: ea76537
Hash: 17a26399
Indexed: 2026-07-25 09:46

python-appservice-deploy

python-appservice-deploy

Trigger Scenarios

Install

SKILL.md

Python on Azure App Service — Code Deploy

Workflow

Hard rules

Error Handling

Version History

Same Skill Collection

Metadata

文库