Implantar um aplicativo Java EE (Jakarta EE) no JBoss EAP no Serviço de Aplicativo do Azure
As etapas nesta unidade ilustram como implantar seu aplicativo Java EE no JBoss EAP no Serviço de Aplicativo do Azure e como se conectar ao banco de dados. Na verdade, você executará essas etapas na próxima unidade.
Criar uma aplicação Java EE (Jakarta EE)
Neste módulo, você usará um aplicativo Java EE de exemplo que é preparado com antecedência e usa as seguintes tecnologias:
- Java EE 8 (Jacarta EE 8)
- JAX-RS 2.1
- JSON-B 1.0
- CDI 2.0
- JPA 2,2
Dica
O procedimento de implementação introduzido aqui é semelhante para a maioria das aplicações web Java EE (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 facilmente definir as seguintes configurações para sua instância do Serviço de Aplicativo:
| Itens | Descrição |
|---|---|
subscriptionID |
Subscrição do Azure para implementação |
resourceGroup |
Nome do grupo de recursos onde o contêiner da Web está implantado |
appName |
Nome da instância do aplicativo para o contêiner da Web |
pricingTier |
Seleção de máquina virtual a ser executada |
region |
Região a ser implantada (mesmo local do local de instalação do MySQL) |
runtime
OS
|
Sistema operacional a ser executado (Linux) |
runtime
javaVersion
|
Versão da máquina virtual Java para o contêiner da Web (Java 8) |
runtime
webContainer
|
Contêiner da Web (JBoss EAP 7) |
Neste módulo, você implanta um aplicativo no ambiente JBoss EAP. Selecione Java 8 para a versão Java e Jbosseap 7.4 para o contentor web de execução.
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.
Implementar o aplicativo Java EE no JBoss EAP
Depois de criar seu artefato Maven, você pode executar o comando deploy no Plug-in Maven para o Serviço de Aplicativo do Azure para implantar o aplicativo no JBoss EAP.
O comando deploy 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.
Para obter a lista completa de configurações, consulte a documentação de referência do plugin. Todos os plug-ins do Azure Maven compartilham um conjunto comum de configurações. Para essas configurações, consulte Configurações comuns. Para 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 exigirá uma associação a uma fonte de dados. Vamos configurar o aplicativo para usar o banco de dados MySQL que criamos nas unidades anteriores.
Para se conectar ao banco de dados a partir do JBoss EAP, você precisa configurar um objeto DataSource. Quando você configura um objeto DataSource, um aplicativo pode se conectar ao banco de dados.
Você configurará DataSource para se conectar à instância do Banco de Dados do Azure para MySQL que você criou anteriormente com as seguintes informaçõ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_8_0 |
User Name |
${MYSQL_USER} |
Password |
${MYSQL_PASSWORD} |
Minimum Pool Size |
5 |
Maximum Pool Size |
20 |
JDBC Class Name |
com.mysql.cj.jdbc.Driver |
Usamos 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 Java EE usando um navegador da Web ou o comando curl.
Na próxima unidade, você implantará o aplicativo de exemplo usando o procedimento descrito aqui.