Tutorial: Criar um aplicativo Web JBoss com o Serviço de Aplicativo do Azure no Linux e no MySQL

• Uma conta do Azure com uma subscrição ativa. Se não tiver uma conta do Azure, pode criar uma gratuitamente.
• Uma conta GitHub. Você também pode obter um gratuitamente.
• Conhecimento de Java com desenvolvimento JBoss.
• (Opcional) Para experimentar o GitHub Copilot, uma conta do GitHub Copilot. Está disponível uma versão experimental gratuita de 30 dias.

• Uma conta do Azure com uma subscrição ativa. Se não tiver uma conta do Azure, pode criar uma gratuitamente.
• CLI do Desenvolvedor do Azure instalada. Você pode seguir as etapas com o Azure Cloud Shell porque ele já tem a CLI do Desenvolvedor do Azure instalada.
• Conhecimento de Java com desenvolvimento JBoss.
• (Opcional) Para experimentar o GitHub Copilot, uma conta do GitHub Copilot. Está disponível uma versão experimental gratuita de 30 dias.

2. Criar Serviço de Aplicativo e MySQL

Primeiro, você cria os recursos do Azure. As etapas usadas neste tutorial criam um conjunto de recursos seguros por padrão que incluem o Serviço de Aplicativo e o Banco de Dados do Azure para MySQL. Para o processo de criação, você especifica:

• O Nome do aplicativo Web. Ele é usado como parte do nome DNS do seu aplicativo na forma de https://<app-name>-<hash>.<region>.azurewebsites.net.
• A região para executar o aplicativo fisicamente no mundo. Ele também é usado como parte do nome DNS do seu aplicativo.
• A pilha de tempo de execução para o aplicativo. É onde você seleciona a versão do Java a ser usada para seu aplicativo.
• O plano de hospedagem para o aplicativo. É a camada de preço que inclui o conjunto de recursos e a capacidade de dimensionamento para seu aplicativo.
• O Grupo de Recursos para o aplicativo. Um grupo de recursos permite agrupar (em um contêiner lógico) todos os recursos do Azure necessários para o aplicativo.

Entre no portal do Azure e siga estas etapas para criar seus recursos do Serviço de Aplicativo do Azure.

Tem problemas? Verifique a seção Solução de problemas.

3. Crie uma conexão sem senha

Nesta etapa, você gera uma conexão de serviço baseada em identidade gerenciada, que pode ser usada posteriormente para criar uma fonte de dados no servidor JBoss. Usando uma identidade gerenciada para se conectar ao banco de dados MySQL, seu código está protegido contra vazamento acidental de segredos.

Tem problemas? Verifique a seção Solução de problemas.

4. Confirme a fonte de dados JNDI

Se você adicionar uma configuração de aplicativo que contenha uma cadeia de conexão JDBC válida para Oracle, SQL Server, PostgreSQL ou MySQL, o Serviço de Aplicativo adicionará uma fonte de dados Java Naming and Directory Interface (JNDI) para ela no servidor JBoss. Nesta etapa, você usa a conexão SSH com o contêiner do aplicativo para verificar a fonte de dados JNDI. No processo, você aprende como acessar o shell SSH e executar a CLI do JBoss.

Tem problemas? Verifique a seção Solução de problemas.

5. Implantar código de exemplo

Nesta etapa, você configura a implantação do GitHub usando as Ações do GitHub. É apenas uma das muitas maneiras de implantar no Serviço de Aplicativo, mas também uma ótima maneira de ter integração contínua em seu processo de implantação. Por padrão, cada git push um no repositório do GitHub inicia a ação de compilação e implantação.

Como a convenção JBoss, se você quiser implantar no contexto raiz do JBoss, nomeie seu artefato construído como ROOT.war.

Tem problemas? Verifique a seção Solução de problemas.

6. Navegue até o aplicativo

Tem problemas? Verifique a seção Solução de problemas.

7. Logs de diagnóstico de fluxo

O Serviço de Aplicativo do Azure captura todas as mensagens enviadas para o console para ajudá-lo a diagnosticar problemas com seu aplicativo. O aplicativo de exemplo inclui instruções de log Log4j padrão para demonstrar essa capacidade, conforme mostrado no trecho a seguir:

private static final Logger logger = Logger.getLogger(MethodHandles.lookup().lookupClass().getName());

@PersistenceContext
private EntityManager entityManager;

public List<Task> getAllTasks() {
    logger.log(Level.INFO, "Finding all tasks. ");

    return this.entityManager.createNamedQuery("findAllTasks", Task.class).getResultList();
}

Saiba mais sobre como fazer logon em aplicativos Java na série em Habilitar o Azure Monitor OpenTelemetry para aplicativos .NET, Node.js, Python e Java.

Tem problemas? Verifique a seção Solução de problemas.

8. Limpar os recursos

Quando terminar, pode eliminar todos os recursos da sua subscrição do Azure eliminando o grupo de recursos.

2. Crie recursos do Azure e implante um aplicativo de exemplo

Nesta etapa, você cria os recursos do Azure e implanta um aplicativo de exemplo no Serviço de Aplicativo no Linux. As etapas usadas neste tutorial criam um conjunto de recursos seguros por padrão que incluem o Serviço de Aplicativo e o Banco de Dados do Azure para MySQL.

O contêiner de desenvolvimento já tem a CLI do Desenvolvedor do Azure (AZD).

1. A partir da raiz do repositório, execute azd init.

   azd init --template jboss-app-service-mysql-infra
   

2. Quando solicitado, dê as seguintes respostas:

   Pergunta	Resposta
   Continuar inicializando um aplicativo em '<your-directory>'?	Y
   O que você gostaria de fazer com esses arquivos?	Manter os meus ficheiros existentes inalterados
   Insira um novo nome de ambiente	Escreva um nome exclusivo. O modelo AZD usa esse nome como parte do nome DNS do seu aplicativo Web no Azure (<app-name>-<hash>.azurewebsites.net). São permitidos caracteres alfanuméricos e hífenes.

3. Entre no Azure executando o azd auth login comando e seguindo o prompt:

   azd auth login
   

4. Crie os recursos necessários do Azure e implante o código do aplicativo com o azd up comando. Siga o prompt para selecionar a assinatura desejada e o local para os recursos do Azure.

   azd up
   

   O azd up comando leva cerca de 15 minutos para ser concluído (o cache Redis leva mais tempo). Ele também compila e implanta o código do aplicativo, mas você modificará o código mais tarde para trabalhar com o Serviço de Aplicativo. Enquanto está em execução, o comando fornece mensagens sobre o processo de provisionamento e implantação, incluindo um link para a implantação no Azure. Quando terminar, o comando também exibirá um link para o aplicativo deploy.

   Este modelo AZD contém arquivos (azure.yaml e o diretório infra ) que geram uma arquitetura segura por padrão com os seguintes recursos do Azure:

   • Grupo de recursos: o contêiner para todos os recursos criados.
   • Plano do Serviço de Aplicativo: define os recursos de computação para o Serviço de Aplicativo. Um plano Linux na camada B1 é criado.
   • Serviço de Aplicativo: representa seu aplicativo e é executado no plano do Serviço de Aplicativo.
   • Rede virtual: integrada ao aplicativo Serviço de Aplicativo e isola o tráfego de rede back-end.
   • Banco de Dados do Azure para Servidor Flexível MySQL: Acessível apenas a partir da rede virtual. Um banco de dados é criado para você no servidor.
   • Cache do Azure para Redis: acessível apenas a partir da rede virtual.
   • Pontos de extremidade privados: pontos de extremidade de acesso para o cofre de chaves e o cache Redis na rede virtual.
   • Zonas DNS privadas: habilite a resolução DNS do cofre de chaves, do servidor de banco de dados e do cache Redis na rede virtual.
   • Espaço de trabalho do Log Analytics: atua como o contêiner de destino para seu aplicativo enviar seus logs, onde você também pode consultar os logs.
   • Cofre de chaves: usado para manter a mesma senha do banco de dados quando você reimplanta com o AZD.

   Quando o comando terminar de criar recursos e implantar o código do aplicativo pela primeira vez, o aplicativo de exemplo implantado ainda não funcionará porque você deve fazer pequenas alterações para que ele se conecte ao banco de dados no Azure.

Tem problemas? Verifique a seção Solução de problemas.

3. Verificar cadeias de conexão

O modelo AZD que você usa gerou as variáveis de conectividade para você já como configurações do aplicativo e as envia para o terminal para sua conveniência. As configurações do aplicativo são uma maneira de manter os segredos de conexão fora do seu repositório de código.

1. Na saída AZD, localize a configuração AZURE_MYSQL_CONNECTIONSTRINGdo aplicativo . Somente os nomes das configurações são exibidos. Eles se parecem com isso na saída AZD:

    App Service app has the following app settings:
            - AZURE_KEYVAULT_RESOURCEENDPOINT
            - AZURE_KEYVAULT_SCOPE
            - AZURE_MYSQL_CONNECTIONSTRING
            - AZURE_REDIS_CONNECTIONSTRING
    

   AZURE_MYSQL_CONNECTIONSTRING contém a cadeia de conexão com o banco de dados MySQL no Azure. Você precisa usá-lo em seu código mais tarde.

2. Para sua conveniência, o modelo AZD mostra o link direto para a página de configurações do aplicativo. Encontre o link e abra-o em uma nova guia do navegador.

   Se você adicionar uma configuração de aplicativo que contenha uma cadeia de conexão válida do Oracle, SQL Server, PostgreSQL ou MySQL, o Serviço de Aplicativo a adicionará como uma fonte de dados JNDI (Java Naming and Directory Interface) no arquivo context.xml do servidor JBoss.

Tem problemas? Verifique a seção Solução de problemas.

4. Confirme a fonte de dados JNDI

Nesta etapa, você usa a conexão SSH com o contêiner do aplicativo para verificar a fonte de dados JNDI no servidor JBoss. No processo, você aprende a acessar o shell SSH para o contêiner JBoss.

1. Na saída AZD, localize o URL da sessão SSH e navegue até ele no navegador. Tem esta aparência na saída:

    Open SSH session to App Service container at: https://<app-name>-<hash>.scm.azurewebsites.net/webssh/host
    

2. No terminal SSH, execute $JBOSS_HOME/bin/jboss-cli.sh --connect.

3. Na conexão JBoss CLI, execute ls subsystem=datasources/data-source. Você deve ver a fonte de dados gerada automaticamente chamada AZURE_MYSQL_CONNECTIONSTRING_DS.

4. Obtenha o nome JNDI da fonte de dados com /subsystem=datasources/data-source=AZURE_MYSQL_CONNECTIONSTRING_DS:read-attribute(name=jndi-name). Agora você tem um nome java:jboss/env/jdbc/AZURE_MYSQL_CONNECTIONSTRING_DSJNDI , que você pode usar no código do aplicativo mais tarde.

   

Tem problemas? Verifique a seção Solução de problemas.

5. Modifique o código de exemplo e reimplante

Tem problemas? Verifique a seção Solução de problemas.

6. Navegue até o aplicativo

1. Na saída AZD, localize a URL do seu aplicativo e navegue até ela no navegador. O URL tem esta aparência na saída AZD:

    Deploying services (azd deploy)
   
      (✓) Done: Deploying service web
      - Endpoint: https://<app-name>-<hash>.azurewebsites.net/
    

2. Adicione algumas tarefas à lista.

   

   Parabéns, você está executando um aplicativo Web no Serviço de Aplicativo do Azure, com conectividade segura ao Banco de Dados do Azure para MySQL.

Tem problemas? Verifique a seção Solução de problemas.

7. Logs de diagnóstico de fluxo

O Serviço de Aplicativo do Azure pode capturar logs do console para ajudá-lo a diagnosticar problemas com seu aplicativo. Por conveniência, o modelo AZD já habilitava o registro no sistema de arquivos local e está enviando os logs para um espaço de trabalho do Log Analytics.

O aplicativo de exemplo inclui instruções de log Log4j padrão para demonstrar essa capacidade, conforme mostrado no trecho a seguir:

private static final Logger logger = Logger.getLogger(MethodHandles.lookup().lookupClass().getName());

@PersistenceContext
private EntityManager entityManager;

public List<Task> getAllTasks() {
    logger.log(Level.INFO, "Finding all tasks. ");

    return this.entityManager.createNamedQuery("findAllTasks", Task.class).getResultList();
}

Na saída AZD, localize o link para transmitir logs do Serviço de Aplicativo e navegue até ele no navegador. O link tem esta aparência na saída AZD:

Stream App Service logs at: https://portal.azure.com/#@/resource/subscriptions/<subscription-guid>/resourceGroups/<group-name>/providers/Microsoft.Web/sites/<app-name>/logStream

Saiba mais sobre como fazer logon em aplicativos Java na série em Habilitar o Azure Monitor OpenTelemetry para aplicativos .NET, Node.js, Python e Java.

Tem problemas? Verifique a seção Solução de problemas.

8. Limpar os recursos

Para excluir todos os recursos do Azure no ambiente de implantação atual, execute azd down e siga os prompts.

azd down