Краткое руководство. Развертывание первого приложения в Azure Spring Apps

  • Статья

Примечание

Первые 50 часов виртуальных ЦП и 100 ГБ памяти освобождаются каждый месяц. Дополнительные сведения см. в статье Снижение цен— Azure Spring Apps делает больше, а затраты меньше! в блоге Приложения в Azure.

Примечание

Azure Spring Apps — это новое название службы Azure Spring Cloud. Старое название будет еще некоторое время встречаться в наших материалах, пока мы не обновим ресурсы, такие как снимки экрана, видео и схемы.

В этой статье объясняется, как развернуть небольшое приложение для запуска в Azure Spring Apps.

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

В этой статье описываются следующие два варианта развертывания в Azure Spring Apps.

  • Портал Azure — это более традиционный способ пошагового создания ресурсов и развертывания приложений. Он подходит для разработчиков Spring, которые впервые используют облачные службы Azure.
  • Azure Developer CLI — это более эффективный способ автоматического создания ресурсов и развертывания приложений с помощью простых команд. Он охватывает код приложения и инфраструктуру как файлы кода, необходимые для подготовки ресурсов Azure. Он подходит для разработчиков Spring, знакомых с облачными службами Azure.

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

2. Подготовка проекта Spring

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

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

    git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git

  2. Используйте следующую команду для перемещения в папку проекта:

    cd gs-spring-boot-for-azure/complete

  3. Используйте следующую команду Maven для сборки проекта:

    ./mvnw clean package

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

    ./mvnw spring-boot:run

3. Подготовка облачной среды

Ресурс main, необходимый для запуска этого примера, — это экземпляр Azure Spring Apps. Чтобы создать этот ресурс, выполните следующие действия.

3.1. Вход на портал Azure

Откройте веб-браузер и перейдите к портал Azure. Введите свои учетные данные для входа на портал. Панель мониторинга службы является представлением по умолчанию.

3.2. Создание экземпляра Azure Spring Apps

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

  1. Выберите Создать ресурс в углу портал Azure.

  2. Выберите Вычисления>Azure Spring Apps.

    Снимок экрана: портал Azure, на котором в списке вычислительных ресурсов отображается Azure Spring Apps.

  3. Заполните форму Основные данные , указав следующую информацию:

    Используйте следующую таблицу в качестве руководства по заполнению формы. Рекомендуемый план — Standard consumption & dedicated (preview).

    Параметр Рекомендуемое значение Описание
    Подписка Имя вашей подписки Подписка Azure, которую вы хотите использовать для сервера. Если у вас есть несколько подписок, выберите ту, через которую вы предпочитаете оплачивать этот ресурс.
    Группа ресурсов myresourcegroup Новое имя группы ресурсов или уже имеющееся из подписки.
    Имя myasa Уникальное имя, определяющее службу Azure Spring Apps. Его длина должна быть от 4 до 32 знаков. Имя может содержать только строчные буквы, цифры и дефисы. Первым символом в имени службы должна быть буква, а последним — буква или цифра.
    Планирование Выделенное потребление & уровня "Стандартный" (предварительная версия) Тарифный план определяет ресурс и затраты, связанные с экземпляром.
    Region Ближайший к пользователям регион Ближайшее к пользователям расположение.
    Среда приложений-контейнеров myacaenv Среда представляет собой безопасную границу вокруг одного или нескольких контейнерных приложений, которые могут взаимодействовать друг с другом и совместно использовать виртуальную сеть, ведение журнала и конфигурацию Dapr.

    Снимок экрана: портал Azure, на котором показана страница

  4. (Необязательно) Создайте среду контейнеров приложений.

    1. Заполните вкладку Основные сведения следующими сведениями:

      • Имя среды: myacaenv
      • План: потребление
      • Избыточность между зонами: отключено

      Снимок экрана: портал Azure, на котором показана среда создания контейнеров приложений с выбранным планом потребления.

    2. Выберите Создать , чтобы создать среду контейнеров приложений.

  5. Выберите Просмотр и создание , чтобы просмотреть выбранные варианты. Выберите Создать , чтобы подготовить экземпляр Azure Spring Apps.

  6. На панели инструментов щелкните значок Уведомления (колокольчик), чтобы отслеживать процесс развертывания. После завершения развертывания можно выбрать Закрепить на панели мониторинга, чтобы создать плитку для этой службы на панели мониторинга портал Azure в качестве ярлыка на странице обзора службы.

    Снимок экрана: портал Azure, на котором показана панель уведомлений для создания Azure Spring Apps.

  7. Выберите Перейти к ресурсу , чтобы перейти на страницу обзора Azure Spring Apps .

4. Развертывание приложения в Azure Spring Apps

В этом разделе приведены шаги по развертыванию приложения в Azure Spring Apps.

Выполните следующие действия для развертывания с помощью подключаемого модуля Maven для Azure Spring Apps.

  1. Перейдите в полный каталог и выполните следующую команду, чтобы настроить приложение в Azure Spring Apps:

    ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.18.0:config

    В следующем списке описано взаимодействие с командами:

    • Вход OAuth2. Необходимо авторизовать вход в Azure на основе протокола OAuth2.
    • Выберите подписку. Выберите номер созданного экземпляра Azure Spring Apps в списке. По умолчанию используется первая подписка в списке. Если используется номер по умолчанию, нажмите клавишу ВВОД .
    • Выберите Azure Spring Apps для развертывания. Выберите номер списка созданного экземпляра Azure Spring Apps. Если используется номер по умолчанию, нажмите клавишу ВВОД .
    • Введите имя приложения: укажите имя приложения. Если вы используете идентификатор артефакта проекта по умолчанию, нажмите клавишу ВВОД .
    • Предоставление общего доступа к этому приложению (загрузка для Azure)?: нажмите кнопку y.
    • Подтвердите сохранение всех указанных выше конфигураций (Y/n): нажмите y. Если нажать клавишу n, конфигурация не будет сохранена в файлах POM.

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

    ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.18.0:deploy

    В следующем списке описано взаимодействие с командами:

    • Вход OAuth2. Необходимо авторизовать вход в Azure на основе протокола OAuth2.

    После выполнения команды вы увидите из следующих сообщений журнала, что развертывание прошло успешно:

    [INFO] Deployment(default) is successfully updated.
[INFO] Deployment Status: Running
[INFO]   InstanceName:demo-default-x-xxxxxxxxxx-xxxxx  Status:Running Reason:null       DiscoverStatus:UNREGISTERED
[INFO] Getting public url of app(demo)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io

2. Подготовка проекта Spring

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

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

    git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git

  2. Используйте следующую команду для перемещения в папку проекта:

    cd gs-spring-boot-for-azure/complete

  3. Используйте следующую команду Maven для сборки проекта:

    ./mvnw clean package

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

    ./mvnw spring-boot:run

3. Подготовка облачной среды

Ресурс main, необходимый для запуска этого примера, — это экземпляр Azure Spring Apps. Чтобы создать этот ресурс, выполните следующие действия.

3.1. Вход на портал Azure

Откройте веб-браузер и перейдите к портал Azure. Введите свои учетные данные для входа на портал. Панель мониторинга службы является представлением по умолчанию.

3.2. Создание экземпляра Azure Spring Apps

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

  1. Выберите Создать ресурс в углу портал Azure.

  2. Выберите Вычисления>Azure Spring Apps.

    Снимок экрана: портал Azure, на котором в списке вычислительных ресурсов отображается Azure Spring Apps.

  3. Заполните форму Основные данные , указав следующую информацию:

    Параметр Рекомендуемое значение Описание
    Подписка Имя вашей подписки Подписка Azure, которую вы хотите использовать для сервера. Если у вас есть несколько подписок, выберите ту, через которую вы предпочитаете оплачивать этот ресурс.
    Группа ресурсов myresourcegroup Новое имя группы ресурсов или уже имеющееся из подписки.
    Имя myasa Уникальное имя, определяющее службу Azure Spring Apps. Его длина должна быть от 4 до 32 знаков. Имя может содержать только строчные буквы, цифры и дефисы. Первым символом в имени службы должна быть буква, а последним — буква или цифра.
    Планирование Standard Edition Тарифный план, определяющий ресурс и затраты, связанные с вашим экземпляром.
    Region Ближайший к пользователям регион Ближайшее к пользователям расположение.
    Избыточность между зонами Unselected Указывает, следует ли создавать службу Azure Spring Apps в зоне доступности Azure. В настоящее время эта функция поддерживается не во всех регионах.

    Снимок экрана: портал Azure, на котором показана страница

  4. Выберите Просмотр и создание , чтобы просмотреть выбранные варианты. Выберите Создать , чтобы подготовить экземпляр Azure Spring Apps.

  5. На панели инструментов щелкните значок Уведомления (колокольчик), чтобы отслеживать процесс развертывания. После завершения развертывания можно выбрать Закрепить на панели мониторинга, чтобы создать плитку для этой службы на панели мониторинга портал Azure в качестве ярлыка на странице "Обзор" службы.

    Снимок экрана: портал Azure, на котором показана панель уведомлений для создания Azure Spring Apps.

  6. Выберите Перейти к ресурсу , чтобы перейти на страницу Обзор Azure Spring Apps .

4. Развертывание приложения в Azure Spring Apps

В этом разделе описано, как развернуть приложение в Azure Spring Apps.

Выполните следующие действия для развертывания с помощью подключаемого модуля Maven для Azure Spring Apps.

  1. Перейдите в полный каталог и выполните следующую команду, чтобы настроить приложение в Azure Spring Apps:

    ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.18.0:config

    В следующем списке описано взаимодействие с командами.

    • Вход OAuth2. Необходимо авторизовать имя входа в Azure на основе протокола OAuth2.
    • Выбрать подписку. Выберите номер списка подписки созданного экземпляра Azure Spring Apps, который по умолчанию будет использовать первую подписку в списке. Если вы используете номер по умолчанию, нажмите клавишу ВВОД напрямую.
    • Выберите Azure Spring Apps для развертывания. Выберите номер списка созданного экземпляра Azure Spring Apps. Если вы используете номер по умолчанию, нажмите клавишу ВВОД напрямую.
    • Введите имя приложения. Укажите имя приложения. Если вы используете идентификатор артефакта проекта по умолчанию, нажмите клавишу ВВОД напрямую.
    • Предоставление общедоступного доступа для этого приложения (загрузка для Azure)?: нажмите y.
    • Подтвердите сохранение всех указанных выше конфигураций (Y/n): нажмите y. Если нажать n, конфигурация не будет сохранена в POM-файлах.

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

    ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.18.0:deploy

    В следующем списке описано взаимодействие с командами.

    • Вход OAuth2. Необходимо авторизовать имя входа в Azure на основе протокола OAuth2.

    После выполнения команды из следующих сообщений журнала можно увидеть, что развертывание выполнено успешно:

    [INFO] Deployment(default) is successfully updated.
[INFO] Deployment Status: Running
[INFO]   InstanceName:demo-default-x-xxxxxxxxxx-xxxxx  Status:Running Reason:null       DiscoverStatus:UNREGISTERED
[INFO] Getting public url of app(demo)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io

2. Подготовка проекта Spring

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

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

    git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git

  2. Используйте следующую команду для перемещения в папку проекта:

    cd gs-spring-boot-for-azure/complete

  3. Используйте следующую команду Maven для сборки проекта:

    ./mvnw clean package

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

    ./mvnw spring-boot:run

3. Подготовка облачной среды

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

3.1. Укажите имена для каждого ресурса

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

export LOCATION="<region>"
export RESOURCE_GROUP="<resource-group-name>"
export SERVICE_NAME="<Azure-Spring-Apps-instance-name>"
export APP_NAME="demo"

3.2. Создание группы ресурсов

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

  1. Чтобы войти в Azure CLI, используйте следующую команду:

    az login

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

    az configure --defaults location=${LOCATION}

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

    az account list --output table

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

    az account set --subscription <subscription-ID>

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

    az group create --resource-group ${RESOURCE_GROUP}

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

    az configure --defaults group=${RESOURCE_GROUP}

3.3. Установка расширения и регистрация пространства имен

Используйте следующие команды, чтобы установить расширение Azure Spring Apps для Azure CLI и зарегистрировать пространство имен: Microsoft.SaaS:

az extension add --name spring --upgrade
az provider register --namespace Microsoft.SaaS

3.4. Создание экземпляра Azure Spring Apps

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

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

    Примечание

    Этот шаг необходим, только если ваша подписка никогда не использовалась для создания экземпляра плана Enterprise Azure Spring Apps.

    az term accept \
    --publisher vmware-inc \
    --product azure-spring-cloud-vmware-tanzu-2 \
    --plan asa-ent-hr-mtr

  2. Чтобы создать экземпляр службы "Приложения Azure Spring", используйте следующую команду:

    az spring create \
    --name ${SERVICE_NAME} \
    --sku Enterprise

3.5. Создание приложения в экземпляре Azure Spring Apps

Приложение — это абстракция одного бизнес-приложения. Дополнительные сведения см. в статье Приложение и развертывание в Azure Spring Apps. Приложения выполняются в экземпляре службы Azure Spring Apps, как показано на следующей схеме.

Схема, показывающая связь между приложениями и экземпляром службы Azure Spring Apps.

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

az spring app create \
    --service ${SERVICE_NAME} \
    --name ${APP_NAME} \
    --assign-endpoint true

4. Развертывание приложения в Azure Spring Apps

В этом разделе приведены шаги по развертыванию приложения в Azure Spring Apps.

Используйте следующую команду, чтобы развернуть JAR-файл для приложения:

az spring app deploy \
    --service ${SERVICE_NAME} \
    --name ${APP_NAME} \
    --artifact-path target/demo-0.0.1-SNAPSHOT.jar

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

5. Проверка приложения

После развертывания вы можете получить доступ к приложению по адресу https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io. При открытии приложения вы получите ответ Hello World.

В области навигации на странице обзора экземпляра Azure Spring Apps выберите Журналы, чтобы проверка журналы приложения.

Снимок экрана: портал Azure, на котором показана страница журналов Azure Spring Apps.

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

az spring app logs \
    --service ${SERVICE_NAME} \
    --name ${APP_NAME}

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

Не забудьте удалить ресурсы, созданные в этой статье, если они вам больше не нужны. Чтобы удалить ресурсы, просто удалите группу ресурсов, которая их содержит. Группу ресурсов можно удалить с помощью портал Azure. Кроме того, чтобы удалить группу ресурсов с помощью Azure CLI, используйте следующую команду:

az group delete --name ${RESOURCE_GROUP}

Вы можете удалить группу ресурсов Azure, которая содержит все связанные ресурсы.

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

  1. Найдите группу ресурсов на портале Azure. В меню навигации выберите Группы ресурсов. Затем выберите имя группы ресурсов, например myresourcegroup.

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

7. Дальнейшие действия

Структурированный журнал приложений для Azure Spring Apps

Сопоставление существующего личного домена с Azure Spring Apps

Использование CI/CD Azure Spring Apps с помощью GitHub Actions

Автоматизация развертываний приложений в Azure Spring Apps

Использование управляемых удостоверений для приложений в Azure Spring Apps

Создание подключения к службе в Azure Spring Apps с помощью Azure CLI

Общие сведения о примере приложения

Общие сведения о примере приложения Магазина фитнеса

Дополнительные сведения см. в следующих статьях: