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 — включно з додатками на базі ШІ та інтелектуальними агентами.

Ось що це означає для вас:

Агенти ШІ тепер є першокласними робочими навантаженнями azd. Ви можете ініціалізувати, розгортати та керувати проектами агентів ШІ за допомогою того ж робочого процесу azd init → azd up, який ви вже знаєте.
Інтеграція Microsoft Foundry приносить розгортання моделей, хостинг агентів і конфігурацію сервісів ШІ безпосередньо у шаблонну екосистему azd.
Основний робочий процес не змінився. Незалежно від того, чи розгортаєте ви todo-додаток, мікросервіс або мультиагентне рішення ШІ, команди залишаються однаковими.

Якщо ви вже використовували azd раніше, підтримка ШІ — це природне розширення, а не окремий інструмент чи просунутий курс. Якщо ви починаєте з нуля, ви вивчите один робочий процес, який підходить для всього.

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

Azure Developer CLI (azd) — це зручний для розробників інструмент командного рядка, який спрощує розгортання додатків у 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`
"Створюю повний AI-додаток"	`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 Gallery	Переглядайте понад 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: Основа
Хочете розгортати ШІ-додатки	Розділ 2: Розробка з акцентом на ШІ
Потрібна практична робота	🎓 Інтерактивний воркшоп — 3-4 години керованої практики
Потрібні шаблони для продакшна	Розділ 8: Продакшн та корпоративні шаблони

Швидке налаштування

Форкніть цей репозиторій:
Клонувати: git clone https://github.com/YOUR-USERNAME/azd-for-beginners.git
Отримати допомогу: Azure Discord Community

Віддаєте перевагу клонуванню локально?

Цей репозиторій містить понад 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) через структуровані розділи, розроблені для поступового навчання. Особлива увага приділяється розгортанню ШІ-додатків з інтеграцією Microsoft Foundry.

Чому цей курс необхідний сучасним розробникам

Базуючись на інсайтах спільноти Microsoft Foundry Discord, 45% розробників хочуть використовувати AZD для робочих навантажень ШІ, але стикаються з труднощами:

Складні мультисервісні архітектури ШІ
Кращі практики продакшн-розгортання ШІ
Інтеграція та налаштування сервісів Azure AI
Оптимізація витрат для навантажень ШІ
Усунення проблем специфічних для розгортання ШІ

Навчальні цілі

Завершивши цей структурований курс, ви:

Оволодієте основами 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?
Почніть з власної пробної або платної підписки 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 \| App 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-First (Рекомендовано для 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 Models (оплата за використання): $0-50/місяць (залежно від кількості токенів)
AI Search (базовий рівень): $75/місяць
Container Apps (за споживанням): $0-20/місяць
Сховище (стандартне): $1-5/місяць

Середовище продакшн (приблизно $300-3,500+/місяць):

Microsoft Foundry Models (PTU для стабільної продуктивності): $3,000+/місяць АБО оплата за використання при великому обсязі
AI Search (стандартний рівень): $250/місяць
Container Apps (виділені): $50-100/місяць
Application Insights: $5-50/місяць
Сховище (преміум): $10-50/місяць

💡 Поради щодо оптимізації витрат:

Використовуйте Microsoft Foundry Models в безкоштовному рівні для навчання (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
📝 Приклади: Приклад Container App - контейнери для розгортань

Практичні вправи

Створення кастомних 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
Перевірки перед запуском та автоматизація

Навчальні ресурси

📊 Планування: Capacity Planning - Валідація ресурсів
💰 Вибір: SKU Selection - Вигідний вибір
✅ Валідація: Pre-flight Checks - Автоматичні скрипти

Практичні вправи

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

💡 Результат розділу: Валідувати та оптимізувати розгортання перед запуском

🚨 Розділ 7: Виправлення помилок та налагодження

Передумови: будь-який завершений розділ з розгортання
Тривалість: 1-1.5 години
Складність: ⭐⭐

Чого ви навчитеся

Систематичні підходи до налагодження
Типові проблеми та їх вирішення
Особливості налагодження AI-систем

Навчальні ресурси

🔧 Типові проблеми: Common Issues - FAQ та рішення
🕵️ Налагодження: Debugging Guide - Покрокові стратегії
🤖 Проблеми AI: AI-Specific Troubleshooting - Проблеми AI-сервісів

Практичні вправи

Діагностика збоїв розгортання
Вирішення проблем автентифікації
Налагодження з’єднаності AI-сервісів

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

🏢 Розділ 8: Продакшн та корпоративні шаблони

Передумови: виконано розділи 1-4
Тривалість: 2-3 години
Складність: ⭐⭐⭐⭐

Чого ви навчитеся

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

Навчальні ресурси

🏭 Продакшн: Production AI Best Practices - Корпоративні шаблони
📝 Приклади: Microservices Example - Складні архітектури
📊 Моніторинг: Application Insights integration - Моніторинг

Практичні вправи

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

💡 Результат розділу: Розгортати додатки корпоративного класу з повним функціоналом продакшн

🎓 Огляд воркшопу: Практичне навчання

⚠️ СТАТУС ВОРКШОПУ: Активна розробка
Матеріали воркшопу знаходяться на стадії розробки та доопрацювання. Основні модулі працюють, але деякі розділи ще не закінчені. Ми активно працюємо над завершенням всього контенту. Стежити за прогресом →

Інтерактивні матеріали воркшопу

Повноцінне практичне навчання з інструментами в браузері та керованими вправами

Наші матеріали пропонують структурований, інтерактивний досвід навчання, що доповнює вищенаведену навчальну програму по розділах. Воркшоп розрахований як на самостійне вивчення, так і на заняття під керівництвом викладача.

🛠️ Особливості воркшопу

Інтерфейс у браузері: повноцінний воркшоп на 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-агентські рішення
Впроваджувати найкращі практики безпеки: Налаштовувати автентифікацію і контроль доступу
Оптимізувати масштабування: Проєктувати ефективні за вартістю, продуктивні розгортання
Виправляти проблеми розгортання: Самостійно вирішувати типові проблеми

📖 Ресурси воркшопу

🎥 Інтерактивний гід: Workshop Materials - Навчальне середовище у браузері
📋 Інструкції по модулях:
- 0. Introduction - Огляд воркшопу та цілі
- 1. Selection - Вибір AI-шаблонів
- 2. Validation - Розгортання і перевірка шаблонів
- 3. Deconstruction - Огляд архітектури шаблонів
- 4. Configuration - Оволодіння azure.yaml
- 5. Customization - Налаштування для вашого сценарію
- 6. Teardown - Очищення ресурсів
- 7. Wrap-up - Підсумки та подальші кроки
🛠️ Лабораторія AI воркшопу: AI Workshop Lab - Вправи з AI
💡 Швидкий старт: Workshop Setup Guide - Налаштування середовища

Ідеально підходить для: корпоративного навчання, університетських курсів, самостійного вивчення та буткемпів для розробників.

📖 Детальний огляд можливостей AZD

Окрім базових функцій, AZD пропонує потужні можливості для продакшн-розгортання:

Розгортання на основі шаблонів - Використовуйте готові шаблони для типових шаблонів додатків
Інфраструктура як код - Керуйте ресурсами Azure за допомогою Bicep або Terraform
Інтегровані робочі процеси - Плавно створюйте, розгортайте та моніторте додатки
Зручність для розробників - Оптимізовано для продуктивності та досвіду розробників

AZD + Microsoft Foundry: Ідеально для AI-розгортань

Чому AZD для AI-рішень? AZD вирішує ключові проблеми розробників AI:

Шаблони, готові до AI - Попередньо налаштовані шаблони для моделей Microsoft Foundry, когнітивних сервісів і ML-навантажень
Безпечні AI-розгортання - Вбудовані патерни безпеки для AI-сервісів, API-ключів і кінцевих точок моделей
Продакшн шаблони AI - Кращі практики для масштабованих, економічних AI-додатків
End-to-End AI робочі процеси - Від розробки моделей до продакшн-розгортання з моніторингом
Оптимізація вартості - Інтелектуальне виділення ресурсів та стратегії масштабування для AI-навантажень
Інтеграція з Microsoft Foundry - Безшовне підключення до каталогу моделей і кінцевих точок Microsoft Foundry

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

Рекомендовані: Microsoft Foundry шаблони

Починайте звідси, якщо розгортаєте AI-додатки!

Примітка: Ці шаблони демонструють різні AI-патерни. Деякі — зовнішні Azure Samples, інші — локальні реалізації.

Шаблон	Розділ	Складність	Сервіси	Тип
Get started with AI chat	Розділ 2	⭐⭐	AzureOpenAI + Azure AI Model Inference API + Azure AI Search + Azure Container Apps + Application Insights	Зовнішній
Get started with AI agents	Розділ 2	⭐⭐	Foundry Agents + AzureOpenAI + Azure AI Search + Azure Container Apps + Application Insights	Зовнішній
Azure Search + OpenAI Demo	Розділ 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	⭐⭐⭐⭐	Мультиагентна архітектура з агентами Клієнта і Інвентаризації

Навчання через тип прикладу

📌 Локальні vs. Зовнішні приклади:
Локальні приклади (у цьому репозиторії) = Готові до використання одразу
Зовнішні приклади (Azure Samples) = Клонувати з прив’язаних репозиторіїв

Локальні приклади (готові до використання)

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

Локальні приклади - Контейнерні додатки (Розділи 2-5)

Повні приклади розгортання контейнерів у цьому репозиторії:

Container App Examples - Повний посібник по контейнеризованих розгортаннях
- Простий 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 мікросервіси - Архітектури з кількома сервісами
Завдання Container Apps - Фонове опрацювання
Потік ML для підприємств - Патерни ML, готові до виробництва

Зовнішні колекції шаблонів

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

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

Швидкі посилання

Шпаргалка команд - Основні команди azd, організовані за розділами
Глосарій - Терміни Azure та azd
FAQ - Часті запитання, організовані за навчальними розділами
Посібник для вивчення - Комплексні практичні вправи

Практичні майстер-класи

Майстерня AI Workshop Lab - Зробіть свої AI-рішення сумісними з AZD (2-3 години)
Інтерактивний майстер-клас - 8-модульні керовані вправи з MkDocs і GitHub Codespaces
- Послідовність: Вступ → Вибір → Перевірка → Деконструкція → Конфігурація → Налаштування → Завершення → Підсумок

Зовнішні ресурси для навчання

Документація Azure Developer CLI: посилання
Центр архітектури Azure: посилання
Калькулятор цін Azure: посилання
Стан Azure: посилання

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

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

🔧 Короткий посібник з усунення несправностей

Поширені проблеми у початківців та швидкі рішення:

❌ "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" або "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" або "Quota exceeded"

# Спробуйте інший регіон 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

❌ "Authentication failed" або "Token expired"

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

# Опціонально: оновіть Azure CLI, якщо ви виконуєте команди az
az logout
az login

# Перевірте автентифікацію
az account show

❌ "Resource already exists" або конфлікти імен

# AZD генерує унікальні імена, але якщо виникає конфлікт:
azd down --force --purge

# Тоді повторіть спробу з новим середовищем
azd env new dev-v2
azd up

❌ Розгортання шаблону зайняло надто багато часу

Нормальні часи очікування:

Проста вебпрограма: 5-10 хвилин
Програма з базою даних: 10-15 хвилин
AI-додатки: 15-25 хвилин (протягування OpenAI повільне)

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

# Якщо зависло більше 30 хвилин, перевірте Azure Portal:
azd monitor --overview
# Шукайте невдалі розгортання

❌ "Permission denied" або "Forbidden"

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

# Вам потрібна принаймні роль "Учасник"
# Попросіть свого адміністратора Azure надати:
# - Учасник (для ресурсів)
# - Адміністратор доступу користувачів (для призначень ролей)

❌ Не вдається знайти URL розгорнутого застосунку

# Показати всі кінцеві точки сервісу
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: Виробничі та корпоративні патерни ✅

Перевірка знань

Після завершення кожного розділу перевірте свої знання шляхом:

Практичної вправи: Виконайте практичне розгортання розділу
Перевірки знань: Ознайомлення з розділом FAQ для цього розділу
Обговорень у спільноті: Поділіться своїм досвідом у Azure Discord
Наступного розділу: Переходьте до наступного рівня складності

Переваги завершення курсу

Після завершення усіх розділів ви отримаєте:

Досвід виробництва: Розгорнуті реальні AI-додатки в Azure
Професійні навички: Можливість розгортання, готова для підприємств
Визнання у спільноті: Активний учасник спільноти розробників Azure
Просування кар’єри: Популярні знання AZD та розгортання AI

🤝 Спільнота та підтримка

Отримання допомоги та підтримки

Технічні питання: Повідомлення про помилки та запити функцій
Питання навчання: Спільнота Microsoft Azure Discord та
Допомога по AI: Приєднуйтесь до
Документація: Офіційна документація Azure Developer CLI

Враження спільноти від Microsoft Foundry Discord

Останні результати опитування у каналі #Azure:

45% розробників хочуть використовувати AZD для AI робочих навантажень
Найпоширеніші виклики: Розгортання з кількома сервісами, керування обліковими даними, готовність до виробництва
Найбільш запитані: AI-специфічні шаблони, посібники з усунення несправностей, найкращі практики

Приєднуйтесь до нашої спільноти, щоб:

Ділитися досвідом AZD + AI та отримувати допомогу
Мати доступ до ранніх прев’ю нових AI-шаблонів
Робити внесок у найкращі практики розгортання AI
Впливати на майбутній розвиток AI + AZD

Внесок у курс

Ми вітаємо ваш внесок! Будь ласка, прочитайте наш Посібник з внеску для деталей щодо:

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

📄 Інформація про курс

Ліцензія

Цей проєкт ліцензований за ліцензією MIT - дивіться файл LICENSE для деталей.

Пов’язані навчальні ресурси Microsoft

Наша команда створює інші комплексні навчальні курси:

LangChain

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

Серія Генеративного AI

Основи навчання

Серія Copilot

🗺️ Навігація курсом

🚀 Готові почати навчання?

Початківці: Почніть з Розділ 1: Основи та швидкий старт
Розробники AI: Перейдіть до Розділ 2: Розробка з орієнтацією на AI
Досвідчені розробники: Почніть з Розділ 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

Популярні ШІ-шаблони від Awesome AZD

🎯 Початок роботи за 3 кроки

Крок 1: Встановіть AZD (2 хвилини)

Крок 2: Авторизуйтеся для AZD

Крок 3: Розгорніть свій перший додаток

Очищення (не забудьте!)

📚 Як користуватися цим курсом

Швидке налаштування

Огляд курсу

Чому цей курс необхідний сучасним розробникам

Навчальні цілі

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

🗺️ Карта курсу: Швидка навігація за розділами

📚 Навчальні розділи

🚀 Розділ 1: Основи та швидкий старт

Чого ви навчитеся

Навчальні ресурси

Практичні вправи

🤖 Розділ 2: Розробка AI-First (Рекомендовано для AI-розробників)

Чого ви навчитеся

Навчальні ресурси

Практичні вправи

💰 Витрати на розгортання AI

⚙️ Розділ 3: Конфігурація та аутентифікація

Чого ви навчитеся

Навчальні ресурси

Практичні вправи

🏗️ Розділ 4: Інфраструктура як код і розгортання

Чого ви навчитеся

Навчальні ресурси

Практичні вправи

🎯 Розділ 5: Багатоагентні AI рішення (Просунутий рівень)

Чого ви навчитеся

Навчальні ресурси

Практичні вправи

🔍 Розділ 6: Передрозгортання: Верифікація і планування

Чого ви навчитеся

Навчальні ресурси

Практичні вправи

🚨 Розділ 7: Виправлення помилок та налагодження

Чого ви навчитеся

Навчальні ресурси

Практичні вправи

🏢 Розділ 8: Продакшн та корпоративні шаблони

Чого ви навчитеся

Навчальні ресурси

Практичні вправи

🎓 Огляд воркшопу: Практичне навчання

Інтерактивні матеріали воркшопу

🛠️ Особливості воркшопу

📚 Структура модулів воркшопу

🚀 Початок роботи з воркшопом

🎯 Результати навчання воркшопу

📖 Ресурси воркшопу

📖 Детальний огляд можливостей AZD

AZD + Microsoft Foundry: Ідеально для AI-розгортань

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

Рекомендовані: Microsoft Foundry шаблони

Рекомендовані: Комплексні сценарії навчання

Навчання через тип прикладу

Локальні приклади (готові до використання)

Локальні приклади - Контейнерні додатки (Розділи 2-5)

Зовнішні приклади - Простий додаток (Розділи 1-2)

Зовнішні приклади - Інтеграція з базою даних (Розділи 3-4)

Магія `azd up`