Implantar um aplicativo Java EE (Jakarta EE) na JBoss EAP no Serviço de Aplicativo do Azure
As etapas nesta unidade ilustram como implantar seu aplicativo Java EE para a 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 um aplicativo Java EE (Jakarta EE)
Neste módulo, você usará um aplicativo Java EE de amostra preparado antecipadamente e que usa as seguintes tecnologias:
- Java EE 8 (Jakarta EE 8)
- JAX-RS 2.1
- JSON-B 1.0
- CDI 2.0
- JPA 2.2
Dica
O procedimento de implantação apresentado aqui é semelhante para a maioria dos aplicativos Web Java EE (Jakarta EE).
Configurar o projeto de aplicativo para implantação no Azure usando o Maven
A Microsoft fornece o Plug-in do 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 facilmente as seguintes configurações para a instância do Serviço de Aplicativo:
| Itens | Descrição |
|---|---|
subscriptionID |
Assinatura do Azure para implantação |
resourceGroup |
O nome do grupo de recursos em que o contêiner da Web é implantado |
appName |
Nome da instância do aplicativo para o contêiner da Web |
pricingTier |
Seleção de máquinas virtuais a serem executadas |
region |
Região a ser implantada (mesma localização que a 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 da JBoss EAP. Selecione Java 8 para a versão do Java e Jbosseap 7.4 para o contêiner da Web do runtime.
Criar o pacote WAR
Você pode usar o comando ./mvnw package para criar um pacote WAR (arquivos de aplicativo Web).
Observação
Opcionalmente, você pode testar o pacote implantando em um ambiente local da JBoss EAP.
Implantar o aplicativo Java EE na JBoss EAP
Depois de criar o artefato do Maven, você poderá executar o comando deploy no plug-in do Maven para o Serviço de Aplicativo do Azure a fim de implantar o aplicativo na JBoss EAP.
O comando deploy cria um grupo de recursos do Azure e uma instância da JBoss EAP com base nas configurações de plug-in acima. Esse comando faz tudo, desde a criação de instâncias até a implantação do aplicativo Web Java.
Para obter a lista completa de configurações, veja a documentação de referência do plug-in. Todos os Plug-ins do Azure para Maven compartilham um conjunto comum de configurações. Para ver essas configurações, confira Configurações comuns. Para conhecer as configurações específicas do Serviço de Aplicativo, veja Aplicativo Web do Azure: detalhes da configuração.
Configurar uma conexão de banco de dados usando uma fonte de dados e uma JNDI
Seu aplicativo precisará de uma associação a uma fonte de dados. Vamos configurá-lo para usar o banco de dados MySQL que criamos nas unidades anteriores.
Para se conectar ao banco de dados da 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 | value |
|---|---|
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 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 mudar 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 do MySQL na 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.