Поделиться через


Генерация Bicep с помощью функции компоновки

Функция создания интерфейса командной строкиazd разработчика Azure упрощает процесс создания, развертывания и управления облачными приложениями. С помощью azd composeможно определить инфраструктуру и код приложения для проекта и управлять ими в едином порядке. В этом руководстве объясняется, как создать код Bicep из azd compose функции, что позволяет настроить облачную инфраструктуру в соответствии с вашими требованиями.

Как azd compose управляет состоянием инфраструктуры

Функция azd compose отслеживает состояние инфраструктуры в памяти во время процесса композиции. Такой подход позволяет итеративно определять и уточнять приложение и инфраструктуру без немедленного создания файлов или изменения каталога проекта.

При выполнении azd infra synth команды состояние в памяти преобразуется в файлы Bicep в папке infra . На этом этапе состояние инфраструктуры переходит от управляемого в памяти к представлению в виде кода, что позволяет продолжить настройку.

Подсказка

Используйте azd compose для быстрого прототипирования вашей инфраструктуры перед тем, как зафиксировать изменения на основе файла с помощью azd infra synth.

Сгенерируйте код Bicep

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

azd infra gen

Замечание

Команда azd infra synth из предыдущих azd версий теперь является псевдонимом azd infra generateи продолжит работать. Однако отобразится предупреждение, и команда может быть удалена в следующем azd выпуске.

Эта команда создает соответствующие файлы Bicep в папке infra приложения.

Управление обновлениями с помощью генерации Bicep

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

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

  1. Вы используете azd add для добавления новых ресурсов Azure в проект. Эти ресурсы внутренне управляются azd.
  2. После того как вы закончите добавлять ресурсы, выполните команду azd infra gen, чтобы создать файлы Bicep для этих ресурсов в папке infra проекта. На этом этапе ресурсы больше не управляются рабочим процессом azd compose .
  3. Теперь вы можете вручную обновить файлы Bicep при продолжении разработки приложения.
  4. При добавлении дополнительных ресурсов или повторном запуске azd infra gen содержимое infra папки будет повторно создано, и все изменения вручную будут потеряны.

По этой причине функция создания лучше подходит для следующих сценариев:

  • Создание начального набора ресурсов Azure для проекта, а затем управление дальнейшими обновлениями путем редактирования файлов Bicep.
  • Полное управление ресурсами Azure с помощью возможности составления шаблонов без выполнения azd infra gen.

Дальнейшие шаги