В этом кратком руководстве вы узнаете, как создать и развернуть ресурсы приложений для Azure с помощью шаблона Azure Developer CLI (azd) и всего лишь нескольких команд azd.
azd шаблоны — это стандартные репозитории кода, которые включают исходный код приложения, а также файлы конфигурации и инфраструктуры azd для развертывания ресурсов Azure. Чтобы узнать больше о шаблонах azd и о том, как они могут ускорить процесс подготовки и развертывания Azure, см. статью Что такое шаблоны Azure Developer CLI?.
Выбор и развертывание шаблона
Для дальнейших действий вы будете использовать следующий шаблон для подготовки и развертывания приложения на Azure:
Вы также можете выбрать шаблон, соответствующий вашим предпочтениям, на сайте коллекции шаблонов Awesome AZD . Независимо от того, какой шаблон используется, вы в конечном итоге будете использовать код шаблона в среде разработки и сможете выполнять команды для сборки, повторного развертывания и мониторинга приложения в Azure.
Выберите предпочитаемую среду, чтобы продолжить:
Локальная среда разработки — отличный выбор для традиционных рабочих процессов разработки. Вы клонируете репозиторий шаблонов на своё устройство и выполните команды против локальной установки azd.
Предварительные требования
Инициализация проекта
В Проводник или терминале создайте новый пустой каталог и перейдите в него.
azd init Выполните команду и укажите шаблон, который вы хотите использовать в качестве параметра:
azd init --template todo-nodejs-mongo
azd init --template todo-python-mongo
azd init --template todo-csharp-cosmos-sql
azd init --template todo-java-mongo-aca
Введите имя среды при появлении запроса, например azdquickstart, который задает префикс именования для группы ресурсов, которая будет создана для хранения Azure ресурсов.
Что такое имя среды в azd?
После указания среды azd клонирует проект шаблона на компьютер и инициализирует проект.
Подготовка и развертывание ресурсов приложения
azd auth login Выполните команду и azd запустите браузер, чтобы завершить процесс входа.
azd auth login
Выполните команду azd up.
azd up
После входа в Azure вам будет предложено получить следующие сведения:
| Параметр |
Описание |
Azure Location |
Расположение Azure, в котором будут развернуты ресурсы. |
Azure Subscription |
Подписка Azure, в которой будут развернуты ресурсы. |
Выберите нужные значения и нажмите клавишу Enter. Команда azd up обрабатывает следующие задачи с помощью файлов конфигурации и инфраструктуры шаблона:
- Создает и настраивает все необходимые ресурсы Azure (
azd provision), в том числе:
- Политики и роли доступа для учетной записи
- Взаимодействие сервисов с управляемыми удостоверениями
- Упаковывает и разворачивает код (
azd deploy)
После успешного завершения команды интерфейс командной azd up строки отображает две ссылки для просмотра созданных ресурсов:
- Приложение API ToDo
- Интерфейс веб-приложения ToDo
Примечание.
Вы можете вызывать azd up столько раз, сколько вы хотите подготовить и развернуть обновления в приложении.
Развертывание может завершиться ошибкой из-за того, что ресурс невозможно развернуть в выбранном регионе. Так как это краткое руководство, можно безопасно удалить каталог .azure и повторить попытку azd up. По запросу выберите другой регион. В более сложном сценарии можно выборочно редактировать файлы в каталоге .azure , чтобы изменить регион.
Интерфейс командной строки разработчика Azure предоставляет расширение Visual Studio Code для упрощения работы с функциями azd. Например, можно использовать интерфейс палитры команд для выполнения azd команд. Чтобы выполнить последующие шаги в Visual Studio Code, необходимо установить расширение Azure Developer CLI.
Установка расширения CLI для разработчика Azure
Откройте Visual Studio Code.
В меню "Вид " выберите "Расширения".
В поле поиска введите Azure Developer CLI.
Выберите "Установить " и дождитесь завершения процесса установки.
Инициализация нового приложения
Откройте пустой каталог в Visual Studio Code.
В меню "Вид " выберите "Палитра команд...".
Найдите команду Azure Developer CLI (azd): Initialize app (init) и нажмите клавишу ВВОД. Команда azd up указывает azd подготовить и развернуть ресурсы приложения.
Выберите рабочий процесс выбора шаблона .
Найдите шаблон React Web App с API Node.js и MongoDB для Azure и нажмите клавишу ввода, чтобы выбрать его.
Visual Studio Code клонирует azd шаблон. Шаблон включает инфраструктуру в виде файлов кода в папке infra и примера приложения в папке src . Инфраструктура в виде файлов кода подготавливает необходимые ресурсы для Azure, необходимых приложению при его развертывании.
Найдите шаблон React Web App с API на Python и MongoDB на Azure и нажмите клавишу ВВОД, чтобы выбрать его.
Visual Studio Code загружает клонируемый azd шаблон. Шаблон включает инфраструктуру в виде файлов кода в папке infra и примера приложения в папке src . Инфраструктура в виде файлов кода подготавливает необходимые ресурсы для Azure, необходимых приложению при его развертывании.
Найдите шаблон React Web App с API C# и MongoDB на Azure и нажмите клавишу ВВОД, чтобы выбрать его.
Visual Studio Code клонирует и загружает azd шаблон. Шаблон включает инфраструктуру в виде файлов кода в папке infra и примера приложения в папке src . Инфраструктура в виде файлов кода подготавливает необходимые ресурсы для Azure, необходимых приложению при его развертывании.
Найдите шаблон контейнерного веб-приложения React с API на Java и MongoDB для Azure и нажмите клавишу ВВОД, чтобы выбрать его.awesome-azd.
Visual Studio Code клонирует azd шаблон. Шаблон включает инфраструктуру в виде файлов кода в папке infra и примера приложения в папке src . Инфраструктура в виде файлов кода подготавливает необходимые ресурсы для Azure, необходимых приложению при его развертывании.
После клонирования шаблона Visual Studio Code открывает терминал, чтобы запросить имя среды. Введите короткое имя по вашему выбору, например azdvscode, и нажмите Enter.
Enter a new environment name: [? for help] azdvscode
Имя среды влияет на именование ресурсов, подготовленных в Azure, и создает папку в каталоге шаблонов .azure для хранения определенных параметров среды.
Подготовка и развертывание ресурсов приложения
Откройте палитру команд, найдите команду Azure Developer CLI (azd): Package, Provision and Deploy(up), затем нажмите Enter. Команда azd up указывает azd подготовить и развернуть ресурсы приложения.
Visual Studio Code открывает окно терминала, чтобы отображать ход выполнения процесса подготовки и развертывания.
azd использует параметры подписки и расположения, которые вы выбрали во время init, при развертывании ресурсов.
Примечание.
Процесс подготовки и развертывания может занять несколько минут.
По завершении процесса развертывания выберите ссылку в окне вывода, предоставленном azd для запуска сайта в браузере.
Пространства кода — отличный вариант для разработчиков, которые предпочитают работать в контейнерных облачных средах и не устанавливать средства или зависимости локально.
Настройка вашего пространства кода
- Над списком файлов нажмите Использовать этот шаблон>Открыть в Codespace.
При использовании codespace все предварительные требования устанавливаются для вас, включая расширение azd Visual Studio Code.
Запуск шаблона
После создания Codespace щелкните правой кнопкой мыши azure.yaml в корневом каталоге. В параметрах выберите up (подготовка ресурсов и развертывание кода в Azure).
При выполнении azd up команды вам будет предложено указать следующие сведения и войти в систему с помощью веб-браузера и кода проверки подлинности:
| Параметр |
Описание |
Environment Name |
Префикс для группы ресурсов, которая будет создана для хранения всех Azure ресурсов. Что такое имя среды в azd? Вы всегда можете создать новую среду с помощью azd env new. |
Azure Location |
Расположение Azure, в котором будут развернуты ресурсы. |
Azure Subscription |
Подписка Azure, в которой будут развернуты ресурсы. |
Этот процесс может занять некоторое время, так как azd up команда обрабатывает следующие задачи:
- Создает и настраивает все необходимые ресурсы Azure (
azd provision).
- Настраивает политики доступа и роли для учетной записи.
- Реализует взаимодействие между службами с использованием управляемых удостоверений.
- Упаковывает и развёртывает код (
azd deploy).
После предоставления необходимых параметров и выполнения команды azd up терминал CodeSpaces отображает две ссылки на портал Azure для просмотра созданных ресурсов:
- Приложение API ToDo
- Интерфейс веб-приложения ToDo
Что произошло?
После успешного выполнения команды azd up:
- Ресурсы Azure, указанные в файле
README.md шаблона были предоставлены в подписку Azure, которую вы указали после запуска azd up. Теперь вы можете просматривать эти ресурсы Azure через портал Azure.
- Приложение было создано и развернуто в Azure. Используя URL-адрес веб-приложения, полученный из команды
azd up, можно открыть полнофункциональное приложение.
Примечание.
- Вы можете вызывать
azd up столько раз, сколько пожелаете, чтобы подготовить и развернуть ваше приложение.
- Запуск и отладка, которые требуют открытия веб-браузера, в настоящее время не поддерживаются из-за известного ограничения с GitHub Codespaces. Для улучшения впечатлений рекомендуется использовать Codespaces на компьютере.
DevContainer — это образ Docker, который включает все необходимые компоненты, необходимые для работы с шаблоном azd на локальном компьютере. Это отличный выбор для разработчиков, которые предпочитают контейнерные среды, которые по-прежнему работают на локальном устройстве вместо облачной службы, например GitHub Codespaces.
Предварительные требования
Инициализация проекта
Откройте терминал, создайте пустой каталог и измените его.
Выполните следующую команду, чтобы инициализировать проект:
azd init --template todo-nodejs-mongo
azd init --template todo-python-mongo
azd init --template todo-csharp-cosmos-sql
azd init --template todo-java-mongo-aca
При выполнении azd init команды вам будет предложено указать следующие сведения:
| Параметр |
Описание |
Environment Name |
Префикс для группы ресурсов, которая будет создана для хранения всех Azure ресурсов. Что такое имя среды в azd? Вы всегда можете создать новую среду с azd env new. |
Откройте DevContainer
- Откройте проект в VS Code.
- Нажмите клавишу F1 и выберите:
Remote-Containers: Rebuild and Reopen in Container
Запустите команду up
Выполните следующую команду:
azd up
При выполнении azd up команды вам будет предложено указать следующие сведения:
| Параметр |
Описание |
Azure Location |
Расположение Azure, в котором будут развернуты ресурсы. |
Azure Subscription |
Подписка Azure, в которой будут развернуты ресурсы. |
Выполнение azd up команды может занять некоторое время, так как выполняется следующее:
- Создает и настраивает все необходимые ресурсы Azure (
azd provision), в том числе:
- Политики и роли доступа для учетной записи
- Взаимодействие между службами с управляемыми идентификаторами
- Упаковывает и развёртывает код (
azd deploy)
После предоставления необходимых параметров и выполнения команды azd up интерфейс командной строки отображает две ссылки на портал Azure для просмотра созданных ресурсов:
- Приложение API ToDo
- Интерфейс веб-приложения ToDo
Примечание.
Можно выполнять azd up столько раз, сколько вы хотите подготовить и развернуть приложение в одном регионе, а также с теми же значениями конфигурации, которые вы указали при первом запуске.
Очистка ресурсов
Когда в созданных в этой статье ресурсах больше нет необходимости, выполните следующую команду, чтобы выключить приложение:
azd down
Если вы хотите повторно развернуть развертывание в другом регионе, удалите каталог перед повторной запуском .azureazd up . В более сложном сценарии можно выборочно редактировать файлы в каталоге .azure , чтобы изменить регион.
Запросить справку
Чтобы получить информацию о том, как сообщить об ошибке, запросить помощь или предложить новую функцию для интерфейса командной строки разработчика Azure (CLI), перейдите на страницу устранения неполадок и поддержки.
Следующие шаги