Implantar um aplicativo Jakarta EE no JBoss EAP no Serviço de Aplicativo do Azure
Esta unidade descreve as etapas para implantar seu aplicativo Jakarta EE no Red Hat JBoss Enterprise Application Platform (JBoss EAP) no Serviço de Aplicativo do Azure. Ele também descreve como se conectar ao banco de dados. Você de fato executa essas etapas no próximo módulo.
Criar um aplicativo Jakarta EE
Neste módulo, você usará um aplicativo Jakarta EE de exemplo que usa as seguintes tecnologias:
- Jakarta EE 10
- JAX-RS 3.1
- JSON-B 3.0
- CDI 4.0
- JPA 3.1
Dica
O procedimento de implantação introduzido aqui é semelhante ao procedimento usado para a maioria dos aplicativos Web jakarta EE.
Configurar o projeto de aplicativo para implantação no Azure usando o Maven
A Microsoft fornece o plug-in maven para o Serviço de Aplicativo do Azure para implantar seus aplicativos Web Java no Serviço de Aplicativo do Azure. Usando esse plug-in do Maven, você pode definir as seguintes configurações para sua instância do Serviço de Aplicativo:
| Configurações | Descrição |
|---|---|
subscriptionID |
A assinatura do Azure para implantação. |
resourceGroup |
O nome do grupo de recursos em que o contêiner da Web é implantado. |
appName |
O nome da instância da aplicação para o contêiner web. |
pricingTier |
A seleção de máquinas virtuais a serem usadas. |
region |
A região na qual implantar. Neste módulo, você usará o mesmo local que o local de instalação do MySQL. |
runtime, OS |
O sistema operacional a ser usado. Neste módulo, você usará Linux. |
runtime, javaVersion |
A versão da máquina virtual Java para o contêiner da Web. Neste módulo você usa Java 17. |
runtime, webContainer |
O contêiner da Web. Neste módulo, você usará Red Hat JBoss EAP 8. |
Compilar o pacote WAR
Você pode usar o comando ./mvnw package para criar um pacote WAR (Arquivo de Aplicativo Web).
Observação
Opcionalmente, você pode testar o pacote implantando em um ambiente JBoss EAP local.
Implantar o aplicativo Jakarta EE no JBoss EAP
Depois de criar o artefato do Maven, você pode usar o deploy comando no Plug-in do Maven para o Serviço de Aplicativo do Azure para implantar o aplicativo no JBoss EAP. Esse comando cria um grupo de recursos do Azure e uma instância do JBoss EAP com base nas configurações de plug-in anteriores. Este comando faz tudo, desde a criação de instâncias até a implantação do aplicativo Web Java.
Todos os plug-ins do Azure Maven compartilham um conjunto comum de configurações. Para obter a lista completa de configurações, consulte a documentação de referência do plug-in. Para obter mais informações, consulte Common Configuration. Para obter mais informações sobre configurações específicas do Serviço de Aplicativo, consulte o Aplicativo Web do Azure: Detalhes de Configuração.
Configurar uma conexão de banco de dados usando uma fonte de dados e o JNDI
Seu aplicativo requer uma associação a uma fonte de dados. Na próxima unidade, você configura o aplicativo para usar o banco de dados MySQL criado na unidade anterior. Para se conectar ao banco de dados do JBoss EAP, você precisa configurar um DataSource objeto, que permite que um aplicativo se conecte ao banco de dados.
Você configura DataSource para se conectar à instância do Banco de Dados do Azure para MySQL que você criou anteriormente usando as seguintes configurações:
| Configuração da fonte de dados | valor |
|---|---|
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 |
Você usou um nome de JNDI (Java Naming and Directory Interface) de java:jboss/datasources/JPAWorldDataSource para a fonte de dados. O JNDI é útil em vários ambientes para alterar para um banco de dados diferente sem alterações de código.
Acessar o aplicativo
Depois de configurar a conexão de fonte de dados MySQL no JBoss EAP, você poderá acessar o aplicativo Jakarta EE usando um navegador da Web ou o curl comando.
Na próxima unidade, você implantará o aplicativo de exemplo usando o procedimento descrito aqui.