Implantar um aplicativo Java EE (Jakarta EE) no JBoss EAP no Serviço de Aplicativo do Azure

  • 4 minutos

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

Gorjeta

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:

Items Description
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 contêiner da Web de tempo de execução.

Construa o pacote WAR

Você pode usar o ./mvnw package comando para criar um pacote WAR (Web Application Archive).

Nota

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 deploy comando no plug-in Maven para o Serviço de Aplicativo do Azure para implantar o aplicativo no JBoss EAP.

O deploy 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.

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 Aplicativo Web do Azure: 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 DataSource objeto. Quando você configura um DataSource objeto, 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 criada 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) para a fonte de java:jboss/datasources/JPAWorldDataSource 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 curl comando.

Na próxima unidade, você implantará o aplicativo de exemplo usando o procedimento descrito aqui.