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

Интерфейс командной строки разработчика 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 — папка с инфраструктурой не используется в 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 для разработчика Azure требуется больше параметров конфигурации в шаблоне 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 . Эта конфигурация позволяет azd использовать новые компоненты центра разработки для состояния удаленной среды и подготовки, а также означает, что в шаблонах не учитывается папка инфраструктуры. Вместо этого для подготовки ресурсов используется один из шаблонов инфраструктуры, azd определенных в каталоге центра разработки.

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

 azd config set platform.type devcenter

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

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

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