Создание среды из шаблона Интерфейса командной строки разработчика Azure

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

Основные понятия о том, как azd и ADE работают вместе, см. в статье Об использовании Azure Developer CLI с средами развертывания Azure.

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

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

Присоединение каталога быстрого запуска Майкрософт

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

Проверка совместимого azd шаблона

Вы можете использовать существующий azd совместимый шаблон для создания новой среды или добавить файл azure.yaml в репозиторий. В этом разделе рассматривается существующий azd совместимый шаблон.

azd Развертывание сред зависит от курированных шаблонов из каталога. Шаблоны в каталоге могут назначать теги подготовленным ресурсам Azure, чтобы связать службы приложений с файлом azure.yaml или указать ресурсы явным образом. В этом примере ресурсы указываются явным образом.

Дополнительные сведения о тегах ресурсов см. в разделе "Теги ресурсов" для сред развертывания Azure.

1. На портале Azure перейдите в центр разработки.

2. В левом меню в разделе "Конфигурация среды" выберите "Каталоги" и скопируйте URL-адрес клонирования каталога быстрого старта.

   

3. Чтобы просмотреть каталог быстрого запуска в GitHub, вставьте Clone URL в адресную строку и нажмите Enter. Кроме того, можно использовать следующий URL-адрес: каталог быстрого запуска Майкрософт.

4. В репозитории GitHub перейдите в папку Environment-Definitions/ARMTemplates/Function-App-with-Cosmos_AZD-template .

5. Откройте файл environment.yaml. В конце файла отображаются разрешенные репозитории, содержащие пример исходного кода приложения.

   

6. Скопируйте URL-адрес https://github.com/azure-samples/todo-python-mongo-swa-func репозитория, а затем перейдите на страницу репозитория в GitHub.

7. В корневом каталоге репозитория откройте файл azure.yaml .

8. В файле azure.yaml в разделе служб отображаются веб-службы и службы API , определенные в шаблоне.

Если вы работаете с собственным определением каталога и среды, вы можете создать файл azure.yaml в корне репозитория. Используйте файл azure.yaml, чтобы определить службы, которые требуется развернуть в среде.

Создание среды из существующего шаблона

Используйте существующий azd совместимый шаблон для создания новой среды.

Подготовка к работе с azd

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

Установите расширение CLI для разработчиков Azure

При установке azd средства azd устанавливаются в области azd, а не глобально, и удаляются, когда azd удаляется. Вы можете установить azd в Visual Studio Code, из командной строки или в Visual Studio.

powershell -ex AllSigned -c "Invoke-RestMethod 'https://aka.ms/install-azd.ps1' | Invoke-Expression"

Вход с помощью Интерфейса командной строки разработчика Azure

Доступ к ресурсам Azure путем входа в систему. При запуске входа откроется окно браузера и предложит войти в Azure. После входа в терминал отобразится сообщение о входе в Azure.

Войдите в azd систему с помощью палитры команд:

 azd auth login

Включите поддержку azd для ADE

Если platform.type установлено на devcenter, все операции с состоянием и подготовкой удаленной среды используют компоненты центра разработки. azd использует один из шаблонов инфраструктуры, определенных в каталоге центра разработки для подготовки ресурсов. В этой конфигурации папка инфраструктуры в локальных шаблонах не используется.

 azd config set platform.type devcenter

Создание новой среды

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

Настройка центра разработки

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

1. В Visual Studio Code перейдите к файлу azure.yaml в корне проекта.

2. В файле azure.yaml добавьте следующие параметры:

   platform:
       type: devcenter
       config:
           catalog: MS-cat
           name: Contoso-DevCenter
           project: Contoso-Dev-project
   

   

Дополнительные сведения о параметрах, которые можно настроить, см. в разделе "Настройка параметров центра разработки".

Настройка среды

Вы можете использовать azd для настройки и развертывания ресурсов в ваших средах развертывания с помощью команд типа azd up или azd provision.

Дополнительные сведения о подготовке среды см. в статье "Работа со средами развертывания Azure".

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

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