Интерфейс командной строки разработчика Azure и среды развертывания Azure

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

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

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

Как azd работает с ADE?

azd работает с ADE, чтобы вы могли создавать среды из любого места, где вы работаете.

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

В большом масштабе использование ADE и azd вместе позволяет разработчикам создавать инфраструктуру приложений и код. Ваша команда может создавать несколько сред ADE из одного azd определения совместимой среды и подготавливать код к облаку согласованно.

Общие сведения о azd шаблонах

Команды ИНТЕРФЕЙСА командной строки разработчика Azure предназначены для работы со стандартными шаблонами. Каждый шаблон — это репозиторий кода, который соответствует определенным соглашениям о файлах и папках. Шаблоны содержат ресурсы azd , необходимые для подготовки среды развертывания Azure. При выполнении такой azd upкоманды средство использует ресурсы шаблона для выполнения различных шагов рабочего процесса, таких как подготовка или развертывание ресурсов в Azure.

На следующей схеме показана типичная структура шаблона:

├── infra                                        [ Contains infrastructure as code files ]
├── .azdo                                        [ Configures an Azure Pipeline ]
├── .devcontainer                                [ For DevContainer ]
├── .github                                      [ Configures a GitHub workflow ]
├── .vscode                                      [ VS Code workspace configurations ]
├── .azure                                       [ Stores Azure configurations and environment variables ]
├── src                                          [ Contains all of the deployable app source code ]
└── azure.yaml                                   [ Describes the app and type of Azure resources]

Все azd шаблоны включают следующие ресурсы:

  • infra папка — папка infra не используется в azd с ADE. Он содержит всю инфраструктуру Bicep или Terraform в виде файлов кода для azd шаблона. ADE предоставляет инфраструктуру в виде файлов кода для azd шаблона. Эти файлы не нужно включать в azd шаблон.

  • azure.yaml-файл — файл конфигурации, который определяет одну или несколько служб в проекте и сопоставляет их с ресурсами Azure для развертывания. Например, вы можете определить службу API и веб-службу фронтенда, каждая из которых имеет свои атрибуты, сопоставляющие их с различными ресурсами Azure для развертывания.

  • Папка .azure. Содержит основные конфигурации Azure и переменные среды, такие как расположение для развертывания ресурсов или других сведений о подписке.

  • Папка src — содержит весь развернутый исходный код приложения. Некоторые azd шаблоны предоставляют только ресурсы инфраструктуры и оставляют каталог src пустым для добавления собственного кода приложения.

Большинство azd шаблонов также дополнительно включают одну или несколько следующих папок:

  • Папка .devcontainer— позволяет настроить среду контейнера разработки для приложения. Этот распространенный подход к среде разработки, который не зависит от azd .

  • Папка .github — содержит файлы рабочих процессов CI/CD для GitHub Actions, который является поставщиком CI/CD по умолчанию для azd .

  • Папка .azdo . Если вы решите использовать Azure Pipelines для CI/CD, определите файлы конфигурации рабочего процесса в этой папке.

azd совместимые каталоги

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

Интерфейс командной строки разработчика Azure работает с шаблонами ARM, хранящимися в каталоге Центра разработки сред развертывания Azure. Он также поддерживает другие шаблоны IaC, такие как Bicep и Terraform через модель расширяемости ADE. Чтобы узнать, как настроить модель расширяемости ADE, ознакомьтесь с моделью расширяемости сред развертывания Azure.

Для правильной поддержки определённых служб Azure Compute, Azure Developer CLI требует дополнительных параметров конфигурации в шаблоне IaC. Например, необходимо пометить узлы службы приложений определенными сведениями, чтобы azd знал, как найти узлы и развернуть приложение на них.

Список поддерживаемых служб Azure можно просмотреть здесь: поддерживаемые облачные службы Azure (хост).

Сделайте ваш каталог ADE совместимым с azd

Чтобы команды разработки могли использовать azd ADE, необходимо создать определение среды в каталоге, совместимое с azd. Можно создать новое azdсовместимое определение среды или использовать существующее определение среды из каталога Центра разработки сред развертывания Azure. Если вы решили использовать существующее определение среды, необходимо внести несколько изменений, чтобы сделать его совместимым с azd.

Внесенные изменения:

  • Если вы изменяете существующий azd шаблон, удалите папку infra . ADE использует следующие файлы для создания инфраструктуры:
    • Шаблон ARM (azuredeploy.json.)
    • Файл конфигурации, определяющий параметры (environment.yaml или manifest.yaml)
  • Пометьте ресурсы в azure.yaml с определенными сведениями, чтобы azd знал, как найти узлы и развернуть приложение на них.

Дополнительные сведения о том, как сделать определение среды ADE совместимым с , см. в статье "Совместимость проекта с azdAzure Developer CLI".

Включение azd поддержки в ADE

Чтобы включить azd поддержку с помощью ADE, необходимо задать platform.type на "devcenter". Эта конфигурация позволяет azd использовать новые компоненты DevCenter для управления состоянием удаленной среды и развертывания, и означает, что папка инфраструктуры в ваших шаблонах игнорируется. Вместо этого azd использует один из шаблонов инфраструктуры, определённых в каталоге вашего центра разработок, для подготовки ресурсов.

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

 azd config set platform.type devcenter

Изучение azd команд

Если включена функция центра разработки, поведение некоторых распространенных azd команд по умолчанию изменяется для работы с этими удаленными средами. Дополнительные сведения см. в статье "Работа с средами развертывания Azure".

Связанный контент

  • Last updated on