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

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

Azure Developer CLI (AZD) — это средство с открытым исходным кодом, которое ускоряет время, необходимое для получения приложения из локальной среды разработки в Azure. AZD предоставляет рекомендации, понятные для разработчиков команды, которые сопоставляются с ключевыми этапами рабочего процесса, независимо от того, работаете ли вы в терминале, редакторе или интегрированной среде разработки (IDE) или CI/CD (непрерывная интеграция или непрерывное развертывание).

Сведения о настройке AZD для работы с средами развертывания Azure см. в статье Об использовании Azure Developer CLI с средами развертывания Azure.

Необходимые компоненты

Вы должны:

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

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

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

Установка расширения ИНТЕРФЕЙСА командной строки разработчика Azure для Visual Studio Code

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

Visual Studio Code

Чтобы включить функции интерфейса командной строки разработчика Azure в Visual Studio Code, установите расширение ИНТЕРФЕЙСА командной строки разработчика Azure версии 0.8.0-alpha.1-beta.3173884. Щелкните значок расширений на панели действий, найдите интерфейс командной строки разработчика Azure и нажмите кнопку "Установить".

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

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

Visual Studio

В Visual Studio 2022 17.3 preview 2 или более поздней версии можно включить интеграцию с azd в качестве функции предварительной версии.

Чтобы включить функцию azd, перейдите в> раздел "Параметры параметров>среды>предварительной версии" и выберите "Интеграция с azd", Azure Developer CLI.

Если эта функция включена, вы можете использовать интерфейс командной строки разработчика Azure из выбранного терминала в Windows, Linux или macOS.

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

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

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

Visual Studio Code

Выходные данные команд, выданных из палитры команд, отображаются в терминале azd dev , как показано в следующем примере:

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

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

 azd auth login

Visual Studio

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

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

1. В меню "Сервис" выберите "Терминал".

2. В окне терминала выберите командную строку разработчика.

   

Войдите в AZD с помощью терминала команд разработчика:

 azd auth login

Включение поддержки AZD для ADE

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

Visual Studio Code

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

 azd config set platform.type devcenter

Visual Studio

 azd config set platform.type devcenter

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

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

Инициализация нового приложения

Инициализация нового приложения создает файлы и папки, необходимые для работы с приложением AZD.

AZD использует файл azure.yaml для определения среды. Файл azure.yaml определяет и описывает приложения и типы ресурсов Azure, которые использует приложение. Дополнительные сведения о azure.yaml см . в схеме azure.yaml для разработчиков Azure.

Visual Studio Code

1. В Visual Studio Code откройте папку, содержащую код приложения.

2. Откройте палитру команд и введите инициализацию интерфейса командной строки разработчика Azure, а затем в списке выберите Azure Developer CLI (azd): init.

   

3. В списке шаблонов, чтобы продолжить без выбора шаблона, дважды нажмите клавишу ВВОД.

4. В терминале AZD выберите "Использовать код" в текущем каталоге.

   

5. azd init определяет службы, определенные в коде приложения, и запрашивает подтверждение и продолжение, удаление службы или добавление службы. Выберите "Подтвердить" и продолжить инициализацию приложения.

   

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

   

7. Введите имя локальной среды AZD.

   

8. azd init отображает список проектов, к к которых у вас есть доступ. Выбор проекта для вашей среды

   

9. azd init отображает список определений среды в проекте. Выберите определение среды.

   

   AZD создает ресурсы проекта, включая файл azure.yaml в корне проекта.

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

1. В интерфейсе командной строки перейдите в папку, содержащую код приложения.

2. Выполните следующую команду, чтобы инициализировать приложение и указать сведения при появлении запроса:

   azd init
   

3. В терминале AZD выберите "Использовать код" в текущем каталоге.

   

   AZD сканирует текущий каталог и собирает дополнительные сведения в зависимости от типа создаваемого приложения. Следуйте инструкциям по настройке среды AZD.

4. azd init определяет службы, определенные в коде приложения, и запрашивает подтверждение и продолжение, удаление службы или добавление службы. Выберите "Подтвердить" и продолжить инициализацию приложения.

   

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

   

6. Введите имя локальной среды AZD.

   

7. azd init отображает список проектов, к к которых у вас есть доступ. Выберите проект для вашей среды.

   

8. azd init отображает список определений среды в проекте. Выберите определение среды.

   

   AZD создает ресурсы проекта, включая файл azure.yaml в корне проекта.

Visual Studio

1. В интерфейсе командной строки перейдите в папку, содержащую код приложения.

2. Выполните следующую команду, чтобы инициализировать приложение и указать сведения при появлении запроса:

   azd init
   

3. В терминале AZD выберите "Использовать код" в текущем каталоге.

   

   AZD сканирует текущий каталог и собирает дополнительные сведения в зависимости от типа создаваемого приложения. Следуйте инструкциям по настройке среды AZD.

4. azd init определяет службы, определенные в коде приложения, и запрашивает подтверждение и продолжение, удаление службы или добавление службы. Выберите "Подтвердить" и продолжить инициализацию приложения.

   

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

   

6. Введите имя локальной среды AZD.

   

7. azd init отображает список проектов, к к которых у вас есть доступ. Выберите проект для вашей среды.

   

8. azd init отображает список определений среды в проекте. Выберите определение среды.

   AZD создает ресурсы проекта, включая файл azure.yaml в корне проекта.

Подготовка инфраструктуры в среде развертывания Azure

Когда вы будете готовы, вы можете подготовить локальную среду к удаленной среде сред развертывания Azure в Azure. Этот процесс подготавливает инфраструктуру и ресурсы, определенные в определении среды в каталоге центра разработки.

Visual Studio Code

1. В Обозреватель щелкните правой кнопкой мыши azure.yaml и выберите Azure Developer CLI (azd)>Provision Azure Resources (provision).

   

2. AZD сканирует среды развертывания Azure для проектов, к которым у вас есть доступ. В терминале AZD выберите или введите следующие сведения:

   1. Project
   2. Определение среды
   3. Тип среды
   4. Расположение

3. AZD указывает ADE создать новую среду на основе информации, предоставленной на предыдущем шаге.

4. Вы можете просмотреть ресурсы, созданные на портал Azure или на портале разработчика.

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

Подготовьте приложение в Azure с помощью следующей команды:

azd provision

1. Azd provision предоставляет список проектов, к которым у вас есть доступ. Выберите проект, для которого нужно подготовить приложение.

   

2. Azd provision предоставляет список определений среды в выбранном проекте. Выберите определение среды, которое необходимо использовать для подготовки приложения.

   

3. Azd provision предоставляет список типов среды в выбранном проекте. Выберите тип среды, который вы хотите использовать для подготовки приложения.

   

4. AZD указывает ADE создать новую среду на основе информации, предоставленной на предыдущем шаге.

   

5. Вы можете просмотреть ресурсы, созданные на портал Azure или на портале разработчика.

Visual Studio

Подготовьте приложение в Azure с помощью следующей команды:

azd provision

1. Azd provision предоставляет список проектов, к которым у вас есть доступ. Выберите проект, для которого нужно подготовить приложение.

   

2. Azd provision предоставляет список определений среды в выбранном проекте. Выберите определение среды, которое необходимо использовать для подготовки приложения.

   

3. Azd provision предоставляет список типов среды в выбранном проекте. Выберите тип среды, который вы хотите использовать для подготовки приложения.

4. AZD указывает ADE создать новую среду на основе информации, предоставленной на предыдущем шаге.

5. Вы можете просмотреть ресурсы, созданные на портал Azure или на портале разработчика.

Вывод списка существующих сред (необязательно)

Убедитесь, что ваша среда создана путем перечисления существующих сред.

Visual Studio Code

1. В Обозреватель щелкните правой кнопкой мыши azure.yaml и выберите Azure Developer CLI (azd)>View Local and Remote Environments (env list).

   

   Вам будет предложено выбрать проект и определение среды.

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

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

azd env list

azd env list предлагает выбрать проект и определение среды.

Visual Studio

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

azd env list

azd env list предлагает выбрать проект и определение среды.

Развертывание кода в средах развертывания Azure

При подготовке среды можно развернуть код в среде.

Visual Studio Code

1. В Обозреватель щелкните правой кнопкой мыши azure.yaml и выберите azure Developer CLI (azd)>Deploy Azure Resources (deploy).

   

2. Вы можете убедиться, что ваш код развернут, выбрав URL-адреса конечных точек, перечисленные в терминале AZD.

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

Разверните код приложения в удаленной среде сред развертывания Azure, подготовленной с помощью следующей команды:

azd deploy

Развертывание кода в удаленной среде может занять несколько минут.

Ход развертывания можно просмотреть в портал Azure:

После завершения развертывания можно просмотреть ресурсы, подготовленные в портал Azure:

Вы можете убедиться, что ваш код развернут, выбрав URL-адреса конечных точек, перечисленные в терминале AZD.

Для этого примера приложения вы увидите следующее:

Visual Studio

Разверните код приложения в удаленной среде сред развертывания Azure, подготовленной с помощью следующей команды:

azd deploy

Развертывание кода в удаленной среде может занять несколько минут.

Ход развертывания можно просмотреть в портал Azure:

После завершения развертывания можно просмотреть ресурсы, подготовленные в портал Azure:

Вы можете убедиться, что ваш код развернут, выбрав URL-адреса конечных точек, перечисленные в терминале AZD.

Очистка ресурсов

После завершения работы с средой можно удалить ресурсы Azure.

Visual Studio Code

В Обозреватель щелкните правой кнопкой мыши azure.yaml и выберите Azure Developer CLI (azd)>Delete Deployment and Resources (down).

Убедитесь, что вы хотите удалить среду, введя y при появлении запроса.

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

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

azd down --environment <environmentName>

Visual Studio

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

azd down --environment <environmentName>

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

• Создание и настройка центра разработки
• Что такое интерфейс командной строки разработчика Azure?
• Установка или обновление интерфейса командной строки разработчика Azure