開始學習 Azure 技能

在這個快速入門中，你將利用 Azure 技能準備、驗證並部署應用程式到 Azure。

先決條件

  • Azure 技能安裝（安裝並設定 Azure 技能）
  • Azure CLI 認證（az login 成功完成）
  • GitHub Copilot CLI 或 Claude Code 隨時可用
  • 範例應用程式（或建立 Node.js 應用程式）

Scenario

你有一個 Node.js 應用程式。 你想將其部署到 Azure 時：

  • Web application hosting （Azure App 服務）
  • 應用程式資料的儲存帳號
  • 使用 Application Insights 進行監控

請準備您的申請

在你的 AI 助理中，進入專案目錄並發出指令：

Prepare my application for Azure deployment

技能：azure-prepare

  1. 分析你的程式碼庫
  2. 識別技術堆疊（Node.js、npm 等）
  3. 使用部署策略建立.azure/plan.md
  4. 以程式碼生成基礎設施
  5. 等待你的批准

檢視已產生的計畫

啟動 .azure/plan.md 並進行評論：

  • Project Information—應用程式名稱與部署模式
  • 需求—分類與規模（小型、中型、大型）
  • 元件—偵測到的技術
  • 部署策略——用於部署應用程式的技術（Azure開發者 CLI、Bicep、Terraform 或 Azure CLI）。
  • Architecture—已選定的Azure服務
  • 實施計畫——逐步任務

範例計畫內容：

# Azure Deployment Plan

## Project Information
- Application: my-app
- Mode: NEW

## Requirements
- Classification: Web Application
- Scale: Small
- Environment: Production

## Components
- Runtime: Node.js 18+
- Package Manager: NPM
- Application Type: Express web server

## Recipe
- Type: AZD (Azure Developer CLI)

## Azure Services
- Azure App Service (web app hosting)
- Azure Storage Account (data)
- Application Insights (monitoring)

## Status: Awaiting Approval

批准計畫

如果計畫看起來正確，請告訴你的 AI 助理：

Approve this plan and proceed to validation

指令將計畫狀態更新為 Approved，然後進入下一步。

小提示

如果技能不辨識你的專案類型，請確保你在專案根目錄中，並有可辨識的專案檔案（package.json、requirements.txt.csproj或類似格式）。

驗證部署計畫

你的 AI 助理會執行 azure-validate 這個技能來檢查：

  • Azure 命令列介面存取權限
  • Bicep 或 Terraform 範本語法（如適用）
  • Azure 訂閱及區域可用性
  • 服務配額限制
  • 你帳號的必要權限

驗證完成並在計畫中記錄所有檢查的證明。 計畫狀態更新為 Validated。

審查驗證結果

檢查 .azure/plan.md 的 驗證證明 部分，該部分顯示：

  • 執行的指令
  • 時間戳
  • 成績（通過或不及格）

範例：

## Validation Proof
- Command: azd provision --preview
- Timestamp: 2026-03-16T14:22:00Z
- Result: ✓ All validation checks passed

若驗證失敗，請檢視錯誤並請 AI 助理修正問題：

Fix the validation errors and try again

小提示

如果驗證失敗，請檢查你的 Azure 帳號是否具備所需權限，且計畫中指定的資源是否在你所選區域內可用。

部署到 Azure

當你的計畫被驗證後，請告訴你的 AI 助理：

Deploy my application to Azure

技能：azure-deploy

  1. 確認計畫狀態為 Validated
  2. Provisions Azure 資源（儲存、應用服務、監控）
  3. 部署你的應用程式代碼
  4. 配置應用程式設定
  5. 提供你的應用程式端點

部署通常需要3到5分鐘。

查看您已部署的應用程式

成功部署後，您的 AI 助理會提供：

  • 應用程式網址（用於 App Service）
  • 儲存帳號名稱與存取金鑰
  • Application Insights 偵測鍵

範例：

Deployment complete! 

Your app is live at: https://my-app-abcd1234.azurewebsites.net

Resources deployed:
- App Service: my-app-prod
- Storage Account: mystorageabcd1234
- Application Insights: my-app-insights

Monitor your app: https://portal.azure.com/...

要確認你的應用程式是否正在執行，請在瀏覽器中造訪你的應用程式網址。

小提示

如果部署失敗，請檢查錯誤輸出是否有權限或配額問題。 執行 az account show 以確認你是否已驗證至正確的訂閱。

確認您的部署

測試您的申請：

  1. 造訪您的網址——在瀏覽器中開啟應用程式的網址。
  2. 檢查監控—在 Application Insights 中查看日誌。
  3. 測試功能——使用應用程式的關鍵功能。

請詢問你的 AI 助理監控狀態：

Show me the application logs and performance metrics

您的 AI 助理會查詢應用程式洞察，並顯示近期活動、錯誤及效能資料。

更新和重新部署

如果你做了程式碼修改，請輕鬆重新部署：

  1. 在編輯器裡更新你的程式碼 。

  2. 請問你的 AI 助理：

    Update the deployment with my latest changes

  3. 這個技能會執行 azure-prepare 來檢查變更，然後 azure-deploy 更新你的資源。

更新的資源會重複利用現有基礎設施。 只有更換過的元件才會重新部署。

清理資源

當你不再需要應用程式時，刪除 Azure 資源以避免收費：

Delete all Azure resources for this application

你的 AI 助理：

  1. 列出需要刪除的資源（供您確認）
  2. 刪除資源群組及所有內容
  3. 確認清理完成

範例：

Resources to delete:
- Resource Group: my-app-rg
- All contained resources

Are you sure? (yes/no)

輸入 yes 以確認刪除。

Troubleshooting

部署失敗，因認證錯誤

Problem： 你的 AI 助理無法向 Azure 進行認證。

解決方案： 請使用 az login 重新驗證並重試。

計畫驗證失敗

Problem： Azure 技能報告驗證錯誤。

解決方案： 請你的 AI 助理審查並修正問題：

Why did validation fail? Fix the errors.

部署後應用程式無法存取

問題： 所提供的網址會回傳錯誤或逾時。

Solution:

  1. 請確認網址是否正確。

  2. 等 1-2 分鐘讓 DNS 傳播。

  3. 請檢查 Application Insights 日誌是否有錯誤。

    Show me recent errors in Application Insights

下一步

  • Last updated on