azure-deploy
熱門對已準備好的應用程式執行 Azure 部署，這些應用程式需具備現有的 .azure/deployment-plan.md 和基礎架構檔案。當使用者要求建立新應用程式時，請勿使用此技能 — 請改用 azure-prepare。此技能會執行 azd up、azd deploy、terraform apply 和 az deployment 指令，並內建錯誤復原機制。需要來自 azure-prepare 的 .azure/deployment-plan.md 以及來自 azure-validate 的驗證狀態。使用時機：「執行 azd up」、「執行 azd deploy」、「執行部署」、「推送至生產環境」、「推送至雲端」、「上線」、「發佈」、「bicep 部署」、「terraform apply」、「發佈至 Azure」、「在 Azure 上啟動」。請勿使用時機：「建立並部署」、「建置並部署」、「建立新應用程式」、「設定基礎架構」、「使用 Terraform 建立並部署至 Azure」— 這些情況請使用 azure-prepare。
對已準備好的應用程式執行 Azure 部署，這些應用程式需具備現有的 .azure/deployment-plan.md 和基礎架構檔案。當使用者要求建立新應用程式時，請勿使用此技能 — 請改用 azure-prepare。此技能會執行 azd up、azd deploy、terraform apply 和 az deployment 指令，並內建錯誤復原機制。需要來自 azure-prepare 的 .azure/deployment-plan.md 以及來自 azure-validate 的驗證狀態。使用時機：「執行 azd up」、「執行 azd deploy」、「執行部署」、「推送至生產環境」、「推送至雲端」、「上線」、「發佈」、「bicep 部署」、「terraform apply」、「發佈至 Azure」、「在 Azure 上啟動」。請勿使用時機：「建立並部署」、「建置並部署」、「建立新應用程式」、「設定基礎架構」、「使用 Terraform 建立並部署至 Azure」— 這些情況請使用 azure-prepare。
Azure Deploy
權威指引 — 強制遵守
先決條件：在執行此技能之前，必須先叫用並完成 azure-validate 技能，且狀態為
Validated。
⛔ 停止 — 需要檢查先決條件
在繼續之前，請確認兩個先決條件都已滿足：
- azure-prepare 已叫用並完成 →
.azure/deployment-plan.md存在- 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 管理（APIM）閘道基礎架構的應用程式
範圍：此技能負責執行部署。它不會建立應用程式、產生基礎架構程式碼或建立專案結構。對於這些任務，請使用 azure-prepare。
APIM / AI 閘道：使用此技能來部署那些在 azure-prepare 期間已建立 APIM/AI 閘道基礎架構的應用程式。如需建立或變更 APIM 資源，請參閱 APIM 部署指南。如需 AI 治理政策，請叫用 azure-aigateway 技能。
規則
- 在 azure-prepare 和 azure-validate 之後執行
.azure/deployment-plan.md必須存在且狀態為Validated- 需要部署前檢查清單 — 部署前檢查清單
- ⛔ 破壞性操作需要
ask_user— 全域規則 - 範圍：僅執行部署 — 此技能負責執行
azd up、azd deploy、terraform apply和az deployment指令。這些指令會透過此技能的錯誤復原和驗證管道來執行。
步驟
| # | 動作 | 參考資料 |
|---|---|---|
| 1 | 檢查計畫 — 讀取 .azure/deployment-plan.md，確認狀態 = Validated 且驗證證明區段已填寫 |
.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 | 報告結果 — 將部署的端點 URL 以完整 https:// 連結形式呈現給使用者 |
驗證 |
⛔ URL 格式規則
在向使用者呈現端點 URL 時，您必須始終使用包含
https://配置的完整 URL（例如https://myapp.azurewebsites.net，而不是myapp.azurewebsites.net）。許多 Azure CLI 指令會傳回不含配置的裸主機名稱 — 在呈現之前，請務必加上https://。
⛔ 驗證證明檢查
檢查計畫時，請確認驗證證明區段（第 7 節）包含實際的驗證結果，包括執行的指令和時間戳記。如果此區段為空，表示驗證被跳過 — 請先叫用 azure-validate 技能。
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） |
