Azure Developer CLI | The .NET Blog

Хуки azd на Python, TypeScript и .NET: прощай, shell-скрипты

Emiliano Montesdeoca — Thu, 23 Apr 2026 00:00:00 +0000

Этот пост был автоматически переведён. Для оригинальной версии нажмите здесь.

Если вы когда-нибудь вели проект полностью на .NET и всё равно писали Bash-скрипты для хуков azd — вы знаете эту боль. Зачем переходить к синтаксису shell в шаге pre-provisioning, когда весь остальной проект написан на C#?

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

Что такое хуки

Хуки — это скрипты, выполняемые в ключевых точках жизненного цикла azd — до провизионинга, после деплоя и не только. Они определяются в azure.yaml и позволяют внедрять пользовательскую логику без изменений в CLI.

Раньше поддерживались только Bash и PowerShell. Теперь можно использовать Python, JavaScript, TypeScript или .NET — остальное azd обрабатывает автоматически.

Как работает определение языка

Просто укажите хук на файл, и azd определит язык по расширению:

hooks:
 preprovision:
 run: ./hooks/setup.py
 postdeploy:
 run: ./hooks/seed.ts
 postprovision:
 run: ./hooks/migrate.cs

Дополнительная конфигурация не нужна. При неоднозначном расширении можно явно указать kind: python (или нужный язык).

Важные детали по языкам

Python

Разместите requirements.txt или pyproject.toml рядом со скриптом (или в родительской директории). azd автоматически создаёт виртуальное окружение, устанавливает зависимости и запускает скрипт.

JavaScript и TypeScript

Тот же принцип — package.json рядом со скриптом, и azd сначала выполнит npm install. Для TypeScript используется npx tsx без этапа компиляции и без tsconfig.json.

.NET

Два режима:

Режим проекта: если рядом со скриптом есть .csproj, azd автоматически выполнит dotnet restore и dotnet build.
Single-file режим: на .NET 10+ автономные .cs-файлы запускаются напрямую через dotnet run script.cs. Файл проекта не нужен.

Конфигурация по исполнителю

Каждый язык поддерживает опциональный блок config:

hooks:
 preprovision:
 run: ./hooks/setup.ts
 config:
 packageManager: pnpm
 postprovision:
 run: ./hooks/migrate.cs
 config:
 configuration: Release
 framework: net10.0

Почему это важно для .NET-разработчиков

Хуки были последним местом в проекте на базе azd, где приходилось менять язык. Теперь весь деплой-пайплайн — от кода приложения до lifecycle-хуков — может жить в одном языке. Можно переиспользовать существующие .NET-утилиты, ссылаться на общие библиотеки и забыть про поддержку shell-скриптов.

Итог

Одно из тех изменений, что выглядят незначительными, но убирают много трения из повседневной работы с azd. Поддержка нескольких языков для хуков доступна прямо сейчас — подробная документация в официальном посте.

azd + GitHub Copilot: настройка проекта с помощью ИИ и умное исправление ошибок

Emiliano Montesdeoca — Tue, 21 Apr 2026 00:00:00 +0000

Эта статья переведена автоматически. Оригинальную версию на английском можно найти здесь.

Знаком ли вам момент, когда хочешь задеплоить существующее приложение в Azure и смотришь на пустой azure.yaml, пытаясь вспомнить, какой тип хостинга выбрать для Express API — Container Apps или App Service? Этот момент станет намного короче.

Azure Developer CLI (azd) теперь интегрируется с GitHub Copilot двумя практичными способами: AI-ассистированный скаффолдинг проекта при azd init и интеллектуальное устранение ошибок при сбое деплоя. Обе функции работают полностью в терминале — именно там, где они и должны быть.

Настройка с Copilot при azd init

При запуске azd init теперь появляется опция “Set up with GitHub Copilot (Preview)”. Выберите её, и Copilot проанализирует вашу кодовую базу, чтобы сгенерировать azure.yaml, шаблоны инфраструктуры и Bicep-модули — на основе вашего реального кода.

azd init
# Выберите: "Set up with GitHub Copilot (Preview)"

Что потребуется:

azd 1.23.11 или новее — проверьте azd version или обновитесь через azd update
Активная подписка GitHub Copilot (Individual, Business или Enterprise)
GitHub CLI (gh) — azd запросит вход при необходимости

Что мне по-настоящему нравится: это работает в обоих направлениях. Строите с нуля? Copilot поможет настроить правильные сервисы Azure с самого начала. Есть существующее приложение, которое давно хотели задеплоить? Направьте на него Copilot — конфигурация будет сгенерирована без необходимости что-либо переструктурировать.

Что происходит на самом деле

Допустим, у вас есть Node.js Express API с зависимостью от PostgreSQL. Вместо того чтобы вручную выбирать между Container Apps и App Service, а затем писать Bicep с нуля, Copilot определит стек и сгенерирует:

azure.yaml с правильными настройками language, host и build
Bicep-модуль для Azure Container Apps
Bicep-модуль для Azure Database for PostgreSQL

Перед любыми изменениями выполняются предварительные проверки — убеждается в чистоте рабочей директории git, заранее запрашивает согласие на инструменты MCP-сервера. Ничего не произойдёт без вашего понимания того, что именно изменится.

Устранение ошибок с помощью Copilot

Ошибки деплоя неизбежны. Пропущенные параметры, проблемы с правами, недоступность SKU — и сообщение об ошибке редко подсказывает именно то, что нужно: как это исправить.

Без Copilot цикл выглядит так: скопировать ошибку → искать в документации → читать три нерелевантных ответа на Stack Overflow → выполнить команды az CLI → попробовать снова. С Copilot в azd этот цикл рушится. При любом сбое команды azd сразу предлагаются четыре варианта:

Explain — простое объяснение того, что пошло не так
Guidance — пошаговые инструкции по исправлению
Diagnose and Guide — полный анализ + Copilot применяет исправление (с вашего одобрения) + опциональный повтор
Skip — разобраться самостоятельно

Ключевой момент: у Copilot уже есть контекст вашего проекта, упавшей команды и деталей ошибки. Его предложения специфичны именно для вашей ситуации.

Настройка поведения по умолчанию

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

azd config set copilot.errorHandling.category troubleshoot

Значения: explain, guidance, troubleshoot, fix, skip. Можно включить автоматическое исправление и повтор:

azd config set copilot.errorHandling.fix allow

Вернуться к интерактивному режиму в любой момент:

azd config unset copilot.errorHandling.category

Итоги

Запустите azd update для получения последней версии и попробуйте azd init на следующем проекте. Это именно та интеграция Copilot, которая приносит реальную ценность.

Читайте оригинальное объявление здесь.