Краткое руководство. Запуск первого приложения Java в приложениях контейнеров Azure с помощью WAR или JAR-файла

В этой статье показано, как развернуть пример приложения Spring PetClinic в сервисах контейнерных приложений Azure с помощью файла WAR (архив веб-приложения) или файла JAR (Java Archive).

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

• Развертывание из локальной файловой системы или из репозитория кода.
• Развертывание с помощью Maven или интегрированной среды разработки.
• Развертывание с помощью WAR-файла, JAR-файла или непосредственно из исходного кода.

В конце этого руководства вы развернете веб-приложение, которое можно управлять с помощью портала Azure. На следующем снимке экрана показана домашняя страница приложения PetClinic, развернутого в приложениях контейнеров Azure:

Скриншот домашней страницы приложения PetClinic.

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

• Подписка Azure. Создайте его бесплатно.
• Разрешение Contributor или Owner в подписке Azure. Дополнительные сведения см. в разделе Назначение ролей Azure с помощью портала Azure.
• Учетная запись GitHub.
• Git
• Azure CLI
• Расширение CLI для приложений контейнеров Azure версии 0.3.47 или более поздней версии. Чтобы установить последнюю версию, выполните следующую команду: az extension add --name containerapp --upgrade --allow-preview
• Комплект разработчика Java версии 17 или более поздней.
• Apache Maven

Сборка проекта

Создайте проект, выполнив следующие действия.

1. Клонируйте репозиторий Java-примеры для приложений Azure Container Apps с помощью следующей команды:

   git clone https://github.com/Azure-Samples/azure-container-apps-java-samples.git
   

1. Клонируйте репозиторий приложения Spring PetClinic Sample с помощью следующей команды:

   git clone https://github.com/spring-petclinic/spring-framework-petclinic.git
   

2. Перейдите в папку spring-petclinic с помощью следующей команды:

   cd azure-container-apps-java-samples/spring-petclinic/spring-petclinic/
   

3. Проинициализировать и обновить репозиторий обзорного приложения Spring PetClinic до последней версии с помощью следующей команды:

   git submodule update --init --recursive
   

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

   mvn clean verify
   

Теперь у вас есть файл /target/petclinic.jar .

2. Перейдите в папку spring-framework-petclinic с помощью следующей команды:

   cd spring-framework-petclinic
   

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

   mvn clean verify
   

Теперь у вас есть файл /target/petclinic.war .

Развертывание проекта

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

Примечание.

Версия JDK по умолчанию — 17. У вас есть возможность указать версию с помощью переменных среды. Чтобы изменить версию JDK для совместимости с приложением, используйте --build-env-vars BP_JVM_VERSION=<your-JDK-version> аргумент. Дополнительные сведения см. в разделе "Сборка переменных среды для Java" в приложениях контейнеров Azure (предварительная версия).

az containerapp up \
    --resource-group <resource-group> \
    --name <container-app-name> \
    --subscription <subscription-ID>\
    --location <location> \
    --environment <environment-name> \
    --artifact <JAR-file-path-and-name> \
    --ingress external \
    --target-port 8080 \
    --query properties.configuration.ingress.fqdn

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

Примечание.

Версия Tomcat по умолчанию — 9. Чтобы изменить версию для совместимости с приложением, используйте --build-env-vars BP_TOMCAT_VERSION=<your-Tomcat-version> аргумент. В этом примере версия Tomcat установлена на 10, включая все младшие версии, с использованием параметра BP_TOMCAT_VERSION=10.*. Дополнительные сведения см. в разделе "Сборка переменных среды для Java" в приложениях контейнеров Azure (предварительная версия).

az containerapp up \
    --resource-group <resource-group> \
    --name <container-app-name> \
    --subscription <subscription>\
    --location <location> \
    --environment <environment-name> \
    --artifact <WAR-file-path-and-name> \
    --build-env-vars BP_TOMCAT_VERSION=10.* \
    --ingress external \
    --target-port 8080 \
    --query properties.configuration.ingress.fqdn

Проверка состояния приложения

В этом примере containerapp up команда включает --query properties.configuration.ingress.fqdn аргумент, который возвращает полное доменное имя (FQDN), также известное как URL-адрес приложения.

Просмотрите приложение, вставив этот URL-адрес в браузер.

Очистите ресурсы

Если вы планируете продолжить работу с дополнительными учебными материалами и краткими руководствами, вы можете сохранить эти ресурсы. Если ресурсы больше не нужны, их можно удалить, чтобы избежать расходов Azure, выполнив следующую команду:

az group delete --name <resource-group>

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

• Быстрый старт: Запустите ваше первое приложение микросервиса Java с управляемыми компонентами Java в Azure Container Apps.
• Обзор примера Java PetClinic AI в Container Apps
• Создание переменных среды Java в Azure Container Apps (предварительный просмотр)