AZD для начинающих: структурированное учебное путешествие

Автоматические переводы (всегда актуально)

Предпочитаете клонировать локально?

В этом репозитории включено более 50 языковых переводов, что значительно увеличивает размер загрузки. Чтобы клонировать без переводов, используйте sparse checkout:

Bash / macOS / Linux:
git clone --filter=blob:none --sparse https://github.com/microsoft/AZD-for-beginners.git
cd AZD-for-beginners
git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'
CMD (Windows):
git clone --filter=blob:none --sparse https://github.com/microsoft/AZD-for-beginners.git
cd AZD-for-beginners
git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"
Это даст вам все необходимое для прохождения курса с гораздо более быстрой загрузкой.

🆕 Что нового в azd сегодня

Azure Developer CLI вышел за рамки традиционных веб-приложений и API. Сегодня azd — это универсальный инструмент для развертывания любого приложения в Azure — включая приложения с ИИ и интеллектуальных агентов.

Вот что это значит для вас:

ИИ-агенты теперь полноценные workloads azd. Вы можете инициализировать, развертывать и управлять проектами ИИ агентов, используя привычный рабочий процесс azd init → azd up.
Интеграция Microsoft Foundry добавляет развертывание моделей, хостинг агентов и конфигурацию ИИ-сервисов прямо в экосистему шаблонов azd.
Основной рабочий процесс не изменился. Будь то TODO-приложение, микросервис или многоагентное ИИ-решение — команды остаются одинаковыми.

Если вы уже использовали azd, поддержка ИИ — это естественное расширение, а не отдельный инструмент или сложная ветка. Если вы начинаете с нуля, вы выучите единую рабочую схему, которая подходит для всего.

🚀 Что такое Azure Developer CLI (azd)?

Azure Developer CLI (azd) — это удобный для разработчиков CLI-инструмент, который упрощает развертывание приложений в Azure. Вместо ручного создания и связывания множества ресурсов Azure вы можете развернуть целое приложение одной командой.

Волшебство команды `azd up`

# Эта команда делает всё:
# ✅ Создаёт все ресурсы в Azure
# ✅ Настраивает сеть и безопасность
# ✅ Собирает код вашего приложения
# ✅ Разворачивает в Azure
# ✅ Предоставляет вам рабочий URL
azd up

Вот и всё! Никаких кликов в Azure Portal, никаких сложных ARM-шаблонов, никаких ручных настроек — только работающие приложения в Azure.

❓ Azure Developer CLI или Azure CLI: в чем разница?

Это самый популярный вопрос у начинающих. Вот простой ответ:

Особенность	Azure CLI (`az`)	Azure Developer CLI (`azd`)
Назначение	Управление отдельными ресурсами Azure	Развертывание полноценных приложений
Подход	Ориентирован на инфраструктуру	Ориентирован на приложение
Пример	`az webapp create --name myapp...`	`azd up`
Сложность обучения	Нужно знать сервисы Azure	Нужно знать только ваше приложение
Для кого	DevOps, инфраструктура	Разработчики, прототипирование

Простая аналогия

Azure CLI — это как набор инструментов для строительства дома — молотки, пилы, гвозди. Можно построить что угодно, но нужно знать строительство.
Azure Developer CLI — это как нанять подрядчика — вы описываете, что хотите, а он занимается строительством.

Когда что использовать

Сценарий	Что использовать
"Хочу быстро развернуть веб-приложение"	`azd up`
"Мне нужно создать только учетную запись хранилища"	`az storage account create`
"Я строю полноценное ИИ-приложение"	`azd init --template azure-search-openai-demo`
"Мне нужно отладить конкретный ресурс Azure"	`az resource show`
"Хочу продакшен-развертывание за считанные минуты"	`azd up --environment production`

Они работают вместе!

AZD использует Azure CLI под капотом. Можно использовать оба:

# Разверните приложение с помощью AZD
azd up

# Затем тонко настройте конкретные ресурсы с помощью Azure CLI
az webapp config set --name myapp --always-on true

🌟 Найдите шаблоны в Awesome AZD

Не начинайте с нуля! Awesome AZD — это сообщество с коллекцией готовых к развертыванию шаблонов:

Ресурс	Описание
🔗 Галерея Awesome AZD	Просмотрите более 200 шаблонов с возможностью развернуть одним кликом
🔗 Отправить шаблон	Внесите свой шаблон в сообщество
🔗 Репозиторий GitHub	Поставьте звезду и изучите исходники

🎯 Начните в 3 шага

Перед началом убедитесь, что ваша машина готова для шаблона, который вы хотите развернуть:

Windows:

.\validate-setup.ps1

macOS / Linux:

bash ./validate-setup.sh

Если какой-то из тестов не проходит, исправьте это в первую очередь, а затем продолжайте быстрое начало.

Шаг 1: Установите AZD (2 минуты)

Windows:

winget install microsoft.azd

macOS:

brew tap azure/azd && brew install azd

Linux:

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

Шаг 2: Аутентификация для AZD

# Необязательно, если вы планируете использовать команды Azure CLI напрямую в этом курсе
az login

# Требуется для рабочих процессов AZD
azd auth login

Если вы не уверены, что именно вам нужно, пройдите полный процесс настройки в Установка и настройка.

Шаг 3: Разверните первое приложение

# Инициализировать из шаблона
azd init --template todo-nodejs-mongo

# Развернуть в Azure (создаёт всё!)
azd up

🎉 Готово! Ваше приложение теперь запущено в Azure.

Очистка ресурсов (не забудьте!)

# Remove all resources when done experimenting
azd down --force --purge

📚 Как использовать этот курс

Этот курс разработан для пошагового обучения — начните там, где вам удобно, и двигайтесь дальше:

Ваш опыт	Начните здесь
Новичок в Azure	Глава 1: Основы
Знаете Azure, новый в AZD	Глава 1: Основы
Хотите развернуть AI-приложения	Глава 2: Разработка с приоритетом ИИ
Желаете практики	🎓 Интерактивный воркшоп — 3–4 часа с наставником
Нужны продакшен-паттерны	Глава 8: Производство и корпоративные паттерны

Быстрая настройка

Форкните репозиторий:
Клонируйте: git clone https://github.com/YOUR-USERNAME/azd-for-beginners.git
Получите помощь: Сообщество Azure в Discord

Предпочитаете клонировать локально?

В этом репозитории включено более 50 языковых переводов, что значительно увеличивает размер загрузки. Чтобы клонировать без переводов, используйте sparse checkout:
git clone --filter=blob:none --sparse https://github.com/microsoft/AZD-for-beginners.git
cd AZD-for-beginners
git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'
Это даст вам все необходимое для прохождения курса с гораздо более быстрой загрузкой.

Обзор курса

Овладейте Azure Developer CLI (azd) через структурированные главы, разработанные для пошагового обучения. Особое внимание развертыванию AI-приложений с интеграцией Microsoft Foundry.

Почему этот курс важен для современных разработчиков

Основываясь на инсайтах сообщества Microsoft Foundry Discord, 45% разработчиков хотят использовать AZD для AI-задач, но сталкиваются с трудностями:

Сложными много-сервисными ИИ-архитектурами
Лучшей практикой развертывания ИИ в продакшене
Интеграцией и настройкой сервисов ИИ в Azure
Оптимизацией стоимости ИИ-задач
Отладкой специфичных проблем при развертывании ИИ

Цели обучения

После прохождения этого структурированного курса вы:

Овладеете основами AZD: основные концепции, установка и настройка
Развернете AI-приложения: используя AZD с сервисами Microsoft Foundry
Реализуете инфраструктуру как код: управление ресурсами Azure с помощью шаблонов Bicep
Будете устранять неполадки развертываний: решать общие проблемы и отлаживать ошибки
Оптимизируете для продакшена: безопасность, масштабирование, мониторинг и управление затратами
Создадите многоагентные решения: развертывание комплексных ИИ-архитектур

Перед началом: аккаунты, доступ и предпосылки

Перед началом главы 1 убедитесь, что у вас настроено следующее. Шаги установки далее в этом руководстве предполагают, что эти базовые моменты уже решены.

Подписка Azure: Вы можете использовать существующую подписку с работы или своей учетной записи, либо создать бесплатную пробную версию для начала.
Разрешение на создание ресурсов Azure: Для большинства упражнений вам потребуется как минимум доступ Contributor к целевой подписке или группе ресурсов. В некоторых главах также предполагается возможность создавать группы ресурсов, управляемые идентичности и назначения RBAC.
Учетная запись GitHub: Полезна для форка репозитория, отслеживания собственных изменений и использования GitHub Codespaces для мастер-класса.
Необходимые инструменты для шаблонов: Некоторые шаблоны требуют локальных инструментов, таких как Node.js, Python, Java или Docker. Перед началом запустите проверку установки, чтобы вовремя выявить отсутствующие инструменты.
Базовое знакомство с терминалом: Не нужно быть экспертом, но важно уметь запускать команды, такие как git clone, azd auth login и azd up.

Работаете в подписке предприятия?
Если ваша среда Azure управляется администратором, заранее уточните, можете ли вы развертывать ресурсы в подписке или группе ресурсов, которые планируете использовать. Если нет, запросите песочницу или доступ Contributor до начала работы.

Новичок в Azure?
Начните с собственной пробной подписки Azure или подписки с оплатой по мере использования на https://aka.ms/azurefreetrial, чтобы завершить упражнения полностью без ожидания одобрения на уровне арендатора.

🗺️ План курса: Быстрая навигация по главам

В каждой главе есть отдельный README с целями обучения, быстрыми стартами и упражнениями:

Глава	Тема	Уроки	Длительность	Сложность
Гл 1: Основа	Начало работы	Основы AZD \| Установка \| Первый проект	30-45 мин	⭐
Гл 2: Разработка AI	Приложения AI-первого уровня	Интеграция Foundry \| AI агенты \| Развертывание моделей \| Мастер-класс	1-2 часа	⭐⭐
Гл 3: Конфигурация	Аутентификация и безопасность	Конфигурация \| Аутентификация и безопасность	45-60 мин	⭐⭐
Гл 4: Инфраструктура	IaC и развертывание	Руководство по развертыванию \| Провижнинг	1-1.5 часа	⭐⭐⭐
Гл 5: Многоагентные решения	AI-агентские решения	Сценарий ритейл \| Шаблоны координации	2-3 часа	⭐⭐⭐⭐
Гл 6: Предварительное развертывание	Планирование и проверка	Проверки перед запуском \| Планирование мощности \| Выбор SKU \| Application Insights	1 час	⭐⭐
Гл 7: Устранение неполадок	Отладка и исправление	Распространенные проблемы \| Отладка \| Проблемы AI	1-1.5 часа	⭐⭐
Гл 8: Производство	Корпоративные шаблоны	Практики в производстве	2-3 часа	⭐⭐⭐⭐
🎓 Мастер-класс	Практическая лаборатория	Введение \| Выбор \| Проверка \| Разбор \| Конфигурация \| Кастомизация \| Демонтаж \| Итог	3-4 часа	⭐⭐

Общая длительность курса: ~10-14 часов | Прогресс навыков: Начинающий → Готов к производству

📚 Учебные главы

Выберите путь обучения в зависимости от уровня опыта и целей

🚀 Глава 1: Основа и быстрый старт

Требования: Подписка Azure, базовые знания командной строки
Длительность: 30-45 минут
Сложность: ⭐

Чему вы научитесь

Основы Azure Developer CLI
Установка AZD на вашу платформу
Первое успешное развертывание

Учебные материалы

🎯 Начать здесь: Что такое Azure Developer CLI?
📖 Теория: Основы AZD – основные концепции и терминология
⚙️ Установка: Установка и настройка – инструкции для платформ
🛠️ Практика: Ваш первый проект – пошаговое руководство
📋 Быстрый справочник: Шпаргалка по командам

Практические упражнения

# Быстрая проверка установки
azd version

# Разверните ваше первое приложение
azd init --template todo-nodejs-mongo
azd up

💡 Результат главы: Успешно развернуть простое веб-приложение в Azure с помощью AZD

✅ Критерии успеха:

# После завершения главы 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 агентам – развертывание интеллектуальных агентов с AZD
📖 Шаблоны: Развертывание AI моделей – развертывание и управление AI моделями
🛠️ Мастер-класс: Лабораторная работа с AI – подготовка AI решений к AZD
🎥 Интерактивное руководство: Материалы мастер-класса – обучение в браузере с MkDocs * DevContainer
📋 Шаблоны: Шаблоны Microsoft Foundry
📝 Примеры: Примеры развертывания AZD

Практические упражнения

# Разверните ваше первое приложение ИИ
azd init --template azure-search-openai-demo
azd up

# Попробуйте дополнительные шаблоны ИИ
azd init --template openai-chat-app-quickstart
azd init --template agent-openai-python-prompty

💡 Результат главы: Развернуть и настроить AI-чат-приложение с функциями RAG

✅ Критерии успеха:

# После главы 2 вы должны уметь:
azd init --template azure-search-openai-demo
azd up
# Тестировать интерфейс чата ИИ
# Задавать вопросы и получать ответы с поддержкой ИИ с указанием источников
# Проверять, что интеграция поиска работает
azd monitor  # Проверять, что Application Insights показывает телеметрию
azd down --force --purge

📊 Время: 1-2 часа
📈 Уровень навыков после: Умеет развертывать и настраивать производственные AI приложения
💰 Осведомленность о стоимости: Понимание затрат $80-150/мес на разработку, $300-3500/мес на производство

💰 Учет затрат при AI-развертывании

Среда разработки (примерно $80-150 в месяц):

Модели Microsoft Foundry (по подписке): $0-50/мес (зависит от использования токенов)
AI Search (базовый тариф): $75/мес
Container Apps (оплата за использование): $0-20/мес
Хранение (стандартное): $1-5/мес

Производственная среда (примерно $300-3500+ в месяц):

Модели Microsoft Foundry (PTU для стабильной производительности): $3000+/мес ИЛИ оплата по использованию с высоким трафиком
AI Search (стандартный тариф): $250/мес
Container Apps (выделенные): $50-100/мес
Application Insights: $5-50/мес
Хранение (премиум): $10-50/мес

💡 Советы по оптимизации затрат:

Используйте Microsoft Foundry Models Free Tier для обучения (включено 50 000 токенов Azure OpenAI)
Запускайте 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 шаблоны
Развернуть мультисервисные приложения
Реализовать стратегии развертывания blue-green

💡 Результат главы: Развертывать сложные мультисервисные приложения с использованием пользовательских инфраструктурных шаблонов

🎯 Глава 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 решением с агентами для клиентов и инвентаря

🔍 Глава 6: Предварительная проверка и планирование развертывания

Требования: Завершена глава 4
Длительность: 1 час
Сложность: ⭐⭐

Что вы изучите

Планирование емкости и проверка ресурсов
Стратегии выбора SKU
Предварительные проверки и автоматизация

Ресурсы для обучения

📊 Планирование: Планирование емкости - Проверка ресурсов
💰 Выбор: Выбор SKU - Экономичные решения
✅ Проверка: Предварительные проверки - Автоматизированные скрипты

Практические упражнения

Запуск скриптов проверки емкости
Оптимизация выбора SKU для снижения затрат
Реализация автоматизированных проверок перед развертыванием

💡 Результат главы: Проверять и оптимизировать развертывания до их выполнения

🚨 Глава 7: Поиск и устранение неисправностей

Требования: Завершение любой главы по развертыванию
Длительность: 1-1.5 часа
Сложность: ⭐⭐

Что вы изучите

Систематические подходы к отладке
Распространенные проблемы и их решения
Особенности устранения неполадок для AI

Ресурсы для обучения

🔧 Распространенные проблемы: Часто встречающиеся проблемы - FAQ и решения
🕵️ Отладка: Руководство по отладке - Пошаговые стратегии
🤖 Проблемы AI: Особенности устранения неполадок AI - Проблемы AI-сервисов

Практические упражнения

Диагностика сбоев развертывания
Решение проблем с аутентификацией
Отладка подключения AI-служб

💡 Результат главы: Самостоятельно диагностировать и устранять распространенные проблемы при развертывании

🏢 Глава 8: Производственные и корпоративные шаблоны

Требования: Завершение глав 1-4
Длительность: 2-3 часа
Сложность: ⭐⭐⭐⭐

Что вы изучите

Стратегии производственного развертывания
Корпоративные шаблоны безопасности
Мониторинг и оптимизация затрат

Ресурсы для обучения

🏭 Производство: Лучшие практики AI для производства - Корпоративные шаблоны
📝 Примеры: Пример микросервисов - Сложные архитектуры
📊 Мониторинг: Интеграция Application Insights - Мониторинг

Практические упражнения

Внедрение корпоративных шаблонов безопасности
Настройка комплексного мониторинга
Развертывание в производственной среде с корректным управлением

💡 Результат главы: Развертывать корпоративные приложения с полной производственной инфраструктурой

🎓 Обзор мастер-класса: Практический опыт обучения

⚠️ СТАТУС МАСТЕР-КЛАССА: Активная разработка
Материалы мастер-класса находятся в стадии разработки и доработки. Основные модули функциональны, но некоторые продвинутые разделы еще не завершены. Мы активно работаем над завершением всего контента. Отслеживать прогресс →

Интерактивные материалы мастер-класса

Полноценное практическое обучение с браузерными инструментами и пошаговыми упражнениями

Наши материалы мастер-класса предлагают структурированный интерактивный опыт, дополняющий учебный план по главам выше. Мастер-класс предназначен как для самостоятельного изучения, так и для занятий под руководством преподавателя.

🛠️ Особенности мастер-класса

Интерфейс в браузере: Полностью функционирующий мастер-класс на базе MkDocs с поиском, копированием и темами оформления
Интеграция GitHub Codespaces: Одним кликом настройка среды разработки
Структурированный учебный путь: 8 модулей с пошаговыми упражнениями (всего 3-4 часа)
Пошаговая методология: Введение → Выбор → Проверка → Разбор → Настройка → Кастомизация → Закрытие → Итоги
Интерактивная среда DevContainer: Преднастроенные инструменты и зависимости

📚 Структура модулей мастер-класса

Мастер-класс следует методологии из 8 прогрессивных модулей, которая ведет от изучения до мастерства в развертывании:

Модуль	Тема	Что вы сделаете	Длительность
0. Введение	Обзор мастер-класса	Ознакомитесь с учебными целями, требованиями и структурой мастер-класса	15 мин
1. Выбор	Поиск шаблона	Изучите шаблоны AZD и выберите подходящий AI шаблон для вашего сценария	20 мин
2. Проверка	Развертывание и проверка	Развернете шаблон с помощью `azd up` и проверите работу инфраструктуры	30 мин
3. Разбор	Понимание структуры	Используете GitHub Copilot для изучения архитектуры, файлов Bicep и организации кода	30 мин
4. Настройка	Глубокое изучение azure.yaml	Освоите конфигурацию `azure.yaml`, хуки жизненного цикла и переменные окружения	30 мин
5. Кастомизация	Станьте автором	Включите AI Search, трассировку, оценку и настройте под ваш сценарий	45 мин
6. Закрытие	Очистка	Безопасно удалите ресурсы с помощью `azd down --purge`	15 мин
7. Итоги	Следующие шаги	Подведете итоги, повторите ключевые концепции и продолжите обучение	15 мин

Ход мастер-класса:

Introduction → Selection → Validation → Deconstruction → Configuration → Customization → Teardown → Wrap-up
     ↓            ↓           ↓              ↓               ↓              ↓            ↓           ↓
  Overview    Find the     Deploy &      Explore        Master         Customize     Clean up    Review &
             right        verify        code &        azure.yaml      for your      resources   next steps
             template                   structure                     scenario

🚀 Начало работы с мастер-классом

# Вариант 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-агентами
Внедрить лучшие практики безопасности: Настроить аутентификацию и контроль доступа
Оптимизировать масштабируемость: Проектировать экономичные и производительные развертывания
Устранять проблемы при развертывании: Самостоятельно решать распространенные баги

📖 Ресурсы мастер-класса

🎥 Интерактивное руководство: Материалы мастер-класса - Обучение в браузере
📋 Пошаговые инструкции по модулю:
- 0. Введение - Обзор мастер-класса и цели
- 1. Выбор - Поиск и выбор AI-шаблонов
- 2. Проверка - Развертывание и проверка шаблонов
- 3. Разбор - Изучение архитектуры шаблона
- 4. Настройка - Освоение azure.yaml
- 5. Кастомизация - Настройка под ваш сценарий
- 6. Закрытие - Очистка ресурсов
- 7. Итоги - Подведение итогов и следующий шаг
🛠️ Лаборатория AI мастер-класса: AI Workshop Lab - Упражнения по AI
💡 Быстрый старт: Руководство по настройке мастер-класса - Конфигурация окружения

Идеально подходит для: Корпоративного обучения, вузовских курсов, самостоятельного изучения и специализированных курсов для разработчиков.

📖 Глубокое изучение возможностей AZD

Помимо основ, AZD предлагает мощные функции для производственных развертываний:

Развертывания по шаблонам - Используйте готовые шаблоны для популярных приложений
Инфраструктура как Код - Управляйте ресурсами Azure с помощью Bicep или Terraform
Интегрированные рабочие процессы - Плавное предоставление, развертывание и мониторинг приложений
Дружественный к разработчикам - Оптимизирован для продуктивности и удобства разработчиков

AZD + Microsoft Foundry: Идеальное решение для AI-развертываний

Почему AZD для AI-решений? AZD решает основные задачи, с которыми сталкиваются AI-разработчики:

Готовые AI-шаблоны - Преднастроенные шаблоны для Microsoft Foundry Models, Cognitive Services и ML-нагрузок
Безопасное развертывание AI - Встроенные паттерны безопасности для AI-сервисов, ключей API и точек доступа моделей
Производственные AI-шаблоны - Лучшие практики для масштабируемых и экономичных AI-приложений
Полный цикл AI - От разработки модели до производственного развертывания с мониторингом
Оптимизация затрат - Умное распределение ресурсов и масштабирование для AI-нагрузок
Интеграция с Microsoft Foundry - Легкое подключение к каталогу моделей и точкам доступа Foundry

🎯 Библиотека шаблонов и примеров

Рекомендуем: Шаблоны Microsoft Foundry

Начинайте здесь, если развертываете AI-приложения!

Примечание: Эти шаблоны демонстрируют различные AI-паттерны. Некоторые — это внешние Azure Samples, другие — локальные реализации.

Шаблон	Глава	Сложность	Сервисы	Тип
Начало работы с AI-чатом	Глава 2	⭐⭐	AzureOpenAI + Azure AI Model Inference API + Azure AI Search + Azure Container Apps + Application Insights	Внешний
Начало работы с AI-агентами	Глава 2	⭐⭐	Foundry Agents + AzureOpenAI + Azure AI Search + Azure Container Apps + Application Insights	Внешний
Демо Azure Search + OpenAI	Глава 2	⭐⭐	AzureOpenAI + Azure AI Search + App Service + Storage	Внешний
OpenAI Chat App Quickstart	Глава 2	⭐	AzureOpenAI + Container Apps + Application Insights	Внешний
Agent OpenAI Python Prompty	Глава 5	⭐⭐⭐	AzureOpenAI + Azure Functions + Prompty	Внешний
Contoso Chat RAG	Глава 8	⭐⭐⭐⭐	AzureOpenAI + AI Search + Cosmos DB + Container Apps	Внешний
Retail Multi-Agent Solution	Глава 5	⭐⭐⭐⭐	AzureOpenAI + AI Search + Storage + Container Apps + Cosmos DB	Локальный

Рекомендуем: Полные учебные сценарии

Готовые к производству шаблоны приложений, связанные с учебными главами

Шаблон	Учебная глава	Сложность	Основное обучение
openai-chat-app-quickstart	Глава 2	⭐	Основные паттерны AI-развертывания
azure-search-openai-demo	Глава 2	⭐⭐	Реализация RAG с Azure AI Search
ai-document-processing	Глава 4	⭐⭐	Интеграция Document Intelligence
agent-openai-python-prompty	Глава 5	⭐⭐⭐	Фреймворк агентов и вызов функций
contoso-chat	Глава 8	⭐⭐⭐	Корпоративная оркестровка AI
retail-multi-agent-solution	Глава 5	⭐⭐⭐⭐	Мультиагентная архитектура с агентами Customer и Inventory

Обучение по типу примеров

📌 Локальные vs. Внешние примеры:
Локальные примеры (в этом репозитории) = готовы к немедленному использованию
Внешние примеры (Azure Samples) = клонировать из связанных репозиториев

Локальные примеры (Готовы к использованию)

Retail Multi-Agent Solution - Полная производственная реализация с ARM-шаблонами
- Мультиагентная архитектура (агенты Customer + Inventory)
- Комплексный мониторинг и оценка
- Однокликовое развертывание через ARM-шаблон

Локальные примеры - Приложения в контейнерах (главы 2-5)

Полные примеры развертывания контейнеров в этом репозитории:

Примеры Container App - Полное руководство по развертыванию контейнеров
- Простой Flask API - Базовый REST API с масштабированием до нуля
- Архитектура микросервисов - Производственное много-сервисное развертывание
- Быстрый старт, производственные и продвинутые паттерны развертывания
- Руководства по мониторингу, безопасности и оптимизации затрат

Внешние примеры - Простые приложения (главы 1-2)

Клонируйте эти репозитории Azure Samples для начала работы:

Простое веб-приложение - Node.js + MongoDB - Основные паттерны развертывания
Статический сайт - React SPA - Развертывание статического контента
Container App - Python Flask - Развертывание REST API

Внешние примеры - Интеграция базы данных (главы 3-4)

Приложение базы данных - C# + SQL - Шаблоны подключения к базе данных
Функции + Cosmos DB - Безсерверный поток данных

Внешние примеры - Расширенные шаблоны (главы 4-8)

Java микросервисы - Многосервисные архитектуры
Задания контейнерных приложений - Фоновая обработка
Корпоративный ML pipeline - Готовые к производству шаблоны машинного обучения

Внешние коллекции шаблонов

Официальная галерея шаблонов AZD - Курированная коллекция официальных и сообществных шаблонов
Шаблоны Azure Developer CLI - Документация по шаблонам Microsoft Learn
Каталог примеров - Локальные обучающие примеры с подробными объяснениями

📚 Ресурсы для обучения и справочные материалы

Быстрые ссылки

Справочник команд - Основные команды azd, организованные по главам
Глоссарий - Терминология Azure и azd
Часто задаваемые вопросы (FAQ) - Часто задаваемые вопросы по главам обучения
Руководство по обучению - Комплексные практические упражнения

Практические мастер-классы

Мастерская по ИИ - Сделайте свои ИИ-решения пригодными для развертывания через AZD (2-3 часа)
Интерактивный мастер-класс - 8 модулей с пошаговыми упражнениями с MkDocs и GitHub Codespaces
- Следует: Введение → Выбор → Валидация → Декомпозиция → Конфигурация → Настройка → Завершение → Итог

Внешние ресурсы для обучения

Документация Azure Developer CLI: https://learn.microsoft.com/en-us/azure/developer/azure-developer-cli/
Центр архитектуры Azure: https://learn.microsoft.com/en-us/azure/architecture/
Калькулятор стоимости Azure: https://azure.microsoft.com/pricing/calculator/
Статус Azure: https://status.azure.com/

Навыки AI-агентов для вашего редактора

Навыки Microsoft Azure на skills.sh - 37 открытых навыков агента для Azure AI, Foundry, деплоймента, диагностики, оптимизации затрат и многое другое. Установите их в GitHub Copilot, Cursor, Claude Code или любой поддерживаемый агент:
```
npx skills add microsoft/github-copilot-for-azure
```

🔧 Быстрый гид по устранению неполадок

Распространённые проблемы, с которыми сталкиваются новички, и быстрые решения:

❌ "azd: команда не найдена"

# Сначала установите 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

❌ "InsufficientQuota" или "Квота превышена"

# Попробуйте другой регион Azure
azd env set AZURE_LOCATION "westus2"
azd up

# Или используйте меньшие SKU в разработке
# Отредактируйте infra/main.parameters.json:
{
  "sku": "B1"  // Instead of "P1V2"
}

❌ Ошибка выполнения "azd up" на середине процесса

# Вариант 1: Очистить и повторить попытку
azd down --force --purge
azd up

# Вариант 2: Просто исправить инфраструктуру
azd provision

# Вариант 3: Проверить подробный статус
azd show

# Вариант 4: Проверить журналы в Azure Monitor
azd monitor --logs

❌ "Ошибка аутентификации" или "Истёк срок действия токена"

# Повторная аутентификация для AZD
azd auth logout
azd auth login

# Необязательно: обновите Azure CLI, если вы используете команды az
az logout
az login

# Проверка аутентификации
az account show

❌ "Ресурс уже существует" или конфликты имён

# AZD генерирует уникальные имена, но при конфликте:
azd down --force --purge

# Затем повторите попытку с новым окружением
azd env new dev-v2
azd up

❌ Развертывание шаблона занимает слишком много времени

Нормальное время ожидания:

Простое веб-приложение: 5-10 минут
Приложение с базой данных: 10-15 минут
ИИ-приложения: 15-25 минут (провижининг OpenAI происходит медленно)

# Проверить прогресс
azd show

# Если застряли более 30 минут, проверьте Azure Portal:
azd monitor --overview
# Ищите неудачные развертывания

❌ "Доступ запрещён" или "Forbidden"

# Проверьте вашу роль в Azure
az role assignment list --assignee $(az account show --query user.name -o tsv)

# Вам нужна как минимум роль "Contributor"
# Попросите администратора Azure предоставить:
# - Contributor (для ресурсов)
# - User Access Administrator (для назначения ролей)

❌ Не удаётся найти URL развернутого приложения

# Показать все конечные точки сервиса
azd show

# Или открыть Azure Portal
azd monitor

# Проверить конкретный сервис
azd env get-values
# Искать переменные *_URL

📚 Полные ресурсы по устранению неполадок

Руководство по распространённым проблемам: Подробные решения
Проблемы, связанные с ИИ: Устранение неполадок ИИ
Руководство по отладке: Пошаговая отладка
Получить помощь: Discord Azure #azure-developer-cli

🎓 Завершение курса и сертификация

Отслеживание прогресса

Отслеживайте свой прогресс по каждой главе:

Глава 1: Основы и быстрый старт ✅
Глава 2: Разработка с приоритетом ИИ ✅
Глава 3: Конфигурация и аутентификация ✅
Глава 4: Инфраструктура как код и развертывание ✅
Глава 5: Мультиагентные ИИ решения ✅
Глава 6: Предварительная валидация и планирование ✅
Глава 7: Устранение неполадок и отладка ✅
Глава 8: Производственные и корпоративные шаблоны ✅

Проверка знаний

После каждой главы подтвердите свои знания, выполнив:

Практическое задание: Выполните практическое развертывание главы
Проверка знаний: Ознакомьтесь с разделом FAQ для вашей главы
Обсуждение в сообществе: Поделитесь опытом в Azure Discord
Следующая глава: Продвигайтесь к следующему уровню сложности

Преимущества завершения курса

По окончании всех глав у вас будет:

Опыт производства: Развернутые реальные ИИ-приложения в Azure
Профессиональные навыки: Способности к развертыванию корпоративного уровня
Признание в сообществе: Активное участие в сообществе разработчиков Azure
Карьера и развитие: Востребованные знания по AZD и ИИ-развёртыванию

🤝 Сообщество и поддержка

Получить помощь и поддержку

Технические проблемы: Сообщить об ошибках и запросить функциональность
Вопросы по обучению: Сообщество Microsoft Azure Discord и
Помощь по ИИ: Присоединяйтесь к
Документация: Официальная документация Azure Developer CLI

Информация от сообщества Microsoft Foundry Discord

Результаты недавнего опроса на канале #Azure:

45% разработчиков хотят использовать AZD для ИИ-задач
Основные сложности: Развертывания многосервисных приложений, управление учетными данными, готовность к производству
Самые востребованные: ИИ-специфические шаблоны, руководства по устранению неполадок, лучшие практики

Присоединяйтесь к нашему сообществу, чтобы:

Делиться опытом с AZD + ИИ и получать помощь
Получать предварительный доступ к новым ИИ-шаблонам
Вносить вклад в лучшие практики развертывания ИИ
Влиять на будущее развитие функций ИИ + AZD

Вклад в курс

Мы рады вашим предложениям! Пожалуйста, ознакомьтесь с нашим Руководством по участию для деталей:

Улучшение контента: Дополняйте существующие главы и примеры
Новые примеры: Добавляйте реальные сценарии и шаблоны
Переводы: Помогайте поддерживать многоязычную поддержку
Сообщения об ошибках: Повышайте точность и ясность
Стандарты сообщества: Соблюдайте инклюзивные правила сообщества

📄 Информация о курсе

Лицензия

Этот проект лицензирован под лицензией MIT - смотрите файл LICENSE для подробностей.

Связанные ресурсы Microsoft Learn

Наша команда выпускает и другие комплексные обучающие курсы:

LangChain

Azure / Edge / MCP / Агенты

Серия Generative AI

Основное обучение

Серия Copilot

🗺️ Навигация по курсу

🚀 Готовы начать обучение?

Новички: Начните с Глава 1: Основы и Быстрый старт
Разработчики ИИ: Перейдите к Глава 2: Разработка с приоритетом ИИ
Опытные разработчики: Начинайте с Глава 3: Конфигурация и Аутентификация

Следующие шаги: Начать Глава 1 - Основы AZD →

Отказ от ответственности: Этот документ был переведен с помощью сервиса автоматического перевода Co-op Translator. Хотя мы стараемся обеспечить точность, пожалуйста, имейте в виду, что автоматический перевод может содержать ошибки или неточности. Оригинальный документ на исходном языке следует считать официальным источником. Для важной информации рекомендуется профессиональный перевод человеком. Мы не несем ответственности за любые недоразумения или неправильные толкования, возникшие в результате использования этого перевода.

FilesExpand file tree

README.md

Latest commit

History

README.md

File metadata and controls

AZD для начинающих: структурированное учебное путешествие

Автоматические переводы (всегда актуально)

🆕 Что нового в azd сегодня

🚀 Что такое Azure Developer CLI (azd)?

Волшебство команды azd up

❓ Azure Developer CLI или Azure CLI: в чем разница?

Простая аналогия

Когда что использовать

Они работают вместе!

🌟 Найдите шаблоны в Awesome AZD

Популярные шаблоны AI из Awesome AZD

🎯 Начните в 3 шага

Шаг 1: Установите AZD (2 минуты)

Шаг 2: Аутентификация для AZD

Шаг 3: Разверните первое приложение

Очистка ресурсов (не забудьте!)

📚 Как использовать этот курс

Быстрая настройка

Обзор курса

Почему этот курс важен для современных разработчиков

Цели обучения

Перед началом: аккаунты, доступ и предпосылки

🗺️ План курса: Быстрая навигация по главам

📚 Учебные главы

🚀 Глава 1: Основа и быстрый старт

Чему вы научитесь

Учебные материалы

Практические упражнения

🤖 Глава 2: Разработка AI-первого уровня (рекомендуется для разработчиков AI)

Чему вы научитесь

Учебные материалы

Практические упражнения

💰 Учет затрат при AI-развертывании

⚙️ Глава 3: Конфигурация и аутентификация

Чему вы научитесь

Учебные материалы

Практические упражнения

🏗️ Глава 4: Инфраструктура как код и развертывание

Чему вы научитесь

Учебные материалы

Практические упражнения

🎯 Глава 5: Многоагентные AI решения (продвинутый уровень)

Чему вы научитесь

Учебные материалы

Практические упражнения

🔍 Глава 6: Предварительная проверка и планирование развертывания

Что вы изучите

Ресурсы для обучения

Практические упражнения

🚨 Глава 7: Поиск и устранение неисправностей

Что вы изучите

Ресурсы для обучения

Практические упражнения

🏢 Глава 8: Производственные и корпоративные шаблоны

Что вы изучите

Ресурсы для обучения

Практические упражнения

🎓 Обзор мастер-класса: Практический опыт обучения

Интерактивные материалы мастер-класса

🛠️ Особенности мастер-класса

📚 Структура модулей мастер-класса

🚀 Начало работы с мастер-классом

🎯 Результаты обучения мастер-класса

📖 Ресурсы мастер-класса

📖 Глубокое изучение возможностей AZD

AZD + Microsoft Foundry: Идеальное решение для AI-развертываний

🎯 Библиотека шаблонов и примеров

Рекомендуем: Шаблоны Microsoft Foundry

Рекомендуем: Полные учебные сценарии

Обучение по типу примеров

Локальные примеры (Готовы к использованию)

Локальные примеры - Приложения в контейнерах (главы 2-5)

Внешние примеры - Простые приложения (главы 1-2)

Внешние примеры - Интеграция базы данных (главы 3-4)

Волшебство команды `azd up`