通过

Azure技能入门

在本快速入门中，你将使用 Azure 技能 准备、验证和部署应用程序到 Azure。

先决条件

  • 已安装Azure Skills（Install 并配置 Azure Skills）
  • Azure CLI身份验证（az login成功完成）
  • GitHub Copilot CLI 或 Claude Code 可供使用
  • 示例应用程序（或创建 Node.js 应用）

情景

你有一个 Node.js 应用程序。 你希望将其部署到Azure，

  • Web 应用程序托管（Azure 应用服务）
  • 应用程序数据的存储帐户
  • 使用 Application Insights 进行监视

准备好应用程序

在你的人工智能助手中，转到你的项目目录然后询问：

Prepare my application for Azure deployment

技能 azure-prepare ：

  1. 分析代码库
  2. 标识技术堆栈（Node.js、npm 等）
  3. 创建.azure/plan.md并使用部署策略
  4. 生成代码化基础设施
  5. 等待审批

查看生成的计划

打开 .azure/plan.md 并查看：

  • 项目信息 — 应用名称和部署模式
  • 要求——分类和规模（小型、中型、大型）
  • 组件 - 检测到的技术
  • 部署策略 — 用于部署应用程序的技术（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 CLI访问和权限
  • 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. 预配Azure资源（存储、应用服务、监视）
  3. 部署应用程序代码
  4. 配置应用程序设置
  5. 提供应用程序终结点

部署通常需要 3-5 分钟。

查看已部署的应用程序

成功部署后，AI 助手提供：

  • 应用程序 URL （适用于应用服务）
  • 存储帐户名称和访问密钥
  • 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/...

若要验证应用是否正在运行，请在浏览器中访问应用程序 URL。

小窍门

如果部署失败，请检查错误输出中是否存在权限或配额问题。 运行 az account show 来验证您是否已对正确的订阅进行身份验证。

验证部署

测试应用程序：

  1. 访问 URL - 在浏览器中打开应用程序 URL。
  2. 检查监控 - 在 Application Insights 中查看日志。
  3. 测试功能 - 使用应用的关键功能。

询问您的 AI 助手的监控状态：

Show me the application logs and performance metrics

AI 助手查询 Application Insights 并显示最近的活动、错误和性能数据。

更新和重新部署

如果进行代码更改，请轻松重新部署：

  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 以确认删除。

故障排除

部署失败并出现身份验证错误

Problem： AI 助手无法对Azure进行身份验证。

解决 方案： 使用 az login 并重试重新进行身份验证。

计划验证失败

Problem： Azure Skills 报告验证错误。

解决 方案： 请让 AI 助手查看并解决问题：

Why did validation fail? Fix the errors.

部署后无法访问应用程序

问题： 提供的 URL 返回错误或超时。

Solution:

  1. 验证 URL 是否正确。

  2. 等待 1-2 分钟以完成 DNS 传播。

  3. 检查 Application Insights 日志中是否存在错误。

    Show me recent errors in Application Insights

后续步骤

  • Last updated on