Azure部署指南：从验证到执行的完整流程与最佳实践

azure-deploy by microsoft/azure-skills

76,500 周安装量

497 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/microsoft/azure-skills --skill azure-deploy

🇨🇳中文介绍

Azure 部署

权威指南 — 强制遵守

前提条件：在执行此技能之前，必须调用并完成 azure-validate 技能，且状态为 Validated。

⛔ 停止 — 需要检查前提条件 在继续之前，请验证是否满足以下两个前提条件：

已调用并完成 azure-prepare → 存在 .azure/plan.md 文件

已调用并通过 azure-validate → 计划状态 = Validated

如果缺少其中任何一项，请立即停止：

没有计划？ → 请先调用 azure-prepare 技能

状态不是 Validated？ → 请先调用 azure-validate 技能

⛔ 请勿手动更新计划状态

严禁您自行将计划状态更改为。只有技能在运行实际验证检查后才有权设置此状态。如果您在没有运行验证的情况下更新状态，部署将会失败。

🇺🇸English

Azure Deploy

AUTHORITATIVE GUIDANCE — MANDATORY COMPLIANCE

PREREQUISITE : The azure-validate skill MUST be invoked and completed with status Validated BEFORE executing this skill.

⛔ STOP — PREREQUISITE CHECK REQUIRED Before proceeding, verify BOTH prerequisites are met:

azure-prepare was invoked and completed → .azure/plan.md exists

azure-validate was invoked and passed → plan status = Validated

If EITHER is missing, STOP IMMEDIATELY :

No plan? → Invoke azure-prepare skill first

Status not Validated? → Invoke skill first

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

暂无相关 Skills

请勿假设应用程序已准备就绪。请勿跳过验证以节省时间。跳过步骤会导致部署失败。完整的工作流程确保成功：

azure-prepare → azure-validate → azure-deploy

当用户想要执行以下操作时，激活此技能：

执行已准备就绪的应用程序的部署（存在 azure.yaml 和 infra/）
向现有的 Azure 部署推送更新
在已准备的项目上运行 azd up、azd deploy 或 az deployment
将已构建的代码发布到生产环境
部署已包含 API 管理（APIM）网关基础设施的应用程序

范围：此技能执行部署。它不创建应用程序、生成基础设施代码或搭建项目框架。对于这些任务，请使用 azure-prepare。

APIM / AI 网关：使用此技能来部署那些 APIM/AI 网关基础设施已在 azure-prepare 过程中创建的应用程序。如需创建或更改 APIM 资源，请参阅 APIM 部署指南。对于 AI 治理策略，请调用 azure-aigateway 技能。

在 azure-prepare 和 azure-validate 之后运行
必须存在 .azure/plan.md 文件且状态为 Validated
需要预部署清单 — 预部署清单
⛔ 破坏性操作需要 ask_user — 全局规则
范围：仅限部署执行 — 此技能负责执行 azd up、azd deploy、terraform apply 和 az deployment 命令。这些命令通过此技能的错误恢复和验证管道运行。

---|---|---
1 | 检查计划 — 读取 .azure/plan.md，验证状态 = Validated 且 验证证明 部分已填写 | .azure/plan.md
2 | 预部署清单 — 必须完成所有步骤 | 预部署清单
3 | 加载配方 — 基于 .azure/plan.md 中的 recipe.type | recipes/README.md
4 | 执行部署 — 遵循配方步骤 | 配方 README
5 | 部署后 — 配置 SQL 托管标识并应用 EF 迁移（如适用） | 部署后步骤
6 | 处理错误 — 参见配方的 errors.md | —
7 | 验证成功 — 确认部署完成且端点可访问 | 验证

⛔ 验证证明检查

检查计划时，请验证 验证证明 部分（第 7 节）包含实际的验证结果，包括运行的命令和时间戳。如果此部分为空，则表示验证被绕过 — 请先调用 azure-validate 技能。

Azure Developer CLI : azd
Azure Identity : Python | .NET | TypeScript | Java

工具	用途
`mcp_azure_mcp_subscription_list`	列出可用订阅
`mcp_azure_mcp_group_list`	列出订阅中的资源组
`mcp_azure_mcp_azd`	执行 AZD 命令

故障排除 - 常见问题及解决方案
部署后步骤 - SQL + EF Core 设置

⛔ DO NOT MANUALLY UPDATE THE PLAN STATUS

You are FORBIDDEN from changing the plan status to Validated yourself. Only the azure-validate skill is authorized to set this status after running actual validation checks. If you update the status without running validation, deployments will fail.

DO NOT ASSUME the app is ready. DO NOT SKIP validation to save time. Skipping steps causes deployment failures. The complete workflow ensures success:

azure-prepare → azure-validate → azure-deploy

Activate this skill when user wants to:

Execute deployment of an already-prepared application (azure.yaml and infra/ exist)
Push updates to an existing Azure deployment
Run azd up, azd deploy, or az deployment on a prepared project
Ship already-built code to production
Deploy an application that already includes API Management (APIM) gateway infrastructure

Scope : This skill executes deployments. It does not create applications, generate infrastructure code, or scaffold projects. For those tasks, use azure-prepare.

APIM / AI Gateway : Use this skill to deploy applications whose APIM/AI gateway infrastructure was already created during azure-prepare. For creating or changing APIM resources, see APIM deployment guide. For AI governance policies, invoke azure-aigateway skill.

Run after azure-prepare and azure-validate
.azure/plan.md must exist with status Validated
Pre-deploy checklist required — Pre-Deploy Checklist
⛔ Destructive actions requireask_user — global-rules
Scope: deployment execution only — This skill owns execution of azd up, azd deploy, terraform apply, and az deployment commands. These commands are run through this skill's error recovery and verification pipeline.

| Action | Reference

---|---|---
1 | Check Plan — Read .azure/plan.md, verify status = Validated AND Validation Proof section is populated | .azure/plan.md
2 | Pre-Deploy Checklist — MUST complete ALL steps | Pre-Deploy Checklist
3 | Load Recipe — Based on recipe.type in .azure/plan.md | recipes/README.md
4 | Execute Deploy — Follow recipe steps | Recipe README
5 | Post-Deploy — Configure SQL managed identity and apply EF migrations if applicable | Post-Deployment
6 | Handle Errors — See recipe's errors.md | —
7 | Verify Success — Confirm deployment completed and endpoints are accessible | Verification

⛔ VALIDATION PROOF CHECK

When checking the plan, verify the Validation Proof section (Section 7) contains actual validation results with commands run and timestamps. If this section is empty, validation was bypassed — invoke azure-validate skill first.

SDK Quick References

Azure Developer CLI : azd
Azure Identity : Python | .NET | TypeScript | Java

Tool	Purpose
`mcp_azure_mcp_subscription_list`	List available subscriptions
`mcp_azure_mcp_group_list`	List resource groups in subscription
`mcp_azure_mcp_azd`	Execute AZD commands

Troubleshooting - Common issues and solutions
Post-Deployment Steps - SQL + EF Core setup

Azure部署指南：从验证到执行的完整流程与最佳实践

🇨🇳中文介绍

Azure 部署

🇺🇸English

Azure Deploy

相关 Skills

触发条件

规则

步骤

| 操作 | 参考

SDK 快速参考

MCP 工具

参考

Triggers

Rules

Steps

| Action | Reference

SDK Quick References

MCP Tools

References