Развертывание приложения Jakarta EE в JBoss EAP в Службе приложений Azure
В этом уроке описаны шаги по развертыванию приложения Jakarta EE в Red Hat JBoss Enterprise Application Platform (JBoss EAP) в Службе приложений Azure. В нем также описывается, как подключиться к базе данных. На самом деле вы выполните эти шаги в следующем уроке.
Создание приложения Jakarta EE
В этом модуле используется пример приложения Jakarta EE, использующего следующие технологии:
- Джакарта EE 10
- JAX-RS 3.1
- JSON-B 3.0
- CDI 4.0
- JPA 3.1
Совет
Процедура развертывания, представленная здесь, аналогична процедуре, используемой для большинства веб-приложений Jakarta EE.
Настройка проекта приложения для развертывания в Azure с помощью Maven
Корпорация Майкрософт предоставляет подключаемый модуль Maven для службы приложений Azure для развертывания веб-приложений Java в Службе приложений Azure. С помощью этого плагина Maven можно настроить следующие параметры для экземпляра App Service:
| Настройки | Описание |
|---|---|
subscriptionID |
Подписка Azure для развертывания. |
resourceGroup |
Имя группы ресурсов, в которой развертывается веб-контейнер. |
appName |
Имя экземпляра приложения для веб-контейнера. |
pricingTier |
Выбор виртуальной машины для использования. |
region |
Регион для развертывания. В этом модуле используется то же расположение, что и расположение установки MySQL. |
runtime, OS |
Используемая операционная система. В этом модуле используется Linux. |
runtime, javaVersion |
Версия виртуальной машины Java для веб-контейнера. В этом модуле используется Java 17. |
runtime, webContainer |
Веб-контейнер. В этом модуле используется Red Hat JBoss EAP 8. |
Создание пакета WAR
Для создания пакета архива веб-приложений (WAR) можно использовать команду ./mvnw package.
Заметка
При необходимости можно протестировать пакет, развернув его в локальной среде JBoss EAP.
Развертывание приложения Jakarta EE в JBoss EAP
После создания артефакта Maven, вы можете использовать команду deploy в плагине Maven для Azure App Service, чтобы развернуть приложение на JBoss EAP. Эта команда создает группу ресурсов Azure и экземпляр JBoss EAP на основе предыдущих параметров подключаемого модуля. Эта одна команда делает все, от создания экземпляров до развертывания веб-приложения Java.
Все плагины Azure Maven используют общий набор конфигураций. Полный список конфигураций см. в справочной документации по подключаемым модулям. Дополнительные сведения см. в разделе "Общая конфигурация". Дополнительные сведения о конфигурациях, относящихся к службе приложений, см. в разделе " Веб-приложение Azure: сведения о конфигурации".
Настройка подключения к базе данных с помощью источника данных и JNDI
Приложению требуется привязка к источнику данных. В следующем уроке вы настроите приложение для использования базы данных MySQL, созданной на предыдущем уроке. Чтобы подключиться к базе данных из JBoss EAP, необходимо настроить DataSource объект, который позволяет приложению подключаться к базе данных.
Вы настраиваете DataSource для подключения к экземпляру Azure Database для MySQL, который вы создали ранее, используя следующие параметры:
| Конфигурация источника данных | ценность |
|---|---|
DataSource Name |
JPAWorldDataSourceDS |
JNDI Name |
java:jboss/datasources/JPAWorldDataSource |
Connection URL |
${MYSQL_CONNECTION_URL} |
JDBC Driver Name |
$PACKAGE_NAME.war_com.mysql.cj.jdbc.Driver_9_2 |
Minimum Pool Size |
5 |
Maximum Pool Size |
20 |
JDBC Class Name |
com.mysql.cj.jdbc.Driver |
Вы использовали имя Java Naming and Directory Interface (JNDI) java:jboss/datasources/JPAWorldDataSource для источника данных. JNDI полезна в нескольких средах, чтобы изменить другую базу данных без изменений кода.
Доступ к приложению
После настройки подключения к источнику данных MySQL в JBoss EAP вы можете получить доступ к приложению Jakarta EE с помощью веб-браузера или curl команды.
В следующем уроке вы развернете пример приложения с помощью процедуры, описанной здесь.