azure-deploy

Azure Deploy

权威指南 — 必须遵守

前提条件：必须先调用 azure-validate 技能，并确认其状态为 Validated，然后才能执行此技能。

⛔ 停止 — 必须检查前提条件 继续操作前，请确认以下两项前提条件均已满足：

1. 已调用并完成 azure-prepare → .azure/deployment-plan.md 存在
2. 已调用并通过 azure-validate → 计划状态为 Validated

如果缺少任一项，立即停止：

• 没有计划？→ 先调用 azure-prepare 技能
• 状态不是 Validated？→ 先调用 azure-validate 技能

⛔ 请勿手动更新计划状态

严禁自行将计划状态更改为 Validated。只有 azure-validate 技能有权在执行实际验证检查后设置此状态。如果未经验证就更新状态，部署将会失败。

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

azure-prepare → azure-validate → azure-deploy

触发条件

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

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

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

APIM / AI 网关：使用此技能部署在 azure-prepare 期间已创建 APIM/AI 网关基础设施的应用。要创建或更改 APIM 资源，请参阅 APIM deployment guide。对于 AI 治理策略，请调用 azure-aigateway 技能。

规则

1. 在 azure-prepare 和 azure-validate 之后运行
2. .azure/deployment-plan.md 必须存在，且状态为 Validated
3. 必须完成部署前检查清单 — Pre-Deploy Checklist
4. ⛔ 破坏性操作必须使用 ask_user — global-rules
5. 范围：仅执行部署 — 此技能负责执行 azd up、azd deploy、terraform apply 和 az deployment 命令。这些命令通过此技能的错误恢复和验证流程运行。

---

步骤

#	操作	参考
1	检查计划 — 阅读 .azure/deployment-plan.md，确认状态为 Validated，并且 Validation Proof 部分已填写	.azure/deployment-plan.md
2	部署前检查清单 — 必须完成所有步骤	部署前检查清单
3	加载配方 — 根据 .azure/deployment-plan.md 中的 recipe.type 确定	recipes/README.md
4	RBAC 健康检查 — 对于使用托管标识的 Container Apps + ACR：运行 azd provision --no-prompt，然后确认 AcrPull 角色已传播，再继续操作（参见检查清单）	部署前检查清单 — Container Apps RBAC
5	执行部署 — 按照配方中的步骤操作	配方 README
6	部署后操作 — 配置 SQL 托管标识，并在适用时应用 EF 迁移	部署后操作
7	处理错误 — 参见配方中的 errors.md	—
8	验证成功 — 确认部署已完成且端点可访问	验证
9	实时角色验证 — 查询 Azure，确认已配置的 RBAC 角色正确且足够	live-role-verification.md
10	报告结果 — 向用户提供已部署端点的完整 https:// URL	验证

⛔ URL 格式规则

向用户提供端点 URL 时，必须始终使用包含 https:// 协议的完整 URL（例如 https://myapp.azurewebsites.net，而不是 myapp.azurewebsites.net）。许多 Azure CLI 命令返回的主机名不带协议 — 提供前务必加上 https://。

⛔ 验证证明检查

检查计划时，请确认 Validation Proof 部分（第 7 节）包含实际的验证结果、运行过的命令和时间戳。如果该部分为空，则说明绕过了验证 — 请先调用 azure-validate skill。

SDK 快速参考

• Azure Developer CLI：azd
• Azure Identity：Python | .NET | TypeScript | Java

MCP 工具

工具	用途
mcp_azure_mcp_subscription_list	列出可用订阅
mcp_azure_mcp_group_list	列出订阅中的资源组
mcp_azure_mcp_azd	执行 AZD 命令
azure__role	列出用于实时 RBAC 验证的角色分配（第 9 步）

参考资料

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