AZD 入门：结构化学习之旅

开始本课程

按照以下步骤开始您的 AZD 学习之旅：

1. 派生（Fork）仓库: Click
2. 克隆仓库: git clone https://github.com/microsoft/azd-for-beginners.git
3. 加入社区: Azure Discord Communities 获取专家支持
4. 选择您的学习路径: 从下面选择与您经验水平匹配的章节

多语言支持

自动翻译（始终保持最新）

阿拉伯语 | 孟加拉语 | 保加利亚语 | 缅甸语（Myanmar） | 中文（简体） | 中文（繁体，香港） | 中文（繁体，澳门） | 中文（繁体，台湾） | 克罗地亚语 | 捷克语 | 丹麦语 | 荷兰语 | 爱沙尼亚语 | 芬兰语 | 法语 | 德语 | 希腊语 | 希伯来语 | 印地语 | 匈牙利语 | 印度尼西亚语 | 意大利语 | 日语 | 卡纳达语 | 韩语 | 立陶宛语 | 马来语 | 马拉雅拉姆语 | 马拉地语 | 尼泊尔语 | 尼日利亚皮钦语 | 挪威语 | 波斯语（Farsi） | 波兰语 | 葡萄牙语（巴西） | 葡萄牙语（葡萄牙） | 旁遮普语（Gurmukhi） | 罗马尼亚语 | 俄语 | 塞尔维亚语（西里尔） | 斯洛伐克语 | 斯洛文尼亚语 | 西班牙语 | 斯瓦希里语 | 瑞典语 | 塔加洛语（菲律宾语） | 泰米尔语 | 泰卢固语 | 泰语 | 土耳其语 | 乌克兰语 | 乌尔都语 | 越南语

课程概览

通过结构化章节掌握 Azure Developer CLI（azd），实现循序渐进的学习。特别关注与 Microsoft Foundry 集成的 AI 应用部署。

为什么本课程对现代开发者至关重要

根据 Microsoft Foundry Discord 社区的见解，45% 的开发者希望使用 AZD 进行 AI 工作负载，但遇到以下挑战：

• 复杂的多服务 AI 架构
• 生产环境 AI 部署最佳实践
• Azure AI 服务的集成与配置
• AI 工作负载的成本优化
• AI 特定部署问题的故障排除

学习目标

完成本结构化课程后，您将：

• 掌握 AZD 基础：核心概念、安装与配置
• 部署 AI 应用：将 AZD 与 Microsoft Foundry 服务结合使用
• 实施基础设施即代码：使用 Bicep 模板管理 Azure 资源
• 排查部署问题：解决常见问题并进行调试
• 优化生产环境：安全、扩展、监控与成本管理
• 构建多智能体解决方案：部署复杂的 AI 架构

学习章节

根据经验水平和目标选择学习路径

第1章：基础与快速入门

先决条件：Azure 订阅、基本命令行知识
时长：30-45 分钟
复杂度：⭐

你将学到的内容

• 了解 Azure Developer CLI 的基础知识
• 在你的平台上安装 AZD
• 你的首次成功部署

学习资源

• ** 开始这里**: 什么是 Azure Developer CLI？
• ** 理论**: AZD 基础 - 核心概念和术语
• ⚙️ 设置: 安装与设置 - 平台特定指南
• ️ 实践: 你的第一个项目 - 逐步教程
• ** 快速参考**: 命令备忘单

实践练习

# 快速安装检查
azd version

# 部署你的第一个应用程序
azd init --template todo-nodejs-mongo
azd up
​

** 章节成果**：使用 AZD 成功将一个简单的 Web 应用部署到 Azure

✅ 成功验证：

# 完成第1章后，您应该能够：
azd version              # 显示已安装的版本
azd init --template todo-nodejs-mongo  # 初始化项目
azd up                  # 部署到 Azure
azd show                # 显示正在运行的应用的 URL
# 应用在浏览器中打开并正常工作
azd down --force --purge  # 清理资源
​

** 时间投入：** 30-45 分钟
** 完成后技能水平：** 能够独立部署基本应用

✅ 成功验证：

# 完成第1章后，您应该能够：
azd version              # 显示已安装的版本
azd init --template todo-nodejs-mongo  # 初始化项目
azd up                  # 部署到 Azure
azd show                # 显示运行中应用的 URL
# 应用在浏览器中打开并正常运行
azd down --force --purge  # 清理资源
​

** 时间投入：** 30-45 分钟
** 完成后技能水平：** 能够独立部署基本应用

第2章：以 AI 为先的开发（推荐给 AI 开发者）

先决条件：已完成第1章
时长：1-2 小时
复杂度：⭐⭐

你将学到的内容

• Microsoft Foundry 与 AZD 的集成
• 部署 AI 驱动的应用
• 理解 AI 服务配置

学习资源

• ** 开始这里**: Microsoft Foundry 集成
• ** 模式**: AI 模型部署 - 部署和管理 AI 模型
• ️ 研讨会: AI 工作坊实验室 - 使你的 AI 解决方案准备就绪以使用 AZD
• ** 交互式指南**: 工作坊材料 - 基于浏览器的 MkDocs * DevContainer 环境学习
• ** 模板**: Microsoft Foundry 模板
• ** 示例**: AZD 部署示例

实践练习

# 部署你的第一个 AI 应用
azd init --template azure-search-openai-demo
azd up

# 试用更多 AI 模板
azd init --template openai-chat-app-quickstart
azd init --template agent-openai-python-prompty
​

** 章节成果**：部署并配置具有 RAG 能力的 AI 聊天应用

✅ 成功验证：

# 在第2章之后，你应该能够：
azd init --template azure-search-openai-demo
azd up
# 测试 AI 聊天界面
# 提出问题并获得带有来源的 AI 驱动回复
# 验证搜索集成是否正常工作
azd monitor  # 检查 Application Insights 是否显示遥测数据
azd down --force --purge
​

** 时间投入：** 1-2 小时
** 完成后技能水平：** 能够部署和配置生产就绪的 AI 应用
** 成本意识：** 了解开发环境约 $80-150/月，生产环境约 $300-3500/月

AI 部署的成本考虑

开发环境（估计 $80-150/月）：

• Azure OpenAI（按需付费）：$0-50/月（基于令牌使用量）
• AI Search（基础层）：$75/月
• 容器应用（消费型）：$0-20/月
• 存储（标准）：$1-5/月

生产环境（估计 $300-3,500+/月）：

• Azure OpenAI（PTU 提供一致性能）：$3,000+/月 OR 高使用量下按需付费
• AI Search（标准层）：$250/月
• 容器应用（专用）：$50-100/月
• Application Insights：$5-50/月
• 存储（高级）：$10-50/月

** 成本优化建议：**

• 在学习时使用 Azure OpenAI 免费层（包含 50,000 个令牌/月）
• azd down 在不开发时释放资源
• 从按使用量计费开始，仅在生产环境中升级到 PTU
• 使用 azd provision --preview 在部署前估算成本
• 启用自动扩展：只为实际使用付费

成本监控：

# 检查估算的每月费用
azd provision --preview

# 在 Azure 门户中监控实际费用
az consumption budget list --resource-group <your-rg>
​

⚙️ 第3章：配置与认证

先决条件：已完成第1章
时长：45-60 分钟
复杂度：⭐⭐

你将学到的内容

• 环境配置与管理
• 认证与安全最佳实践
• 资源命名与组织

学习资源

• ** 配置**: 配置指南 - 环境设置
• ** 安全**: 认证模式与托管身份 - 认证模式
• ** 示例**: 数据库应用示例 - AZD 数据库示例

实践练习

• 配置多个环境（dev、staging、prod）
• 设置托管身份认证
• 实施环境特定配置

** 章节成果**：通过适当的认证和安全措施管理多个环境

️ 第4章：基础设施即代码与部署

先决条件：已完成第1-3章
时长：1-1.5 小时
复杂度：⭐⭐⭐

你将学到的内容

• 高级部署模式
• 使用 Bicep 的基础设施即代码
• 资源供给策略

学习资源

• ** 部署**: 部署指南 - 完整工作流
• ️ 供给: 资源供给 - Azure 资源管理
• ** 示例**: 容器应用示例 - 容器化部署

实践练习

• 创建自定义 Bicep 模板
• 部署多服务应用
• 实施蓝绿部署策略

** 章节成果**：使用自定义基础设施模板部署复杂的多服务应用

第5章：多智能体 AI 解决方案（高级）

先决条件：已完成第1-2章
时长：2-3 小时
复杂度：⭐⭐⭐⭐

你将学到的内容

• 多智能体架构模式
• 智能体编排与协调
• 面向生产的 AI 部署

学习资源

• ** 特别项目**: 零售多智能体解决方案 - 完整实现
• ️ ARM 模板: ARM 模板包 - 一键部署
• ** 架构**: 多代理协调模式 - 模式

实践练习

# 部署完整的零售多代理解决方案
cd examples/retail-multiagent-arm-template
./deploy.sh

# 探索代理配置
az deployment group show --resource-group <rg-name> --name <deployment-name>
​

** 章节成果**: 部署并管理一个生产就绪的多代理 AI 解决方案（包含 Customer 和 Inventory 代理）

第 6 章: Pre-Deployment Validation & Planning

先决条件: 已完成第 4 章
持续时间: 1 小时
复杂度: ⭐⭐

你将学习到

• 容量规划与资源验证
• SKU 选择策略
• 部署前检查与自动化

学习资源

• ** 规划**: 容量规划 - 资源验证
• ** 选择**: SKU 选择 - 成本优化的选择
• ✅ 验证: 部署前检查 - 自动化脚本

实践练习

• 运行容量验证脚本
• 为成本优化 SKU 选择
• 实现自动化的部署前检查

** 章节成果**: 在执行前验证并优化部署

第 7 章: Troubleshooting & Debugging

先决条件: 已完成任一部署章节
持续时间: 1-1.5 小时
复杂度: ⭐⭐

你将学习到

• 系统化的调试方法
• 常见问题及解决方案
• AI 特有的故障排查

学习资源

• ** 常见问题**: 常见问题 - 常见问答与解决方案
• ️ 调试: 调试指南 - 分步策略
• ** AI 问题**: AI 专用故障排查 - AI 服务问题

实践练习

• 诊断部署失败
• 解决身份验证问题
• 调试 AI 服务连接性

** 章节成果**: 能够独立诊断并解决常见部署问题

第 8 章: Production & Enterprise Patterns

先决条件: 已完成第 1-4 章
持续时间: 2-3 小时
复杂度: ⭐⭐⭐⭐

你将学习到

• 生产环境部署策略
• 企业级安全模式
• 监控与成本优化

学习资源

• ** 生产**: 生产 AI 最佳实践 - 企业模式
• ** 示例**: 微服务示例 - 复杂架构
• ** 监控**: Application Insights integration - 监控

实践练习

• 实施企业安全模式
• 建立全面的监控
• 在适当治理下部署到生产环境

** 章节成果**: 部署具备完整生产能力的企业级应用

Workshop Overview: Hands-On Learning Experience

⚠️ 研讨会状态：开发中
研讨会材料目前正在开发和完善中。核心模块可用，但某些高级部分尚未完成。我们正在积极完成所有内容。 查看进展 →

交互式研讨会材料

使用基于浏览器的工具和引导练习进行的全面动手学习

我们的研讨会材料提供结构化、互动的学习体验，补充上述基于章节的课程。该研讨会既适合自学也适合讲师主导的课堂。

️ 研讨会特色

• 基于浏览器的界面: 完整的 MkDocs 驱动研讨会，具有搜索、复制和主题功能
• GitHub Codespaces 集成: 一键开发环境设置
• 结构化学习路径: 7 步引导练习 (3.5 hours total)
• 发现 → 部署 → 定制: 渐进式方法论
• 交互式 DevContainer 环境: 预配置的工具和依赖项

研讨会结构

研讨会遵循 发现 → 部署 → 定制 方法论:

1. 发现阶段 (45 mins)

   • 探索 Microsoft Foundry 模板和服务
   • 了解多代理架构模式
   • 审查部署要求和先决条件

2. 部署阶段 (2 hours)

   • 使用 AZD 动手部署 AI 应用
   • 配置 Azure AI 服务和端点
   • 实施安全和身份验证模式

3. 定制阶段 (45 mins)

   • 为特定用例修改应用
   • 为生产部署进行优化
   • 实施监控和成本管理

Getting Started with the Workshop

# 选项 1：GitHub Codespaces（推荐）
# 在仓库中点击 "Code" → "Create codespace on main"

# 选项 2：本地开发
git clone https://github.com/microsoft/azd-for-beginners.git
cd azd-for-beginners/workshop
# 按照 workshop/README.md 中的设置说明进行操作
​

研讨会学习成果

完成研讨会后，参与者将：

• 部署生产 AI 应用: 使用 AZD 结合 Microsoft Foundry 服务
• 掌握多代理架构: 实现协调的 AI 代理解决方案
• 实施安全最佳实践: 配置身份验证和访问控制
• 面向规模优化: 设计具成本效益且高性能的部署
• 排查部署问题: 独立解决常见问题

研讨会资源

• ** 交互式指南**: 研讨会材料 - 基于浏览器的学习环境
• ** 分步说明**: 引导练习 - 详细操作指南
• ️ AI 研讨会实验室: AI 研讨会实验室 - 以 AI 为中心的练习
• ** 快速开始**: 研讨会设置指南 - 环境配置

非常适合: 企业培训、大学课程、自主学习以及开发者训练营。

What is Azure Developer CLI?

Azure Developer CLI (azd) 是面向开发者的命令行界面，可加速将应用构建并部署到 Azure 的过程。它提供：

• 基于模板的部署 - 使用预构建模板针对常见应用模式
• 基础设施即代码 - 使用 Bicep 或 Terraform 管理 Azure 资源
• 集成化工作流 - 无缝地预配、部署和监控应用
• 开发者友好 - 针对开发者的生产力和体验进行了优化

AZD + Microsoft Foundry: Perfect for AI Deployments

为什么为 AI 解决方案选择 AZD？ AZD 解决了 AI 开发者面临的主要挑战：

• AI 就绪模板 - 为 Azure OpenAI、Cognitive Services 和 ML 工作负载预配置的模板
• 安全的 AI 部署 - 为 AI 服务、API 密钥和模型端点提供内置安全模式
• 生产级 AI 模式 - 可扩展且具成本效益的 AI 应用部署最佳实践
• 端到端 AI 工作流 - 从模型开发到具备适当监控的生产部署
• 成本优化 - 针对 AI 工作负载的智能资源分配和扩缩策略
• Microsoft Foundry 集成 - 与 Microsoft Foundry 模型目录和端点的无缝连接

模板与示例库

精选：Microsoft Foundry 模板

如果你正在部署 AI 应用，请从这里开始！

注意： 这些模板展示了各种 AI 模式。有些来自外部 Azure 示例，另一些是本地实现。

精选：完整学习场景

与学习章节对应的生产就绪应用模板

按示例类型学习

** 本地与外部示例：**
本地示例（在此仓库中）= 可立即使用
外部示例（Azure 示例）= 从链接的仓库克隆

本地示例（可立即使用）

• 零售多代理解决方案 - 包含 ARM 模板的完整生产就绪实现
  • 多代理架构（Customer + Inventory 代理）
  • 全面的监控与评估
  • 通过 ARM 模板一键部署

本地示例 - 容器应用（第 2-5 章）

本仓库中的全面容器部署示例：

• 容器应用示例 - 容器化部署完整指南
  • Simple Flask API - 支持 scale-to-zero 的基本 REST API
  • Microservices Architecture - 生产就绪的多服务部署
  • Quick Start, Production, and Advanced deployment patterns
  • Monitoring, security, and cost optimization guidance

外部示例 - 简单应用（第 1-2 章）

克隆这些 Azure 示例仓库以开始：

• Simple Web App - Node.js + MongoDB - 基本部署模式
• Static Website - React SPA - 静态内容部署
• Container App - Python Flask - REST API 部署

外部示例 - 数据库集成（第 3-4 章）

• Database App - C# + SQL - 数据库连接模式
• Functions + Cosmos DB - 无服务器数据工作流

外部示例 - 高级模式（第 4-8 章）

• Java Microservices - 多服务架构
• Container Apps Jobs - 后台处理
• Enterprise ML Pipeline - 生产就绪的 ML 模式

外部模板合集

• 官方 AZD 模板库 - 官方与社区的精选模板集合
• Azure Developer CLI Templates - Microsoft Learn 模板文档
• 示例目录 - 包含详细说明的本地学习示例

学习资源与参考

快速参考

• 命令 速查表 - 按章节组织的常用 azd 命令
• 术语表 - Azure 和 azd 术语
• 常见问题 - 按学习章节组织的常见问题
• 学习指南 - 综合练习题

动手工作坊

• AI 工作坊实验室 - 使您的 AI 解决方案支持 AZD 部署 (2-3 hours)
• 交互式工作坊指南 - 基于浏览器的工作坊，使用 MkDocs 和 DevContainer 环境
• Structured Learning Path -7-step 引导练习 (Discovery → Deployment → Customization)
• AZD 初学者工作坊 - 完整的动手工作坊材料，集成 GitHub Codespaces

外部学习资源

• Azure Developer CLI Documentation
• Azure Architecture Center
• Azure Pricing Calculator
• Azure Status

快速故障排除指南

初学者常见问题及即时解决方案：

❌ "azd: command not found"

# 先安装 AZD
# Windows（PowerShell）：
winget install microsoft.azd

# macOS：
brew tap azure/azd && brew install azd

# Linux：
curl -fsSL https://aka.ms/install-azd.sh | bash

# 验证安装
azd version
​

❌ "No subscription found" or "Subscription not set"

# 列出可用的订阅
az account list --output table

# 设置默认订阅
az account set --subscription "<subscription-id-or-name>"

# 为 AZD 环境设置
azd env set AZURE_SUBSCRIPTION_ID "<subscription-id>"

# 验证
az account show
​

❌ "InsufficientQuota" or "Quota exceeded"

# 尝试不同的 Azure 区域
azd env set AZURE_LOCATION "westus2"
azd up

# 或在开发环境中使用更小的 SKU
# 编辑 infra/main.parameters.json:
{
  "sku": "B1"  // Instead of "P1V2"
}
​

❌ "azd up" fails halfway through

# 选项 1: 清理并重试
azd down --force --purge
azd up

# 选项 2: 仅修复基础设施
azd provision

# 选项 3: 检查详细日志
azd show
azd logs
​

❌ "Authentication failed" or "Token expired"

# 重新验证身份
az logout
az login

azd auth logout
azd auth login

# 验证身份
az account show
​

❌ "Resource already exists" or naming conflicts

# AZD 会生成唯一名称，但如果发生冲突：
azd down --force --purge

# 然后在新的环境中重试
azd env new dev-v2
azd up
​

❌ Template deployment taking too long

正常等待时间：

• 简单 Web 应用：5-10 分钟
• 带数据库的应用：10-15 分钟
• AI 应用：15-25 分钟（OpenAI 配置较慢）

# 检查进度
azd show

# 如果卡住超过30分钟，请检查 Azure 门户:
azd monitor
# 查看失败的部署
​

❌ "Permission denied" or "Forbidden"

# 检查你的 Azure 角色
az role assignment list --assignee $(az account show --query user.name -o tsv)

# 你至少需要参与者（Contributor）角色
# 请让你的 Azure 管理员授予：
# - 参与者（用于资源）
# - 用户访问管理员（用于角色分配）
​

❌ Can't find deployed application URL

# 显示所有服务端点
azd show

# 或打开 Azure 门户
azd monitor

# 检查特定服务
azd env get-values
# 查找 *_URL 变量
​

完整故障排除资源

• 常见问题指南： 详细解决方案
• AI 专项问题： AI 故障排除
• 调试指南： 逐步调试
• 获取帮助： Azure Discord #azure-developer-cli

快速故障排除指南

初学者常见问题及即时解决方案：

# 首先安装 AZD
# Windows（PowerShell）:
winget install microsoft.azd

# macOS:
brew tap azure/azd && brew install azd

# Linux:
curl -fsSL https://aka.ms/install-azd.sh | bash

# 验证安装
azd version
​

# 列出可用订阅
az account list --output table

# 设置默认订阅
az account set --subscription "<subscription-id-or-name>"

# 为 AZD 环境设置
azd env set AZURE_SUBSCRIPTION_ID "<subscription-id>"

# 验证
az account show
​

# 尝试不同的 Azure 区域
azd env set AZURE_LOCATION "westus2"
azd up

# 或在开发环境中使用更小的 SKU
# 编辑 infra/main.parameters.json:
{
  "sku": "B1"  // Instead of "P1V2"
}
​

# 选项 1：清理并重试
azd down --force --purge
azd up

# 选项 2：仅修复基础设施
azd provision

# 选项 3：检查详细日志
azd show
azd logs
​

# 重新验证身份
az logout
az login

azd auth logout
azd auth login

# 验证身份
az account show
​

# AZD 生成唯一名称，但如果冲突：
azd down --force --purge

# 则在新的环境中重试
azd env new dev-v2
azd up
​

# 检查进度
azd show

# 如果卡住超过30分钟，请检查 Azure 门户：
azd monitor
# 查找失败的部署
​

# 检查您的 Azure 角色
az role assignment list --assignee $(az account show --query user.name -o tsv)

# 您至少需要 "Contributor" 角色
# 请让您的 Azure 管理员授予:
# - Contributor (用于资源)
# - User Access Administrator (用于角色分配)
​

# 显示所有服务端点
azd show

# 或打开 Azure 门户
azd monitor

# 检查特定服务
azd env get-values
# 查找 *_URL 变量
​

完整故障排除资源

• 常见问题指南： 详细解决方案
• AI 专项问题： AI 故障排除
• 调试指南： 逐步调试
• 获取帮助： Azure Discord #azure-developer-cli

课程完成与认证

进度跟踪

跟踪您在每章的学习进度：

• 第 1 章: 基础与快速开始 ✅
• 第 2 章: AI 优先开发 ✅
• 第 3 章: 配置与身份验证 ✅
• 第 4 章: 基础设施即代码与部署 ✅
• 第 5 章: 多代理 AI 解决方案 ✅
• 第 6 章: 部署前验证与规划 ✅
• 第 7 章: 故障排除与调试 ✅
• 第 8 章: 生产与企业模式 ✅

学习验证

完成每章后，通过以下方式验证您的知识：

1. 实操练习： 完成本章的动手部署
2. 知识检测： 查看本章的常见问题部分
3. 社区讨论： 在 Azure Discord 分享您的经验
4. 下一章： 进入下一个难度级别

课程完成收益

完成所有章节后，您将获得：

• 生产经验： 将真实 AI 应用部署到 Azure
• 专业技能： 企业级部署能力
• 社区认可： 成为活跃的 Azure 开发者社区成员
• 职业发展： 受市场欢迎的 AZD 与 AI 部署专长

社区与支持

获取帮助与支持

• 技术问题： 报告 Bug 和请求功能
• 学习问题： Microsoft Azure Discord 社区 和
• AI 专项帮助： 加入
• 文档： 官方 Azure Developer CLI 文档

来自 Microsoft Foundry Discord 的社区见解

来自 #Azure 频道的最新投票结果：

• 45% 的开发者希望将 AZD 用于 AI 工作负载
• 主要挑战： 多服务部署、凭据管理、生产就绪性
• 最常被请求： AI 专用模板、故障排除指南、最佳实践

加入我们的社区以：

• 分享您的 AZD + AI 经验并获得帮助
• 获取 AI 新模板的早期预览
• 为 AI 部署最佳实践做出贡献
• 影响未来 AI + AZD 功能的开发

为课程做出贡献

我们欢迎贡献！请阅读我们的 Contributing Guide 以了解详细信息：

• 内容改进： 增强现有章节和示例
• 新示例： 添加真实场景和模板
• 翻译： 协助维护多语言支持
• 错误报告： 提高准确性与清晰度
• 社区规范： 遵循我们的包容性社区指南

课程信息

License

本项目遵循 MIT 许可证 - 详情请参见 LICENSE 文件。

相关的 Microsoft 学习资源

我们的团队还制作了其他完整的学习课程：

LangChain

Azure / Edge / MCP / Agents

生成式 AI 系列

核心学习

Copilot 系列

️ 课程导航

** 准备开始学习？**

初学者: 从 第 1 章：基础与快速入门
AI 开发者: 跳至 第 2 章：以 AI 为先的开发
有经验的开发者: 从 第 3 章：配置与身份验证 开始

下一步: 开始第 1 章 - AZD 基础 →

免责声明：

本文件已使用 AI 翻译服务 Co-op Translator 进行翻译。尽管我们力求准确，但请注意，自动翻译可能包含错误或不准确之处。以原始语言撰写的原文应被视为权威来源。对于重要信息，建议采用专业人工翻译。对于因使用本翻译而产生的任何误解或曲解，我们概不负责。