Начните с нового шаблона Azure Developer CLI (azd)

Для создания стандартных файлов в Azure новом шаблоне интерфейса командной строки разработчика (azd) можно использовать различные методы разработки:

• Используйте интеграцию GitHub Copilot в azd init. Встроенный рабочий процесс анализирует существующие файлы проекта или помогает спланировать новый проект, создает ресурсы шаблона и выполняет проверку предварительной версии.
• Используйте другой помощник по написанию кода ИИ. Попросите помощника создать такие же azure.yaml, инфраструктуру как код, приложение и вспомогательные файлы без прямой интеграции с azd init.
• Создай файлы напрямую. Создавайте и редактируйте ресурсы шаблона самостоятельно, если хотите полностью контролировать процесс или не используете ИИ-помощника для написания кода.

В этой статье основное внимание уделяется встроенному рабочему процессу GitHub Copilot, так как он предоставляет интерактивный интерфейс, интегрированный с azd. Независимо от метода разработки, просмотрите и проверьте каждый файл перед развертыванием.

Important

Интеграция GitHub Copilot в azd init доступна в предварительной версии. Предварительные версии функций могут быть изменены до выпуска общедоступной версии. Дополнительные сведения см. в azd статье «Управление версиями компонентов и стратегия выпуска».

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

Предварительные требования для GitHub Copilot

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

• Azure Developer CLI 1.23.11 или более поздней версии.
• Активная GitHub Copilot подписка.
• Git, который azd init использует для проверки рабочего дерева перед изменением файлов.
• Интерактивный сеанс терминала.

Если вы ещё не вошли в GitHub Copilot, azd предложит вам войти в систему.

Запуститеazd version, чтобы проверить установленную версию интерфейса командной строки разработчика Azure.

Note

Рабочий процесс azd init запускает в терминале отдельный сеанс агента GitHub Copilot. Не использует и не продолжает активный сеанс чата GitHub Copilot в Visual Studio Code.

Создавайте с GitHub Copilot

1. Откройте терминал в каталоге, в котором вы хотите создать шаблон.

   Note

   Каталог может содержать существующее приложение, проект инфраструктуры или начальные файлы для нового решения. Если каталог содержит незафиксированные изменения, azd попросит вас подтвердить, прежде чем продолжить. Сначала зафиксируйте важные изменения или уберите их в stash.

2. Запустите azd init.

   azd init
   

3. Выберите Настроить с помощью GitHub Copilot (предварительная версия).

   Запрос инициализации похож на следующий пример:

   ? How do you want to initialize your app?
      Scan current directory
      Select a template
   > Set up with GitHub Copilot (Preview)
   

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

5. Выберите модель и уровень рассуждений, если azd предложит вам настроить их.

   В первом запуске запросы используют следующие метки. Доступные модели и варианты причин зависят от учетной записи GitHub Copilot и выбранной модели:

   ? Select AI model
   ? Select reasoning effort level
   

6. Описать то, что вы хотите создать. Включите соответствующие требования, такие как:

   • Включает ли шаблон код приложения, только инфраструктуру или оба.
   • Языки приложений и платформы, если известны.
   • Служба Azure и платформа размещения для использования.
   • Что выбрать: Bicep или Terraform.
   • Требования к безопасности, сети, масштабированию и регионам.

   Рассмотрим пример.

   Build an infrastructure-only azd template that provisions an Azure Container Apps
   environment, Azure Container Registry, and Log Analytics workspace with Bicep.
   Use managed identity and least-privilege role assignments. Parameterize the location
   and environment name so the template can be reused.
   

7. Ответьте на любые вопросы по архитектуре или конфигурации из Copilot. Агент подготавливает проект для Azure, создает ресурсы шаблона и выполняет проверку предварительного развертывания.

8. Просмотрите общую структуру файлов, которые Copilot создал или изменил. Убедитесь, что шаблон включает ожидаемую конфигурацию проекта, каталог инфраструктуры, источник приложения и вспомогательные ресурсы для вашего решения.

   Например, созданный шаблон только инфраструктуры может содержать следующие ключевые файлы:

   azure.yaml
   infra/
   ├── main.bicep
   ├── main.parameters.json
   └── modules/
      ├── container-apps-environment.bicep
      └── container-registry.bicep
   

   Подробные рекомендации по просмотру содержимого конфигурации и инфраструктуры см. в статье "Изучение и изменение файлов шаблонов".

Подготовка и развертывание шаблона

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

azd up

Команда создает или выбирает среду выполнения azd, подготавливает ресурсы Azure, упаковывает все службы приложений и развертывает их. Подробные сведения о разбивке команд см. в azd up разделе "Обзор рабочего процесса".

Использование другого метода разработки

Другие ИИ-ассистенты для программирования не подключены напрямую к рабочему процессу azd init, но могут создавать те же стандартные шаблонные ресурсы. Вы также можете напрямую создавать любые ресурсы.

Создайте эти ресурсы самостоятельно или попросите другого помощника по программированию проанализировать ваши требования и создать их:

• azure.yaml Файл, определяющий проект и развертываемые службы.
• Файлы Bicep или Terraform, которые развертывают необходимые ресурсы Azure.
• Выходные данные ресурсов и переменные среды приложения.
• Dockerfiles, конфигурация развертывания и вспомогательные скрипты при необходимости.

Чтобы предоставить минимальную начальную точку перед использованием другого агента, выполните следующую команду:

azd init --minimal

Если вы используете другой помощник по программированию, поручите ему следовать схеме azure.yaml schema, практикам безопасности инфраструктуры Azure и соглашениям, принятым в шаблонах, описанным в шаблонах Azure Developer CLI. Если вы создаете файлы непосредственно, используйте те же ссылки, что и руководство по реализации. Перед запуском azd upпросмотрите и проверьте все файлы.

Связанные материалы

• Обзор разработки шаблонов
• Изучение и изменение файлов шаблонов
• Начало работы с существующего шаблона
• Расширение шаблона
• azd init Изучение рабочего процесса

Запрос помощи

Чтобы получить информацию о том, как сообщить об ошибке, запросить помощь или предложить новую функцию для интерфейса командной строки разработчика Azure (CLI), перейдите на страницу устранения неполадок и поддержки.