将 Jakarta EE 应用程序部署到 Azure 应用服务上的 JBoss EAP
本单元介绍将 Jakarta EE 应用程序部署到 Azure 应用服务上的 Red Hat JBoss Enterprise 应用程序平台(JBoss EAP)的步骤。 它还介绍了如何连接到数据库。 你将在下一个单元中实际执行这些步骤。
创建 Jakarta EE 应用程序
在本模块中,你将使用使用以下技术的示例 Jakarta EE 应用程序:
- Jakarta EE 10
- JAX-RS 3.1
- JSON-B 3.0
- CDI 4.0
- JPA 3.1
小窍门
此处引入的部署过程类似于用于大多数 Jakarta EE Web 应用程序的过程。
使用 Maven 配置要部署到 Azure 的应用程序项目
Microsoft提供适用于 Azure 应用服务的 Maven 插件,用于将 Java Web 应用程序部署到 Azure 应用服务。 使用此 Maven 插件,可以为应用服务实例配置以下设置:
设置 | DESCRIPTION |
---|---|
subscriptionID |
用于部署的 Azure 订阅。 |
resourceGroup |
在其中部署 Web 容器的资源组的名称。 |
appName |
Web 容器的应用程序实例名称。 |
pricingTier |
要使用的虚拟机的选择。 |
region |
要部署到的区域。 在本模块中,将使用与 MySQL 安装位置相同的位置。 |
runtime 、OS |
要使用的操作系统。 在本模块中,你将使用 Linux 。 |
runtime 、javaVersion |
Web 容器的 Java 虚拟机版本。 在本模块中,你将使用 Java 17 。 |
runtime 、webContainer |
Web 容器。 在本模块中,你将使用 Red Hat JBoss EAP 8 。 |
生成 WAR 包
可以使用 ./mvnw package
该命令生成 Web 应用程序存档 (WAR) 包。
注释
(可选)可以通过部署到本地 JBoss EAP 环境来测试包。
将 Jakarta EE 应用部署到 JBoss EAP
创建 Maven 项目后,可以使用 deploy
Azure 应用服务的 Maven 插件中的命令将应用程序部署到 JBoss EAP。 此命令基于前面的插件设置创建 Azure 资源组和 JBoss EAP 实例。 此命令执行从创建实例到部署 Java Web 应用程序的所有作。
所有 Azure Maven 插件共享一组常见的配置。 有关配置的完整列表,请参阅插件参考文档。 有关详细信息,请参阅 通用配置。 有关特定于应用服务的配置的详细信息,请参阅 Azure Web 应用:配置详细信息。
使用数据源和 JNDI 配置数据库连接
应用程序需要绑定到数据源。 在下一单元中,将应用程序配置为使用在上一单元中创建的 MySQL 数据库。 若要从 JBoss EAP 连接到数据库,需要配置一个 DataSource
对象,使应用程序能够连接到数据库。
将 DataSource
配置为使用以下设置连接到之前创建的 Azure Database for 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 命名和目录接口 (JNDI) 名称 java:jboss/datasources/JPAWorldDataSource
。 JNDI 在多个环境中非常有用,无需更改代码即可更改为其他数据库。
访问应用程序
在 JBoss EAP 中配置 MySQL 数据源连接后,可以使用 Web 浏览器或 curl
命令访问 Jakarta EE 应用程序。
在下一单元中,你将使用此处概述的过程部署示例应用。