Развертывание приложений Spring Boot с помощью Azure CLI

Статья
11/06/2024

Примечание.

Планы "Базовый", "Стандартный" и "Корпоративный" будут устарели начиная с середины марта 2025 г. с 3-летнего периода выхода на пенсию. Рекомендуется перейти в приложения контейнеров Azure. Дополнительные сведения см. в объявлении о выходе на пенсию в Azure Spring Apps.

Стандартный план потребления и выделенного плана будет устарел с 30 сентября 2024 г. с полным завершением работы после шести месяцев. Рекомендуется перейти в приложения контейнеров Azure. Дополнительные сведения см. в статье "Миграция потребления Azure Spring Apps Standard" и выделенного плана в приложения контейнеров Azure.

Эта статья относится к:✅ Java ❎ C#

Эта статья относится к:✅ Basic/Standard ❎️ Enterprise

Azure Spring Apps поддерживает приложения Spring Boot в Azure.

Вы можете запускать приложение непосредственно из исходного кода Java или предварительно созданного JAR-файла. В этой статье описана процедура развертывания.

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

Прежде чем начать, убедитесь, что подписка Azure имеет необходимые зависимости:

Совет

Azure Cloud Shell — это бесплатная интерактивная оболочка, с помощью которой можно выполнять действия, описанные в этой статье. Она содержит предварительно установленные общие инструменты Azure вместе с новейшими версиями Git, JDK, Maven и Azure CLI. Если вы вошли в подписку Azure, запустите Azure Cloud Shell на сайте shell.azure.com. Дополнительные сведения об Azure Cloud Shell см. в нашей документации

Установка расширения Azure CLI

Установите расширение Azure Spring Apps для Azure CLI, выполнив следующую команду:

az extension add --name spring

Подготовка экземпляра службы к работе с помощью Azure CLI

Войдите в Azure CLI и выберите активную подписку.

az login
az account list -o table
az account set --subscription <subscription-id>

Создайте группу ресурсов, которая будет содержать службу в Azure Spring Apps. Узнайте больше о группах ресурсов Azure.

az group create --location eastus --name <resource-group-name>

Выполните следующие команды, чтобы подготовить экземпляр Azure Spring Apps к работе. Присвойте службе имя в Azure Spring Apps. Его длина должна быть от 4 до 32 знаков. Имя может содержать только строчные буквы, цифры и дефисы. Первым символом в имени службы должна быть буква, а последним — буква или цифра.

az spring create --resource-group <resource-group-name> --name <resource-name>

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

Задайте стандартные имена группы ресурсов и экземпляра Azure Spring Apps с помощью следующих команд:

az config set defaults.group=<service-group-name>
az config set defaults.spring=<service-instance-name>

Создание приложения в Azure Spring Apps

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

az spring app create --name <app-name>

Развертывание приложения Spring Boot

Приложение можно развернуть из предварительно созданного JAR-файла либо из репозитория Gradle или Maven. Инструкции для каждого варианта приведены ниже.

Развертывание предварительно созданного JAR-файла

Чтобы выполнить развертывание из JAR-файла, созданного на локальном компьютере, при сборке должен создаваться расширенный JAR-файл.

Развертывание расширенного JAR-файла в активном развертывании

az spring app deploy --name <app-name> --artifact-path <path-to-fat-JAR>

Развертывание расширенного JAR-файла в конкретном развертывании

az spring app deployment create --app <app-name> \
    --name <deployment-name> \
    --artifact-path <path-to-fat-JAR>

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

Для сборки проекта Azure Spring Apps использует kpack. Вы можете использовать Azure CLI для передачи исходного кода, выполнить сборку проекта с помощью kpack и развернуть его в целевом приложении.

Предупреждение

Проект должен создать только один JAR-файл с записью main-class в MANIFEST.MF в target (для развертываний Maven) или build/libs (для развертываний Gradle). Несколько JAR-файлов с записями main-class приведут к сбою развертывания.

Для проектов с одним модулем Maven или Gradle:

cd <path-to-maven-or-gradle-source-root>
az spring app deploy --name <app-name> --source-path

Для проектов Maven или Gradle с несколькими модулями повторите эти действия для каждого модуля:

cd <path-to-maven-or-gradle-source-root>
az spring app deploy --name <app-name> --source-path \
    --target-module <relative-path-to-module>

Отображение журналов развертывания

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

az spring app show-deploy-log --name <app-name>

Примечание.

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

Назначение общедоступной конечной точки приложению

Откройте область "Приложения", чтобы просмотреть приложения для экземпляра службы.
Выберите приложение для просмотра страницы обзора .
Выберите " Назначить конечную точку", чтобы назначить общедоступную конечную точку приложению. Этот процесс может занять несколько минут.
Скопируйте URL-адрес на странице обзора и вставьте его в браузер, чтобы просмотреть запущенное приложение.

Следующие шаги

Краткое руководство. Мониторинг приложений Azure Spring Apps с помощью журналов, метрик и трассировки

Дополнительные примеры доступны на GitHub в разделе Примеры для Azure Spring Apps.

Поделиться через