Azure Spring Apps — это новое название службы Azure Spring Cloud. Старое название будет еще некоторое время встречаться в наших материалах, пока мы не обновим ресурсы, такие как снимки экрана, видео и схемы.
В этом кратком руководстве показано, как развернуть веб-приложение Spring Boot в Azure Spring Apps. Пример проекта — это простое приложение ToDo для добавления задач, пометьте их после завершения и удалите их. На следующем снимку экрана показано приложение:
Это типичное трехуровневое веб-приложение со следующими уровнями:
Интерфейсное приложение React, привязанное к интерфейсу.
Серверное веб-приложение Spring, использующее JPA Spring Data для доступа к реляционной базе данных.
Реляционная база данных. Для localhost приложение использует ядро СУБД H2. Для Azure Spring Apps приложение использует База данных Azure для PostgreSQL. Дополнительные сведения о База данных Azure для PostgreSQL см. в документации по гибкому серверу.
На следующей схеме показана архитектура системы:
В этой статье приведены следующие варианты развертывания в Azure Spring Apps:
Вариант портал Azure — самый простой и самый быстрый способ создания ресурсов и развертывания приложений с помощью одного щелчка мыши. Этот вариант подходит для разработчиков Spring, которые хотят быстро развернуть приложения в облачных службах Azure.
Параметр подключаемого модуля портал Azure + Maven предоставляет более обычный способ создания ресурсов и развертывания приложений пошаговые инструкции. Этот вариант подходит для разработчиков Spring с помощью облачных служб Azure впервые.
Вариант командной строки разработчика Azure — это более эффективный способ автоматического создания ресурсов и развертывания приложений с помощью простых команд. Azure Developer CLI использует шаблон для подготовки необходимых ресурсов Azure и развертывания кода приложения. Этот вариант подходит для разработчиков Spring, знакомых с облачными службами Azure.
В этой статье приведены следующие варианты развертывания в Azure Spring Apps:
Вариант портал Azure — самый простой и самый быстрый способ создания ресурсов и развертывания приложений с помощью одного щелчка мыши. Этот вариант подходит для разработчиков Spring, которые хотят быстро развернуть приложения в облачных службах Azure.
Параметр подключаемого модуля портал Azure + Maven предоставляет более обычный способ создания ресурсов и развертывания приложений пошаговые инструкции. Этот вариант подходит для разработчиков Spring с помощью облачных служб Azure впервые.
Параметр Azure CLI использует мощное средство командной строки для управления ресурсами Azure. Этот вариант подходит для разработчиков Spring, знакомых с облачными службами Azure.
Azure CLI версии 2.45.0 или более поздней. Чтобы установить расширение Azure Spring Apps, выполните следующую команду: az extension add --name spring
Если вы развертываете экземпляр плана Azure Spring Apps Enterprise впервые в целевой подписке, см. раздел "Требования" плана Enterprise в Azure Marketplace.
Кнопка "Развернуть в Azure" в следующем разделе запускает портал Azure интерфейс, который скачивает JAR-пакет с страницы выпусков ASA-Samples-Web-Application на сайте GitHub. Никаких локальных шагов подготовки не требуется.
Хотя вы используете портал Azure в последующих шагах, для локальной подготовки проекта необходимо использовать командную строку Bash. Выполните следующие действия, чтобы клонировать и запустить приложение локально:
Используйте следующую команду, чтобы клонировать пример проекта из GitHub:
Используйте следующую команду, чтобы создать пример проекта с помощью Maven:
cd ASA-Samples-Web-Application
./mvnw clean package
Используйте следующую команду для запуска примера приложения:
java -jar web/target/simple-todo-web.jar
Перейдите http://localhost:8080 в браузер, чтобы получить доступ к приложению.
3. Подготовка облачной среды
Основными ресурсами, необходимыми для запуска этого примера, являются экземпляр Azure Spring Apps и экземпляр База данных Azure для PostgreSQL. В этом разделе приведены действия по созданию этих ресурсов.
В этом разделе используется кнопка "Развернуть в Azure" для запуска интерфейса развертывания в портал Azure. В этом интерфейсе используется шаблон ARM для создания ресурсов Azure.
3.1. Войдите на портал Azure
Перейдите к портал Azure и введите учетные данные для входа на портал. Панель мониторинга службы является представлением по умолчанию.
3.2. Создание ресурсов Azure
Чтобы создать все ресурсы Azure, от которые зависит приложение, выполните следующие действия.
Нажмите следующую кнопку "Развернуть в Azure", чтобы запустить процесс развертывания в портал Azure:
Заполните форму на вкладке "Основные сведения". Используйте следующую таблицу в качестве руководства для завершения формы:
Параметр
Предлагаемое значение
Description
Подписка
Имя подписки.
Подписка Azure, которую вы хотите использовать для сервера. Если у вас есть несколько подписок, выберите ту, через которую вы предпочитаете оплачивать этот ресурс.
Группа ресурсов
myresourcegroup
Новое имя группы ресурсов или уже имеющееся из подписки.
Регион
Регион, ближайший к вашим пользователям.
Регион используется для создания группы ресурсов.
Пароль администратора POSTgre SQL
Н/П
Пароль администратора сервера PostgreSQL.
Пароль пользователя Postgre SQL
Н/П
Пароль для пользователя приложения PostgreSQL, который используется в приложении.
Выберите "Рецензирование" и " Создать ", чтобы просмотреть выбранные варианты. Затем выберите "Создать ", чтобы развернуть приложение в Azure Spring Apps.
На панели инструментов щелкните значок Уведомления (колокольчик), чтобы отслеживать процесс развертывания. После завершения развертывания можно выбрать "Закрепить на панели мониторинга", которая создает плитку для этой службы на панели мониторинга портал Azure в качестве ярлыка на странице обзора службы. Выберите "Перейти к ресурсу", чтобы открыть страницу обзора службы.
3.1. Войдите на портал Azure
Перейдите к портал Azure, введите свои учетные данные и войдите на портал. Панель мониторинга службы является представлением по умолчанию.
3.2. Создание экземпляра Azure Spring Apps
Чтобы создать экземпляр службы, выполните следующие действия.
Выберите "Создать ресурс" в углу портал Azure.
Выберите Compute>Azure Spring Apps.
Заполните форму Основные данные , указав следующую информацию:
Параметр
Предлагаемое значение
Description
Подписка
Имя подписки.
Подписка Azure, которую вы хотите использовать для сервера. Если у вас есть несколько подписок, выберите ту, через которую вы предпочитаете оплачивать этот ресурс.
Группа ресурсов
myresourcegroup
Новое имя группы ресурсов или уже имеющееся из подписки.
Имя
myasa
Уникальное имя, определяющее службу Azure Spring Apps. Его длина должна быть от 4 до 32 знаков. Имя может содержать только строчные буквы, цифры и дефисы. Первым символом в имени службы должна быть буква, а последним — буква или цифра.
План
Функции корпоративного уровня
План ценообразования, определяющий ресурс и затраты, связанные с экземпляром.
Регион
Регион, ближайший к вашим пользователям.
Ближайшее к пользователям расположение.
Избыточность между зонами
не выбрано
Параметр создания службы Azure Spring Apps в зоне доступности Azure. Эта функция в настоящее время не поддерживается во всех регионах.
План IP-адресов программного обеспечения
Оплата по мере использования
Оплата по мере использования Azure Spring Apps.
Terms
Выбрано
Флажок соглашения, связанный с предложением Marketplace. Установите этот флажок.
Развертывание примера проекта
не выбрано
Параметр для использования встроенного примера приложения.
Выберите "Рецензирование" и " Создать ", чтобы просмотреть выбранные варианты. Затем выберите "Создать ", чтобы подготовить экземпляр Azure Spring Apps.
На панели инструментов щелкните значок Уведомления (колокольчик), чтобы отслеживать процесс развертывания. После завершения развертывания можно выбрать "Закрепить на панели мониторинга", которая создает плитку для этой службы на панели мониторинга портал Azure в качестве ярлыка на странице обзора службы.
Выберите "Перейти к ресурсу", чтобы перейти на страницу обзора Azure Spring Apps.
3.3. Подготовка экземпляра PostgreSQL
Чтобы создать сервер База данных Azure для PostgreSQL, выполните следующие действия.
На портале Azure выберите Создать ресурс.
Выберите базы данных> База данных Azure для PostgreSQL гибкий сервер.
Метод проверки подлинности: только проверка подлинности PostgreSQL
Имя пользователя администратора: myadmin
Пароль и подтверждение пароля: введите пароль.
Настройте вкладку "Сеть" с помощью следующих сведений:
Метод подключения: общедоступный доступ (разрешенные IP-адреса)
Разрешить общедоступный доступ из любой службы Azure в Azure на этот сервер: выбрано:
Выберите "Просмотр и создание ", чтобы просмотреть выбранные элементы, а затем нажмите кнопку "Создать ", чтобы подготовить сервер. Эта операция может занять несколько минут.
Перейдите на сервер PostgreSQL в портал Azure.
Выберите базы данных из меню навигации, чтобы создать базу данных , например Todo.
3.4. Подключение экземпляра приложения к экземпляру PostgreSQL
Чтобы подключить экземпляры службы, выполните следующие действия.
Перейдите к экземпляру своей службы Azure Spring Apps на портале Azure.
В области навигации откройте приложения и нажмите кнопку "Создать приложение".
На странице "Создание приложения" для имени приложения используйте простой todo-web и оставьте все остальные поля со значениями по умолчанию.
Нажмите кнопку "Создать ", чтобы завершить создание приложения, а затем выберите приложение для просмотра сведений.
Выберите соединитель службы в области навигации и нажмите кнопку "Создать ", чтобы создать подключение к службе.
Указание 0.0.0.0 включения общедоступного доступа из всех ресурсов, развернутых в Azure, для доступа к серверу.
3.5. Подключение экземпляра приложения к экземпляру PostgreSQL
После создания экземпляра приложения и экземпляра PostgreSQL экземпляр приложения не может напрямую получить доступ к экземпляру PostgreSQL. Выполните следующие действия, чтобы разрешить приложению подключаться к экземпляру PostgreSQL.
Чтобы получить полное доменное имя экземпляра PostgreSQL, выполните следующую команду:
Кнопка "Развернуть в Azure" в предыдущем разделе запускает портал Azure интерфейс, включающий развертывание приложения, поэтому ничего другого не требуется.
В следующем списке описаны взаимодействия с командами:
Выберите дочерние модули для настройки: выберите модуль для настройки, а затем введите номер веб-модуля SimpleTodo.
Вход OAuth2: необходимо авторизовать вход в Azure на основе протокола OAuth2.
Выберите подписку: выберите номер списка подписок созданного экземпляра Azure Spring Apps, который по умолчанию соответствует первой подписке в списке. Если вы используете номер по умолчанию, нажмите клавишу ВВОД напрямую.
Используйте существующие Azure Spring Apps в Azure: нажмите y , чтобы использовать существующий экземпляр Azure Spring Apps.
Выберите Azure Spring Apps для развертывания: выберите номер созданного экземпляра Azure Spring Apps. Если вы используете номер по умолчанию, нажмите клавишу ВВОД напрямую.
Предоставление общедоступного доступа для этого приложения: нажмите клавишу y.
Подтвердите сохранение всех указанных выше конфигураций: нажмите клавишу Y. Если нажать клавишу N, конфигурация не сохраняется в POM-файлах.
Чтобы развернуть приложение, используйте следующую команду:
./mvnw azure-spring-apps:deploy
В следующем списке описывается взаимодействие с командой:
Вход OAuth2: необходимо авторизовать вход в Azure на основе протокола OAuth2.
После выполнения команды можно увидеть в следующих сообщениях журнала, что развертывание выполнено успешно:
[INFO] Deployment Status: Running
[INFO] InstanceName:simple-todo-web-default-15-xxxxxxxxx-xxxxx Status:Running Reason:null DiscoverStatus:N/A
[INFO] Getting public url of app(simple-todo-web)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-simple-todo-web.azuremicroservices.io
Url-адрес выходного приложения — это конечная точка для доступа к приложению todo .
Теперь, когда облачная среда подготовлена, приложение готово к развертыванию. Чтобы развернуть приложение, используйте следующую команду:
az spring app deploy \
--service ${AZURE_SPRING_APPS_NAME} \
--name ${APP_NAME} \
--artifact-path web/target/simple-todo-web.jar
Кнопка "Развернуть в Azure" в следующем разделе запускает портал Azure интерфейс, который скачивает JAR-пакет с страницы выпусков ASA-Samples-Web-Application на сайте GitHub. Никаких локальных шагов подготовки не требуется.
Хотя вы используете портал Azure в последующих шагах, для локальной подготовки проекта необходимо использовать командную строку Bash. Выполните следующие действия, чтобы клонировать и запустить приложение локально:
Используйте следующую команду, чтобы клонировать пример проекта из GitHub:
В следующем списке описывается взаимодействие с командой:
Введите новое имя среды: укажите имя среды, которое используется в качестве суффикса для группы ресурсов, созданной для хранения всех ресурсов Azure. Это имя должно быть уникальным в подписке Azure.
Initializing a new project (azd init)
(✓) Done: Initialized git repository
(✓) Done: Downloading template code to: <your-local-path>
Enter a new environment name: <your-env-name>
SUCCESS: New project initialized!
You can view the template code in your directory: <your-local-path>
Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
3. Подготовка облачной среды
Основными ресурсами, необходимыми для запуска этого примера, являются экземпляр Azure Spring Apps и экземпляр База данных Azure для PostgreSQL. В этом разделе приведены действия по созданию этих ресурсов.
В этом разделе используется кнопка "Развернуть в Azure" для запуска интерфейса развертывания в портал Azure. В этом интерфейсе используется шаблон ARM для создания ресурсов Azure.
3.1. Войдите на портал Azure
Перейдите к портал Azure и введите учетные данные для входа на портал. Панель мониторинга службы является представлением по умолчанию.
3.2. Создание ресурсов Azure
Чтобы создать все ресурсы Azure, от которые зависит приложение, выполните следующие действия.
Нажмите следующую кнопку "Развернуть в Azure", чтобы запустить процесс развертывания в портал Azure:
Заполните форму на вкладке "Основные сведения". Используйте следующую таблицу в качестве руководства для завершения формы:
Параметр
Предлагаемое значение
Description
Подписка
Имя подписки.
Подписка Azure, которую вы хотите использовать для сервера. Если у вас есть несколько подписок, выберите ту, через которую вы предпочитаете оплачивать этот ресурс.
Группа ресурсов
myresourcegroup
Новое имя группы ресурсов или уже имеющееся из подписки.
Регион
Регион, ближайший к вашим пользователям.
Регион используется для создания группы ресурсов.
Пароль администратора PostgreSQL
Н/П
Пароль администратора сервера PostgreSQL.
Пароль пользователя PostgreSQL
Н/П
Пароль для пользователя приложения PostgreSQL, который используется в приложении.
Выберите "Рецензирование" и " Создать ", чтобы просмотреть выбранные варианты. Затем выберите "Создать ", чтобы развернуть приложение в Azure Spring Apps.
На панели инструментов щелкните значок Уведомления (колокольчик), чтобы отслеживать процесс развертывания. После завершения развертывания можно выбрать "Закрепить на панели мониторинга", которая создает плитку для этой службы на панели мониторинга портал Azure в качестве ярлыка на странице обзора службы. Выберите "Перейти к ресурсу", чтобы открыть страницу обзора службы.
Чтобы создать экземпляр Azure Spring Apps и экземпляр База данных Azure для PostgreSQL, выполните следующие действия.
3.1. Войдите на портал Azure
Перейдите к портал Azure, введите свои учетные данные и войдите на портал. Панель мониторинга службы является представлением по умолчанию.
3.2. Создание экземпляра Azure Spring Apps
Чтобы создать экземпляр службы, выполните следующие действия.
Выберите " Создать ресурс " в углу портала.
Выберите Compute>Azure Spring Apps.
Заполните форму на вкладке "Основные сведения". Используйте следующую таблицу в качестве руководства для завершения формы:
Параметр
Предлагаемое значение
Description
Подписка
Имя подписки.
Подписка Azure, которую вы хотите использовать для сервера. Если у вас есть несколько подписок, выберите ту, через которую вы предпочитаете оплачивать этот ресурс.
Группа ресурсов
myresourcegroup
Новое имя группы ресурсов или уже имеющееся из подписки.
Имя
myasa
Уникальное имя, определяющее службу Azure Spring Apps. Его длина должна быть от 4 до 32 знаков. Имя может содержать только строчные буквы, цифры и дефисы. Первым символом в имени службы должна быть буква, а последним — буква или цифра.
План
Стандартное потребление и выделенное (предварительная версия)
План ценообразования определяет ресурс и затраты, связанные с вашим экземпляром.
Регион
Регион, ближайший к вашим пользователям.
Ближайшее к пользователям расположение.
Среда приложений-контейнеров
myacaenv
Среда представляет собой безопасную границу вокруг одного или нескольких приложений контейнеров, которые могут взаимодействовать друг с другом и совместно использовать виртуальную сеть, ведение журнала и конфигурацию Dapr.
(Необязательно) Заполните вкладку "Основные сведения" , чтобы создать среду приложений контейнеров:
Имя среды: myacaenv
План: потребление
Избыточность зоны: отключена
Затем нажмите кнопку "Создать ", чтобы создать среду приложений контейнеров.
Выберите "Рецензирование" и " Создать ", чтобы просмотреть выбранные варианты. Затем выберите "Создать ", чтобы подготовить экземпляр Azure Spring Apps.
На панели инструментов щелкните значок Уведомления (колокольчик), чтобы отслеживать процесс развертывания. После завершения развертывания можно выбрать "Закрепить на панели мониторинга", которая создает плитку для этой службы на панели мониторинга портал Azure в качестве ярлыка на странице обзора службы. Выберите "Перейти к ресурсу", чтобы открыть страницу обзора службы.
3.3. Подготовка экземпляра PostgreSQL
Чтобы создать сервер База данных Azure для PostgreSQL, выполните следующие действия.
На портале Azure выберите Создать ресурс.
Выберите базы данных> База данных Azure для PostgreSQL гибкий сервер.
Метод проверки подлинности: только проверка подлинности PostgreSQL
Имя пользователя администратора: myadmin
Пароль и подтверждение пароля: введите пароль.
Настройте вкладку "Сеть" с помощью следующих сведений:
Метод подключения: общедоступный доступ (разрешенные IP-адреса)
Разрешить общедоступный доступ из любой службы Azure в Azure на этот сервер: выбрано:
Выберите "Просмотр и создание ", чтобы просмотреть выбранные элементы, а затем нажмите кнопку "Создать ", чтобы подготовить сервер. Эта операция может занять несколько минут.
Перейдите на сервер PostgreSQL в портал Azure.
Выберите базы данных из меню навигации, чтобы создать базу данных , например Todo.
3.4. Подключение экземпляра приложения к экземпляру PostgreSQL
Чтобы подключить экземпляры службы, выполните следующие действия.
Перейдите к экземпляру своей службы Azure Spring Apps на портале Azure.
В области навигации откройте приложения и нажмите кнопку "Создать приложение".
На странице "Создание приложения" для имени приложения используйте простой веб-сайт, а затем выберите "Использовать пример приложения для быстрого запуска" для создания приложения.
Нажмите кнопку "Создать ", чтобы завершить создание приложения, а затем выберите приложение, чтобы просмотреть его сведения.
Выберите "Конфигурация" в области навигации и настройте следующие свойства на вкладке переменных среды:
SUCCESS: Your application was provisioned in Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Примечание.
Выполнение этой команды может занять некоторое время. Индикатор хода выполнения отображается при подготовке ресурсов Azure.
Кнопка "Развернуть в Azure" в предыдущем разделе запускает портал Azure интерфейс, включающий развертывание приложения, поэтому ничего другого не требуется.
В следующем списке описаны взаимодействия с командами:
Выберите дочерние модули для настройки: выберите модуль для настройки, а затем введите номер веб-модуля SimpleTodo.
Вход OAuth2: необходимо авторизовать вход в Azure на основе протокола OAuth2.
Выберите подписку: выберите номер списка подписок созданного экземпляра Azure Spring Apps, который по умолчанию соответствует первой подписке в списке. Если вы используете номер по умолчанию, нажмите клавишу ВВОД напрямую.
Используйте существующие Azure Spring Apps в Azure: нажмите y , чтобы использовать существующий экземпляр Azure Spring Apps.
Выберите Azure Spring Apps для развертывания: выберите номер созданного экземпляра Azure Spring Apps. Если вы используете номер по умолчанию, нажмите клавишу ВВОД напрямую.
Предоставление общедоступного доступа для этого приложения: нажмите клавишу y.
Подтвердите сохранение всех указанных выше конфигураций: нажмите клавишу Y. Если нажать клавишу N, конфигурация не сохраняется в POM-файлах.
Чтобы развернуть приложение, используйте следующую команду:
./mvnw azure-spring-apps:deploy
В следующем списке описывается взаимодействие с командой:
Вход OAuth2: необходимо авторизовать вход в Azure на основе протокола OAuth2.
После выполнения команды можно увидеть в следующих сообщениях журнала, что развертывание выполнено успешно:
[INFO] Start updating app(simple-todo-web)...
[INFO] App(simple-todo-web) is successfully updated.
[INFO] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
[INFO] InstanceName:simple-todo-web--default-xxxxxxx-xxxxxxxxx-xxxxx Status:Running Reason:null DiscoverStatus:NONE
[INFO] Getting public url of app(simple-todo-web)...
[INFO] Application url: https://simple-todo-web.<unique-identifier>.<region-name>.azurecontainerapps.io
Url-адрес выходного приложения — это конечная точка для доступа к приложению todo .
Теперь вы можете развернуть приложение в Azure Spring Apps. Выполните следующие действия, чтобы упаковать приложение, подготовить ресурсы Azure, необходимые веб-приложению, а затем развернуть в Azure Spring Apps:
Используйте следующую команду, чтобы упаковать развертываемую копию приложения:
Deploying services (azd deploy)
(✓) Done: Deploying service simple-todo-web
- Endpoint: https://simple-todo-web.xxx.<your-azure-location>.azurecontainerapps.io
SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Выходная конечная точка — это конечная точка для доступа к приложению todo .
Примечание.
Можно также использовать azd up для объединения предыдущих трех команд: azd provision (подготавливает ресурсы Azure), azd package (упаковывает развертываемую копию приложения) и azd deploy (развертывает код приложения). Дополнительные сведения см. в статье Azure-Samples/ASA-Samples-Web-Application.
Кнопка "Развернуть в Azure" в следующем разделе запускает портал Azure интерфейс, который скачивает JAR-пакет с страницы выпусков ASA-Samples-Web-Application на сайте GitHub. Никаких локальных шагов подготовки не требуется.
Хотя вы используете портал Azure в последующих шагах, для локальной подготовки проекта необходимо использовать командную строку Bash. Выполните следующие действия, чтобы клонировать и запустить приложение локально:
Используйте следующую команду, чтобы клонировать пример проекта из GitHub:
В следующем списке описывается взаимодействие с командой:
Введите новое имя среды: укажите имя среды, которое используется в качестве суффикса для группы ресурсов, созданной для хранения всех ресурсов Azure. Это имя должно быть уникальным в подписке Azure.
Initializing a new project (azd init)
(✓) Done: Initialized git repository
(✓) Done: Downloading template code to: <your-local-path>
Please enter a new environment name: <your-env-name>
SUCCESS: New project initialized!
You can view the template code in your directory: <your-local-path>
Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
3. Подготовка облачной среды
Основными ресурсами, необходимыми для запуска этого примера, являются экземпляр Azure Spring Apps и экземпляр База данных Azure для PostgreSQL. В этом разделе приведены действия по созданию этих ресурсов.
В этом разделе используется кнопка "Развернуть в Azure" для запуска интерфейса развертывания в портал Azure. В этом интерфейсе используется шаблон ARM для создания ресурсов Azure.
3.1. Войдите на портал Azure
Перейдите к портал Azure и введите учетные данные для входа на портал. Панель мониторинга службы является представлением по умолчанию.
3.2. Создание ресурсов Azure
Чтобы создать все ресурсы Azure, от которые зависит приложение, выполните следующие действия.
Нажмите следующую кнопку "Развернуть в Azure", чтобы запустить процесс развертывания в портал Azure:
Заполните форму на вкладке "Основные сведения". Используйте следующую таблицу в качестве руководства для завершения формы:
Параметр
Предлагаемое значение
Description
Подписка
Имя подписки.
Подписка Azure, которую вы хотите использовать для сервера. Если у вас есть несколько подписок, выберите ту, через которую вы предпочитаете оплачивать этот ресурс.
Группа ресурсов
myresourcegroup
Новое имя группы ресурсов или уже имеющееся из подписки.
Регион
Регион, ближайший к вашим пользователям.
Регион используется для создания группы ресурсов.
Пароль администратора POSTgre SQL
Н/П
Пароль администратора сервера PostgreSQL.
Пароль пользователя Postgre SQL
Н/П
Пароль для пользователя приложения PostgreSQL, который используется в приложении.
Выберите "Рецензирование" и " Создать ", чтобы просмотреть выбранные варианты. Затем выберите "Создать ", чтобы развернуть приложение в Azure Spring Apps.
На панели инструментов щелкните значок Уведомления (колокольчик), чтобы отслеживать процесс развертывания. После завершения развертывания можно выбрать "Закрепить на панели мониторинга", которая создает плитку для этой службы на панели мониторинга портал Azure в качестве ярлыка на странице обзора службы. Выберите "Перейти к ресурсу", чтобы открыть страницу обзора службы.
Чтобы создать экземпляр Azure Spring Apps и экземпляр База данных Azure для PostgreSQL, выполните следующие действия.
3.1. Войдите на портал Azure
Перейдите к портал Azure и введите учетные данные для входа на портал. Панель мониторинга службы является представлением по умолчанию.
3.2. Создание экземпляра Azure Spring Apps
Чтобы создать экземпляр службы, выполните следующие действия.
Выберите " Создать ресурс " в углу портала.
Выберите Compute>Azure Spring Apps.
Заполните форму на вкладке "Основные сведения". Используйте следующую таблицу в качестве руководства для завершения формы:
Параметр
Предлагаемое значение
Description
Подписка
Имя подписки.
Подписка Azure, которую вы хотите использовать для сервера. Если у вас есть несколько подписок, выберите ту, через которую вы предпочитаете оплачивать этот ресурс.
Группа ресурсов
myresourcegroup
Новое имя группы ресурсов или уже имеющееся из подписки.
Имя
myasa
Уникальное имя, определяющее службу Azure Spring Apps. Его длина должна быть от 4 до 32 знаков. Имя может содержать только строчные буквы, цифры и дефисы. Первым символом в имени службы должна быть буква, а последним — буква или цифра.
План
Базовая
План ценообразования определяет ресурс и затраты, связанные с вашим экземпляром.
Регион
Регион, ближайший к вашим пользователям.
Ближайшее к пользователям расположение.
Избыточность между зонами
не выбрано
Создание службы Azure Spring Apps в зоне доступности Azure. В настоящее время эта функция поддерживается только в некоторых регионах.
Выберите "Рецензирование" и " Создать ", чтобы просмотреть выбранные варианты. Затем выберите "Создать ", чтобы подготовить экземпляр Azure Spring Apps.
На панели инструментов щелкните значок Уведомления (колокольчик), чтобы отслеживать процесс развертывания. После завершения развертывания можно выбрать "Закрепить на панели мониторинга", которая создает плитку для этой службы на панели мониторинга портал Azure в качестве ярлыка на странице обзора службы. Выберите "Перейти к ресурсу", чтобы открыть страницу обзора службы.
3.3. Подготовка экземпляра PostgreSQL
Чтобы создать сервер База данных Azure для PostgreSQL, выполните следующие действия.
На портале Azure выберите Создать ресурс.
Выберите базы данных> База данных Azure для PostgreSQL гибкий сервер.
Метод проверки подлинности: только проверка подлинности PostgreSQL
Имя пользователя администратора: myadmin
Пароль и подтверждение пароля: введите пароль.
Настройте вкладку "Сеть" с помощью следующих сведений:
Метод подключения: общедоступный доступ (разрешенные IP-адреса)
Разрешить общедоступный доступ из любой службы Azure в Azure на этот сервер: выбрано:
Выберите "Просмотр и создание ", чтобы просмотреть выбранные элементы, а затем нажмите кнопку "Создать ", чтобы подготовить сервер. Эта операция может занять несколько минут.
Перейдите на сервер PostgreSQL в портал Azure.
Выберите базы данных из меню навигации, чтобы создать базу данных , например Todo.
3.4. Подключение экземпляра приложения к экземпляру PostgreSQL
Чтобы подключить экземпляры службы, выполните следующие действия.
Перейдите к экземпляру своей службы Azure Spring Apps на портале Azure.
В области навигации откройте область "Приложения " и выберите " Создать приложение".
На странице "Создание приложения" для имени приложения используйте простой веб-сайт и платформу среды выполнения выберите Java 17.
Нажмите кнопку "Создать ", чтобы завершить создание приложения и выбрать приложение для просмотра сведений.
Выберите соединитель службы в области навигации и нажмите кнопку "Создать ", чтобы создать подключение к службе.
SUCCESS: Your application was provisioned in Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Примечание.
Выполнение этой команды может занять некоторое время. Индикатор хода выполнения отображается при подготовке ресурсов Azure.
Кнопка "Развернуть в Azure" в предыдущем разделе запускает портал Azure интерфейс, включающий развертывание приложения, поэтому ничего другого не требуется.
Теперь вы можете развернуть приложение в Azure Spring Apps.
В следующем списке описаны взаимодействия с командами:
Выберите дочерние модули для настройки: выберите модуль для настройки, а затем введите номер веб-модуля SimpleTodo.
Вход OAuth2: авторизация входа в Azure на основе протокола OAuth2.
Выберите подписку: выберите номер списка подписок созданного экземпляра Azure Spring Apps, который по умолчанию соответствует первой подписке в списке. Если вы используете номер по умолчанию, нажмите клавишу ВВОД напрямую.
Выберите Azure Spring Apps: выберите номер созданного экземпляра Azure Spring Apps. Если вы используете номер по умолчанию, нажмите клавишу ВВОД напрямую.
Предоставление общедоступного доступа для этого приложения?: нажмите клавишу y.
Подтвердите сохранение всех указанных выше конфигураций (Y/n): нажмите кнопку y. Если нажать клавишу N, конфигурация не сохраняется в POM-файлах.
Чтобы развернуть приложение, используйте следующую команду:
./mvnw azure-spring-apps:deploy
В следующем списке описывается взаимодействие с командой:
Вход OAuth2: необходимо авторизовать вход в Azure на основе протокола OAuth2.
После выполнения команды можно увидеть в следующих сообщениях журнала, что развертывание выполнено успешно:
[INFO] Deployment(default) is successfully created
[INFO] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
[INFO] InstanceName:simple-todo-web-default-x-xxxxxxxxxx-xxxxx Status:Running Reason:null DiscoverStatus:UNREGISTERED
[INFO] InstanceName:simple-todo-web-default-x-xxxxxxxxx-xxxxx Status:Terminating Reason:null DiscoverStatus:UNREGISTERED
[INFO] Getting public url of app(simple-todo-web)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-simple-todo-web.azuremicroservices.io
Url-адрес выходного приложения — это конечная точка для доступа к приложению todo .
Теперь вы можете развернуть приложение в Azure Spring Apps. Выполните следующие действия, чтобы упаковать приложение, подготовить ресурсы Azure, необходимые веб-приложению, а затем развернуть в Azure Spring Apps:
Используйте следующую команду, чтобы упаковать развертываемую копию приложения:
Deploying services (azd deploy)
(✓) Done: Deploying service simple-todo-web
- Endpoint: https://<your-Azure-Spring-Apps-instance-name>-simple-todo-web.azuremicroservices.io/
SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Выходная конечная точка — это конечная точка для доступа к приложению todo .
Примечание.
Можно также использовать azd up для объединения предыдущих трех команд: azd package (пакеты развертываемой копии приложения), azd provision (подготавливает ресурсы Azure) и azd deploy (развертывает код приложения). Дополнительные сведения см. в статье Azure-Samples/ASA-Samples-Web-Application.
5. Проверка веб-приложения
Теперь вы можете получить доступ к развернутом приложению, чтобы узнать, работает ли оно.
После завершения развертывания можно найти URL-адрес приложения из выходных данных развертывания:
Доступ к приложению с URL-адресом выходного приложения. Страница должна отображаться, как вы видели в localhost.
Проверьте сведения о каждом развертывании ресурсов, которые полезны для изучения проблем с развертыванием.
Доступ к приложению с URL-адресом выходного приложения. Страница должна отображаться, как вы видели в localhost.
Чтобы проверить, выполните следующие действия.
После завершения развертывания вы можете получить доступ к приложению с помощью этого URL-адреса: https://${AZURE_SPRING_APPS_NAME}-${APP_NAME}.azuremicroservices.io/ Страница должна отображаться, как вы видели в localhost.
Чтобы проверить журнал приложения, чтобы изучить любую проблему развертывания, используйте следующую команду:
az spring app logs \
--service ${AZURE_SPRING_APPS_NAME} \
--name ${APP_NAME}
После завершения развертывания найдите URL-адрес приложения из выходных данных развертывания:
Доступ к URL-адресу приложения. Страница должна отображаться, как вы видели в localhost.
Проверьте сведения о каждом развертывании ресурсов, которые полезны для изучения проблем с развертыванием.
Доступ к приложению с URL-адресом выходного приложения. Страница должна отображаться, как вы видели в localhost.
Доступ к приложению с выходной конечной точкой. Страница должна отображаться, как вы видели в localhost.
6. Очистка ресурсов
Не забудьте удалить ресурсы, созданные в этой статье, если они больше не нужны. Вы можете удалить группу ресурсов Azure, которая содержит все связанные ресурсы.
Выполните следующие действия, чтобы удалить всю группу ресурсов, включая только что созданный экземпляр службы:
Найдите группу ресурсов на портале Azure. В меню навигации выберите группы ресурсов и выберите имя группы ресурсов.
На странице группы ресурсов нажмите кнопку "Удалить". Введите имя группы ресурсов в текстовом поле, чтобы подтвердить удаление, а затем нажмите кнопку "Удалить".
Выполните следующие действия, чтобы удалить всю группу ресурсов, включая только что созданный экземпляр службы:
Найдите группу ресурсов на портале Azure. В меню навигации выберите группы ресурсов и выберите имя группы ресурсов.
На странице группы ресурсов нажмите кнопку "Удалить". Введите имя группы ресурсов в текстовом поле, чтобы подтвердить удаление, а затем нажмите кнопку "Удалить".
Используйте следующую команду, чтобы удалить все ресурсы Azure, используемые в этом примере приложения:
azd down
В следующем списке описывается взаимодействие с командой:
Общий объем ресурсов для удаления: <общий> объем ресурсов, вы уверены, что хотите продолжить?: Нажмите клавишу y.
Выполните следующие действия, чтобы удалить всю группу ресурсов, включая только что созданный экземпляр службы:
Найдите группу ресурсов на портале Azure. В меню навигации выберите группы ресурсов и выберите имя группы ресурсов.
На странице группы ресурсов нажмите кнопку "Удалить". Введите имя группы ресурсов в текстовом поле, чтобы подтвердить удаление, а затем нажмите кнопку "Удалить".
Выполните следующие действия, чтобы удалить всю группу ресурсов, включая только что созданный экземпляр службы:
Найдите группу ресурсов на портале Azure. В меню навигации выберите группы ресурсов и выберите имя группы ресурсов.
На странице группы ресурсов нажмите кнопку "Удалить". Введите имя группы ресурсов в текстовом поле, чтобы подтвердить удаление, а затем нажмите кнопку "Удалить".
Используйте следующую команду, чтобы удалить всю группу ресурсов, включая только что созданную службу: