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ê irá executar estas etapas na próxima unidade.
Criar um aplicativo Jakarta EE
Neste módulo, você usa um aplicativo Jakarta EE de exemplo que usa as seguintes tecnologias:
- Jacarta 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 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 onde o contêiner da Web é implantado. |
appName |
O nome da instância da aplicação para o contentor web. |
pricingTier |
A seleção de máquina virtual a utilizar. |
region |
A região para a qual implantar. Neste módulo, você usa o mesmo local que o local de instalação do MySQL. |
runtime, OS |
O sistema operacional a ser usado. Neste módulo, você usa Linux. |
runtime, javaVersion |
A versão da máquina virtual Java para o contêiner da Web. Neste módulo tu usas Java 17. |
runtime, webContainer |
O contêiner da Web. Neste módulo, você usa Red Hat JBoss EAP 8. |
Construa o pacote WAR
Você pode usar o comando ./mvnw package para criar um pacote WAR (Web Application Archive).
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 seu artefato Maven, você pode usar o deploy comando no plug-in Maven para o Serviço de Aplicativo do Azure para implantar o aplicativo no JBoss EAP. Este 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 implementação da aplicação 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 Configuração comum. Para obter mais informações sobre configurações específicas do Serviço de Aplicativo, consulte Azure Web App: Detalhes de configuração.
Configurar uma conexão de banco de dados usando uma fonte de dados e 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 que você criou na unidade anterior. Para se conectar ao banco de dados a partir 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 JNDI (Java Naming and Directory Interface) de java:jboss/datasources/JPAWorldDataSource para a fonte de dados. O JNDI é útil em vários ambientes para mudar para um banco de dados diferente sem alterações de código.
Aceda à aplicação
Depois de configurar a conexão da fonte de dados MySQL no JBoss EAP, você pode acessar o aplicativo Jakarta EE usando um navegador da Web ou o curl comando.
Na próxima unidade, você implanta o aplicativo de exemplo usando o procedimento descrito aqui.