Guia de início rápido: implantar o JBoss EAP em uma máquina virtual (VM) do Azure

Artigo
05/29/2024

Este artigo mostra como implantar rapidamente o JBoss Enterprise Application Platform (EAP) em uma máquina virtual (VM) do Azure usando o portal do Azure.

Pré-requisitos

Se não tiver uma subscrição do Azure, crie uma conta gratuita do Azure antes de começar.
Instalar a CLI do Azure.
Instale uma implementação Java Standard Edition (SE) versão 8 ou posterior - por exemplo, compilação Microsoft do OpenJDK.
Instale o Maven, versão 3.5.0 ou superior.
Verifique se a identidade do Azure que você usa para entrar tem a função de Colaborador ou a função de Proprietário na assinatura atual. Para obter uma visão geral das funções do Azure, consulte O que é o controle de acesso baseado em função do Azure (Azure RBAC)?

Implantar o JBoss EAP Server na VM do Azure

As etapas nesta seção direcionam você para implantar o JBoss EAP Server em VMs do Azure.

As etapas a seguir mostram como encontrar a oferta JBoss EAP Server on Azure VM e preencher o painel Noções básicas :

Na barra de pesquisa na parte superior do portal do Azure, digite JBoss EAP. Nos resultados da pesquisa, na seção Marketplace, selecione JBoss EAP autônomo no RHEL VM. No menu pendente, certifique-se de que PAYG está selecionado.

Como alternativa, você pode ir diretamente para a oferta autônoma JBoss EAP no RHEL VM . Neste caso, o plano correto já está selecionado para você.

Em ambos os casos, essa oferta implanta o JBoss EAP fornecendo sua assinatura Red Hat no momento da implantação e a executa no Red Hat Enterprise Linux usando uma configuração de pagamento conforme o uso para a VM base.
Na página da oferta, selecione Criar.
No painel Noções básicas, verifique se o valor mostrado no campo Assinatura é o mesmo que tem as funções listadas na seção de pré-requisitos.
Você deve implantar a oferta em um grupo de recursos vazio. No campo Grupo de recursos, selecione Criar novo e preencha um valor para o grupo de recursos. Como os grupos de recursos devem ser exclusivos dentro de uma assinatura, escolha um nome exclusivo. Uma maneira fácil de ter nomes exclusivos é usar uma combinação de suas iniciais, a data de hoje e algum identificador. Por exemplo, ejb0823jbosseapvm.
Em Detalhes da instância, selecione a região para a implantação.
Deixe o tamanho padrão da VM para o tamanho da máquina virtual.
Deixe a opção padrão OpenJDK 8 para a versão JDK.
Deixe o valor padrão jbossuser para Username.
Deixe a opção padrão Senha para o tipo de autenticação.
Preencha a senha para Senha. Use o mesmo valor para Confirmar senha.
Em Configuração básica opcional, deixe a opção padrão Sim para Aceitar padrões para configuração opcional.
Role até a parte inferior do painel Noções básicas e observe os links úteis para Relatar problemas, obter ajuda e compartilhar comentários.
Selecione Next: JBoss EAP Settings.

As etapas a seguir mostram como preencher o painel Configurações do JBoss EAP e iniciar a implantação.

Deixe o valor padrão jbossadmin para o nome de usuário JBoss EAP Admin.
Preencha a senha do JBoss EAP para a senha do JBoss EAP. Use o mesmo valor para Confirmar senha. Anote o valor para uso posterior.
Deixe a opção padrão Não para Conectar a um Red Hat Satellite Server existente?.
Selecione Rever + criar. Verifique se a mensagem verde Validação aprovada aparece na parte superior. Se a mensagem não aparecer, corrija os problemas de validação e selecione Rever + criar novamente.
Selecione Criar.
Acompanhe o progresso da implantação na página Implantação está em andamento .

Dependendo das condições da rede e de outras atividades na região selecionada, a implantação pode levar até 6 minutos para ser concluída. Depois disso, você verá o texto Sua implantação foi concluída exibido na página de implantação.

Opcional: verificar a funcionalidade da implantação

Abra o grupo de recursos que criou no portal do Azure.
Selecione o recurso de VM chamado jbosieapVm.
No painel Visão geral, observe o endereço IP público atribuído à interface de rede.
Copie o endereço IP público.
Cole o endereço IP público em um navegador da Web conectado à Internet, acrescente :9990e pressione Enter. Você deve ver a conhecida tela de login do console de gerenciamento do Red Hat JBoss Enterprise Application Platform , conforme mostrado na captura de tela a seguir:
Preencha o valor do nome de usuário JBoss EAP Admin que é jbossadmin. Preencha o valor da senha do JBoss EAP que você especificou antes para Senha. Selecione Iniciar sessão.
Você deve ver a conhecida página de boas-vindas do console de gerenciamento do Red Hat JBoss Enterprise Application Platform , conforme mostrado na captura de tela a seguir.

Nota

Você também pode seguir o guia Conectar-se a ambientes de forma privada usando o host e jumpboxes do Azure Bastion e visitar o console de gerenciamento do Red Hat JBoss Enterprise Application Platform com a URL http://<private-ip-address-of-vm>:9990.

Opcional: implantar o aplicativo no servidor JBoss EAP

As etapas a seguir mostram como criar um aplicativo "Hello World" e, em seguida, implantá-lo no JBoss EAP:

Use as seguintes etapas para criar um projeto Maven:
1. Abra um terminal ou prompt de comando.
2. Navegue até o diretório onde você deseja criar seu projeto.
3. Execute o seguinte comando Maven para criar uma nova aplicação Web Java. Certifique-se de substituir <package-name> pelo nome do pacote desejado e <project-name> pelo nome do projeto.
```
mvn archetype:generate -DgroupId=<package-name> -DartifactId=<project-name> -DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false
```
Use as seguintes etapas para atualizar a estrutura do projeto:
1. Navegue até o diretório de projeto recém-criado - por exemplo, helloworld.
  
  O diretório do projeto tem a seguinte estrutura:
```
helloworld
├── src
│   └── main
│       ├── java
│       └── webapp
│           └── WEB-INF
│               └── web.xml
└── pom.xml
```

Use as seguintes etapas para adicionar uma classe de servlet:

No diretório src/main/java, crie um novo pacote - por exemplo, com.example.

Dentro deste pacote, crie uma nova classe Java chamada HelloWorldServlet.java com o seguinte conteúdo:

package com.example;

import java.io.IOException;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

@WebServlet("/hello")
public class HelloWorldServlet extends HttpServlet {
    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        response.getWriter().print("Hello World!");
    }
}

Use as seguintes etapas para atualizar o arquivo pom.xml :

Adicione dependências para APIs Java EE ao seu arquivo pom.xml para garantir que você tenha as bibliotecas necessárias para compilar o servlet:

<dependencies>
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>4.0.1</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

Construa o projeto executando mvn package no diretório raiz do seu projeto. Este comando gera um arquivo .war no diretório de destino .
Use as seguintes etapas para implantar o aplicativo no JBoss EAP:
1. Abra o console de administração do JBoss EAP em http://<public-ip-address-of-ipconfig1>:9990.
2. Implante o arquivo .war usando o console de administração carregando o arquivo na seção Implantações .
Após a implantação, acesse seu aplicativo "Hello World" navegando até o http://<public-ip-address-of-ipconfig1>:8080/helloworld/hello navegador da Web.

Clean up resources (Limpar recursos)

Para evitar cobranças do Azure, você deve limpar recursos desnecessários. Execute o seguinte comando para remover o grupo de recursos, VM, interface de rede, rede virtual e todos os recursos relacionados.

az group delete --name <resource-group-name> --yes --no-wait

Próximos passos

Saiba mais sobre como migrar aplicativos JBoss EAP para JBoss EAP em VMs do Azure seguindo estes links:

Migrar aplicativos JBoss EAP para JBoss EAP em VMs do Azure

Partilhar via