Краткое руководство. Создание приложения Java в службе приложение Azure

Служба приложений Azure предоставляет высокомасштабируемую, самоподдерживающуюся и самовосстанавливающуюся службу размещения веб-приложений. В этом кратком руководстве вы используете плагин Maven для веб-приложений в Службе приложений Azure для развертывания Java веб-приложения на сервере Linux Tomcat в Службе приложений Azure.

Если Maven не является вашим предпочтительным средством разработки, ознакомьтесь со следующими статьями для разработчиков Java:

• Градл
• IntelliJ IDEA
• Затмение
• Visual Studio Code

Предпосылки

• Если у вас нет аккаунта Azure, создайте бесплатную учетную запись перед началом.

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

  1. Нажмите следующую кнопку "Запустить Cloud Shell" или перейдите к https://shell.azure.com открытию Cloud Shell в браузере.

     

  2. При необходимости войдите в Azure и убедитесь, что вы находитесь в среде Bash Cloud Shell.

  3. Выберите "Копировать " в блоке кода, вставьте код в Cloud Shell и запустите его.

Создание приложения Java

Выполните следующую команду Maven в Cloud Shell, чтобы создать новое приложение с именем helloworld:

mvn archetype:generate "-DgroupId=example.demo" "-DartifactId=helloworld" "-DarchetypeArtifactId=maven-archetype-webapp" "-DarchetypeVersion=1.4" "-Dversion=1.0-SNAPSHOT"

Затем измените рабочий каталог на папку проекта, выполнив команду cd helloworld.

Настройка подключаемого модуля Maven

Процесс развертывания службы приложений автоматически использует учетные данные Azure из Cloud Shell. Плагин Maven проходит проверку подлинности с помощью OAuth или авторизации устройства. Дополнительные сведения см. в разделе Authenticate to the Speech API (Аутентификация в API речи).

Выполните следующую команду Maven, чтобы настроить развертывание, задав операционную систему службы приложений, версию Java и версию Tomcat.

mvn com.microsoft.azure:azure-webapp-maven-plugin:2.14.1:config

1. Для создания новой конфигурации запуска введите Y и нажмите клавишу ВВОД.
2. Для определения значения ОС введите 2 для Linux и нажмите клавишу ВВОД.
3. Для определения значения javaVersion введите 1 для Java 21 и нажмите клавишу ВВОД.
4. Для определения значения для webContainer введите 1 для Tomcat 10.1 и нажмите клавишу ВВОД.
5. Для определения значения для ценовой категории введите 3 для P1V2 и нажмите Enter.
6. Для подтверждения введите Y и нажмите клавишу ВВОД.

Выходные данные должны выглядеть примерно так:

Please confirm webapp properties
AppName : helloworld-1745408005556
ResourceGroup : helloworld-1745408005556-rg
Region : centralus
PricingTier : P1V2
OS : Linux
Java Version: Java 21
Web server stack: Tomcat 10.1
Deploy to slot : false
Confirm (Y/N) [Y]: 
[INFO] Saving configuration to pom.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  01:36 min
[INFO] Finished at: 2025-04-23T11:34:44Z
[INFO] ------------------------------------------------------------------------

После подтверждения выбора, плагин добавляет элемент и необходимые настройки в файл pom.xml проекта, который настраивает веб-приложение для работы в App Service.

Соответствующая часть файла pom.xml должна выглядеть примерно так, как показано в следующем примере.

<build>
    <plugins>
        <plugin>
            <groupId>com.microsoft.azure</groupId>
            <artifactId>>azure-webapp-maven-plugin</artifactId>
            <version>x.xx.x</version>
            <configuration>
                <schemaVersion>v2</schemaVersion>
                <resourceGroup>helloworld-1745408005556-rg</resourceGroup>
                <appName>helloworld-1745408005556</appName>
            ...
            </configuration>
        </plugin>
    </plugins>
</build>

Значения для <appName> и <resourceGroup>, helloworld-1745408005556 и helloworld-1745408005556-rg для демонстрационного приложения используются позже.

Конфигурации службы приложений можно изменить непосредственно в файлеpom.xml .

• Полный список конфигураций см. в разделе "Общие конфигурации".
• Сведения о конфигурациях, относящихся к службе приложений, см. в разделе " Веб-приложение Azure: сведения о конфигурации".

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

Когда все настройки в файлеpom.xml завершены, вы можете развернуть своё Java-приложение в Azure с помощью следующей команды.

mvn package azure-webapp:deploy

Выбрав список доступных подписок, Maven развертывается в Службе приложений Azure. После завершения развертывания приложение будет готово.

Для этой демонстрации URL-адрес: http://helloworld-1745408005556.azurewebsites.net. При открытии URL-адреса в локальном веб-браузере вы увидите следующее приложение:

Поздравляем! Вы развернули приложение Java в службе приложений.

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

Вы создали ресурсы для этого руководства в группе ресурсов Azure. Если они больше не нужны, вы можете удалить группу ресурсов и все ее ресурсы, выполнив следующую команду Azure CLI в Cloud Shell.

az group delete --name helloworld-1745408005556-rg --yes

Для выполнения команды может потребоваться некоторое время.

Служба приложений Azure предоставляет высокомасштабируемую, самоподдерживающуюся и самовосстанавливающуюся службу размещения веб-приложений. В этом кратком руководстве вы используете плагин Maven для веб-приложений Службы приложений Azure, чтобы развернуть веб-приложение Java с встроенным сервером Spring Boot, Quarkus или Tomcat в Службе приложений. Дополнительные сведения см. в статье azure-webapp-maven-plugin.

Если Maven не является вашим предпочтительным средством разработки, ознакомьтесь со следующими статьями для разработчиков Java:

• Градл
• IntelliJ IDEA
• Затмение
• Visual Studio Code

Предпосылки

• Если у вас нет аккаунта Azure, создайте бесплатную учетную запись перед началом.

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

  1. Нажмите следующую кнопку "Запустить Cloud Shell" или перейдите к https://shell.azure.com открытию Cloud Shell в браузере.

     

  2. При необходимости войдите в Azure и убедитесь, что вы находитесь в среде Bash Cloud Shell.

  3. Выберите "Копировать " в блоке кода, вставьте код в Cloud Shell и запустите его.

Получение примера приложения

Выберите соответствующую вкладку и следуйте инструкциям, чтобы получить пример веб-приложения Spring Boot, Quarkus или Embedded Tomcat.

git clone https://github.com/rd-1-2022/rest-service my-webapp

Настройка подключаемого модуля Maven

Процесс развертывания службы приложений автоматически использует учетные данные Azure из Cloud Shell. Плагин Maven проходит проверку подлинности с помощью OAuth или авторизации устройства. Дополнительные сведения см. в разделе Authenticate to the Speech API (Аутентификация в API речи).

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

mvn com.microsoft.azure:azure-webapp-maven-plugin:2.14.1:config

1. Для создания новой конфигурации запуска введите Y и нажмите клавишу ВВОД.
2. Для определения значения ОС введите 2 для Linux и нажмите клавишу ВВОД.
3. Для определения значения javaVersion введите 1 для Java 21 и нажмите клавишу ВВОД.
4. Для задачи уровня ценообразования введите 3 для P1v2 и нажмите клавишу ENTER.
5. Для подтверждения введите Y и нажмите клавишу ВВОД.

Выходные данные должны выглядеть примерно так:

Please confirm webapp properties
AppName : <generated-app-name>
ResourceGroup : <generated-app-name>-rg
Region : centralus
PricingTier : P1v2
OS : Linux
Java Version: Java 21
Web server stack: Java SE
Deploy to slot : false
Confirm (Y/N) [Y]: 
[INFO] Saving configuration to pom.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  47.533 s
[INFO] Finished at: 2025-04-23T12:20:08Z
[INFO] ------------------------------------------------------------------------

После подтверждения выбора, плагин добавляет элемент и необходимые настройки в файл pom.xml проекта, который настраивает веб-приложение для работы в App Service.

Соответствующая часть файла pom.xml должна выглядеть примерно так, как показано в следующем примере.

<build>
    <plugins>
        <plugin>
            <groupId>com.microsoft.azure</groupId>
            <artifactId>>azure-webapp-maven-plugin</artifactId>
            <version>x.xx.x</version>
            <configuration>
                <schemaVersion>v2</schemaVersion>
                <resourceGroup>generated-app-name-rg</resourceGroup>
                <appName>generated-app-name</appName>
            ...
            </configuration>
        </plugin>
    </plugins>
</build>

Значения для <appName> и <resourceGroup> используются позже.

Конфигурации службы приложений можно изменить непосредственно в файлеpom.xml .

• Полный список конфигураций см. в разделе "Общие конфигурации".
• Сведения о конфигурациях, относящихся к службе приложений, см. в разделе " Веб-приложение Azure: сведения о конфигурации".

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

Поскольку все конфигурации готовы в вашем файле pom.xml, вы можете развернуть Java-приложение в Azure.

Поздравляем! Вы развернули приложение Java в службе приложений.

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

Вы создали ресурсы для этого руководства в группе ресурсов Azure. Если они больше не нужны, вы можете удалить группу ресурсов и все ее ресурсы, выполнив следующую команду Azure CLI в Cloud Shell.

az group delete --name <resource group name>  --yes

Например, выполните команду az group delete --name quarkus-hello-azure-1690375364238-rg --yes. Выполнение этой команды может занять некоторое время.

Служба приложений Azure предоставляет высокомасштабируемую, самоподдерживающуюся и самовосстанавливающуюся службу размещения веб-приложений. В этом руководстве по быстрому старту вы используете плагин Maven для Платформы Azure App Service, чтобы развернуть Java веб-приложение на сервере Linux JBoss EAP в Azure App Service.

Если Maven не является вашим предпочтительным средством разработки, ознакомьтесь со следующими статьями для разработчиков Java:

• Градл
• IntelliJ IDEA
• Затмение
• Visual Studio Code

Предпосылки

• Если у вас нет аккаунта Azure, создайте бесплатную учетную запись перед началом.

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

  1. Нажмите следующую кнопку "Запустить Cloud Shell" или перейдите к https://shell.azure.com открытию Cloud Shell в браузере.

     

  2. При необходимости войдите в Azure и убедитесь, что вы находитесь в среде Bash Cloud Shell.

  3. Выберите "Копировать " в блоке кода, вставьте код в Cloud Shell и запустите его.

Создание приложения Java

1. Клонируйте демонстрационное приложение для магазина Pet.

   git clone https://github.com/Azure-Samples/app-service-java-quickstart
   

2. Измените каталог на завершенный petstore-ee7 проект и создайте его.

   cd app-service-java-quickstart
   git checkout 20230308
   cd petstore-ee7
   mvn clean install
   

   Если появится сообщение об отключенном состоянии HEAD, его можно игнорировать. Вы не выполняете никаких коммитов в Git в этом кратком руководстве, поэтому режим отсоединенной HEAD подходит.

   Совет

   Для petstore-ee7 примера требуется Java 11 или более поздней версии. Для booty-duke-app-service примера проекта требуется Java 17. Если установленная версия Java меньше 17, запустите сборку из каталога petstore-ee7 вместо верхнего уровня.

Настройка подключаемого модуля Maven

Процесс развертывания службы приложений автоматически использует учетные данные Azure из Cloud Shell. Плагин Maven проходит проверку подлинности с помощью OAuth или авторизации устройства. Дополнительные сведения см. в разделе Authenticate to the Speech API (Аутентификация в API речи).

Выполните следующую команду Maven, чтобы настроить развертывание, задав операционную систему службы приложений, версию Java и версию Jbosseap.

mvn com.microsoft.azure:azure-webapp-maven-plugin:2.14.1:config

1. Для создания новой конфигурации запуска введите Y и нажмите клавишу ВВОД.
2. Для определения значения ОС введите 2 для Linux и нажмите клавишу ВВОД.
3. Для определения значения javaVersion введите 2 для Java 17 и нажмите клавишу ВВОД. Если выбрать Java 21, вы не увидите Jbosseap как вариант позже.
4. Для определения значения для webContainer введите 4 для Jbosseap 7 и нажмите клавишу ВВОД.
5. Для определения значения для уровня цен введите 1 чтобы выбрать P1v3 и нажмите клавишу ВВОД.
6. Для подтверждения введите Y и нажмите клавишу ВВОД.

Выходные данные должны выглядеть примерно так:

Please confirm webapp properties
AppName : petstoreee7-1745409173307
ResourceGroup : petstoreee7-1745409173307-rg
Region : centralus
PricingTier : P1v3
OS : Linux
Java Version: Java 17
Web server stack: Jbosseap 4
Deploy to slot : false
Confirm (Y/N) [Y]: 
[INFO] Saving configuration to pom.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  01:36 min
[INFO] Finished at: 2025-04-23T11:54:22Z
[INFO] ------------------------------------------------------------------------

После подтверждения выбора, плагин добавляет элемент и необходимые настройки в файл pom.xml проекта, который настраивает веб-приложение для работы в App Service.

Соответствующая часть файла pom.xml должна выглядеть примерно так, как показано в следующем примере.

<build>
    <plugins>
        <plugin>
            <groupId>com.microsoft.azure</groupId>
            <artifactId>>azure-webapp-maven-plugin</artifactId>
            <version>x.xx.x</version>
            <configuration>
                <schemaVersion>v2</schemaVersion>
                <resourceGroup>petstoreee7-1745409173307-rg</resourceGroup>
                <appName>petstoreee7-1745409173307</appName>
            ...
            </configuration>
        </plugin>
    </plugins>
</build>

Значения для <appName> и <resourceGroup>, petstoreee7-1745409173307 и petstoreee7-1745409173307-rg в демонстрационном приложении используются позже.

Конфигурации службы приложений можно изменить непосредственно в файлеpom.xml .

• Полный список конфигураций см. в разделе "Общие конфигурации".
• Сведения о конфигурациях, относящихся к службе приложений, см. в разделе " Веб-приложение Azure: сведения о конфигурации".

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

После настройки конфигурации в файлеpom.xml вы можете развернуть приложение Java в Azure следующей командой.

# Disable testing, as it requires Wildfly to be installed locally.
mvn package azure-webapp:deploy -DskipTests

Выбрав список доступных подписок, Maven развертывается в Службе приложений Azure. После завершения развертывания приложение будет готово.

Для этого демонстрационного приложения используется http://petstoreee7-1745409173307.azurewebsites.netURL-адрес. При открытии URL-адреса в локальном веб-браузере вы увидите следующее приложение:

Поздравляем! Вы развернули приложение Java в службе приложений.

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

Вы создали ресурсы для этого руководства в группе ресурсов Azure. Если они больше не нужны, вы можете удалить группу ресурсов и все ее ресурсы, выполнив следующую команду Azure CLI в Cloud Shell.

az group delete --name petstoreee7-1745409173307-rg  --yes

Для выполнения команды может потребоваться некоторое время.