Como Instalar o Servidor de Aplicações WildFly com Nginx como Proxy Reverso no Debian 12

WildFly, anteriormente JBoss, é um servidor de aplicações gratuito e de código aberto que ajuda você a construir e implantar aplicações web em Java. É escrito em Java e compatível com as especificações Java EE (Enterprise Edition). O WildFly foi criado pela JBoss, mas agora é desenvolvido pela RedHat. É um servidor de aplicações poderoso, pronto para produção, modular e leve, que fornece todas as ferramentas e recursos necessários para executar e implantar aplicações web em Java.

WildFly é um servidor de aplicações multiplataforma que fornece ferramentas para aplicações Java, como EJBs, JPA, Servlets, JAX-RS, Batch e segurança.

Neste guia, você aprenderá como instalar o WildFly ou o tempo de execução do JBoss em um servidor Debian 12 passo a passo. Você instalará o WildFly, habilitará o console de administração, criará um usuário administrador do WildFly e instalará e configurará o Nginx como um proxy reverso.

Pré-requisitos

Antes de prosseguir, reúna o seguinte:

• Um servidor Debian 12 com 4GB ou mais de memória.
• Um usuário não-root com privilégios de administrador sudo.

Instalando o Java OpenJDK

O WildFly é um tempo de execução Java flexível e leve para construção de aplicações. Nesta seção, você instalará e usará o Java OpenJDK 17 para instalar o WildFly em seu servidor Debian.

Primeiro, execute o seguinte comando para atualizar seu repositório Debian.

sudo apt update

Agora, instale o pacote Java OpenJDK executando o comando abaixo. Isso instalará o pacote default-jdk, que é equivalente à versão Java OpenJDK 17 LTS (Long Term Supports).

sudo apt install default-jdk

Digite y para prosseguir com a instalação.

Após instalar o Java, verifique a versão do Java usando o comando abaixo. Você deve ver que o Java OpenJDK 17 está instalado.

java -version

Instalando e Configurando o WildFly

Depois de instalar o Java OpenJDK, você pode agora iniciar a instalação do WildFly completando as seguintes tarefas:

• Adicionando o usuário e grupo wildfly
• Baixando o pacote binário do WildFly
• Configurando a instalação do WildFly
• Executando o WildFly como um serviço Systemd

Vamos começar.

Adicionando o Usuário e Grupo wildfly

Primeiro, você criará um novo usuário e grupo de sistema chamado wildfly que será usado para executar sua instalação do WildFly.

Execute o comando abaixo para adicionar um novo grupo e usuário chamado wildfly executando o seguinte comando. Com isso, você também configurará o diretório home padrão para usuários wildfly como /opt/wildfly, que será usado como o diretório de instalação do WildFly.

sudo groupadd -r wildfly  
sudo useradd -r -g wildfly -d /opt/wildfly -s /sbin/nologin wildfly

Baixando o Pacote Binário do WildFly

Após adicionar um usuário systemd, você baixará o pacote binário do WildFly via wget. Certifique-se de visitar a página de download do WildFly para obter a versão mais recente.

Antes disso, instale o unzip via o seguinte comando apt.

sudo apt install unzip -y

Depois disso, visite a página de download do WildFly e copie o link para a versão mais recente do WildFly. Baixe o pacote binário do WildFly via o comando wget como o seguinte. Neste exemplo, você instalará o WildFly 30.0.0.

wget https://github.com/wildfly/wildfly/releases/download/30.0.0.Final/wildfly-30.0.0.Final.zip

Em seguida, descompacte o pacote binário do WildFly e mova o diretório extraído para /opt/wildfly.

unzip wildfly-30.0.0.Final.zip  
sudo mv wildfly-30.0.0.Final /opt/wildfly

Por fim, execute o comando abaixo para mudar a propriedade do diretório /opt/wildfly para o usuário wildfly.

sudo chown -RH wildfly: /opt/wildfly

Configurando a Instalação do WildFly

Neste exemplo, você instalará o WildFly em uma única máquina no modo standalone. Portanto, toda configuração que você modificar aqui está relacionada às configurações standalone do WildFly.

Inicie o seguinte comando do editor nano para abrir o arquivo /opt/wildfly/bin/standalone.conf.

sudo nano /opt/wildfly/bin/standalone.conf

Altere o valor Xmx512m dentro da variável de ambiente JBOSS_JAVA_SIZING para aumentar o tamanho máximo da memória heap padrão do WildFly, da seguinte forma.

Certifique-se de ajustar o tamanho máximo da memória heap com seu servidor atual. O seguinte exemplo define o tamanho máximo da memória heap para 4GB.

  JBOSS_JAVA_SIZING="-Xms64m -Xmx4096m -XX:MetaspaceSize=96M -XX:MaxMetaspaceSize=256m"

Salve e saia do arquivo quando terminar.

Agora crie um novo diretório de configuração /etc/wildfly usando o comando abaixo.

sudo mkdir -p /etc/wildfly

Copie o arquivo de configuração do WildFly para /etc/wildfly/wildfly.conf e abra-o usando o seguinte comando do editor nano.

sudo cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.conf /etc/wildfly/  
sudo nano /etc/wildfly/wildfly.conf

Altere o WILDFLY_BIND padrão para 127.0.0.1 e adicione uma variável WILDFLY_CONSOLE_BIND para habilitar o console de administração do WildFly. Tanto o WildFly quanto o console de administração estarão rodando em localhost.

# O endereço para vincular  
WILDFLY_BIND=127.0.0.1  
  
# Habilitar Admin  
WILDFLY_CONSOLE_BIND=127.0.0.1

Quando terminar, salve e saia do arquivo.

Em seguida, copie o script de inicialização do WildFly para /opt/wildfly/bin/launch.sh e torne-o executável via o comando chmod abaixo.

sudo cp /opt/wildfly/docs/contrib/scripts/systemd/launch.sh /opt/wildfly/bin/  
sudo chmod +x /opt/wildfly/bin/*.sh

Abra o script de inicialização do WildFly /opt/wildfly/bin/launch.sh usando o seguinte comando do editor nano.

sudo nano /opt/wildfly/bin/launch.sh

Insira a nova opção de comando ‘-bmanagement $4‘ para habilitar o console de administração do WildFly assim:

if [[ "$1" == "domain" ]]; then  
    $WILDFLY_HOME/bin/domain.sh -c $2 -b $3 -bmanagement $4  
else  
    $WILDFLY_HOME/bin/standalone.sh -c $2 -b $3 -bmanagement $4  
fi

Salve e feche o arquivo quando terminar.

Por fim, execute o comando abaixo para mudar a propriedade do diretório de instalação do WildFly /opt/wildfly para o usuário wildfly.

sudo chown -RH wildfly: /opt/wildfly

Executando o WildFly como um Serviço Systemd

Após configurar o WildFly no modo standalone, você configurará um arquivo de serviço systemd para o WildFly. Isso permite que você execute o WildFly em segundo plano e gerencie o WildFly facilmente através da utilidade systemctl.

Copie o arquivo de serviço systemd do WildFly para /etc/systemd/system/wildfly.service e modifique-o usando o comando do editor nano abaixo.

sudo cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.service /etc/systemd/system/  
sudo nano /etc/systemd/system/wildfly.service

Dentro da opção ExecStart, adicione um novo parâmetro de início $WILDFLY_CONSOLE_BIND para habilitar o console de administração do WildFly.

ExecStart=/opt/wildfly/bin/launch.sh $WILDFLY_MODE $WILDFLY_CONFIG $WILDFLY_BIND $WILDFLY_CONSOLE_BIND

Quando terminar, salve o arquivo e saia do editor.

Em seguida, execute o comando systemctl abaixo para recarregar o gerenciador systemd.

sudo systemctl daemon-reload

Então inicie e habilite o serviço wildfly usando o comando abaixo.

sudo systemctl start wildfly  
sudo systemctl enable wildfly

Verifique o serviço wildfly para garantir que o serviço está em execução executando o seguinte comando.

sudo systemctl status wildfly

Se o serviço wildfly estiver em execução, a seguinte saída será exibida.

Você também pode verificar a lista de portas abertas em seu sistema executando o seguinte comando.

ss -antpl | grep -i java

Você deve ver várias portas 8080, 8443 e 9990 que o WildFly usa.

Adicionando Gerenciamento de Usuários no WildFly

Após instalar o WildFly, você criará um novo usuário administrador para o WildFly via o script /opt/wildfly/bin/add-user.sh.

Execute o script /opt/wildfly/bin/add-user.sh como o seguinte.

sh /opt/wildfly/bin/add-user.sh

Agora você será solicitado com o seguinte:

• Digite a para criar um novo usuário de gerenciamento do WildFly.
• Digite seu usuário administrador e senha, depois repita.
• Pressione ENTER quando solicitado pela configuração do grupo.
• Digite sim para adicionar seu usuário ao ManagementRealm.

Uma vez que o processo esteja concluído, você deve ver que seu novo usuário foi adicionado à configuração do WildFly.

Configurando o Nginx como um Proxy Reverso

Neste ponto, você concluiu a instalação do WildFly, habilitou o console de administração e criou o usuário administrador. O próximo passo é instalar o Nginx e configurá-lo como um proxy reverso para o WildFly.

Execute o comando apt abaixo para instalar o Nginx em seu servidor Debian. Digite y para prosseguir com a instalação.

sudo apt install nginx

Uma vez que o Nginx esteja instalado, você o configurará como um proxy reverso para o WildFly.

Crie uma nova configuração de cabeçalhos proxy do Nginx /etc/nginx/conf.d/proxy_headers.conf usando o comando do editor nano abaixo.

sudo nano /etc/nginx/conf.d/proxy_headers.conf

Insira a seguinte configuração no arquivo.

proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
add_header Front-End-Https on;
add_header Cache-Control no-cache;

Salve e saia do arquivo quando terminar.

Em seguida, inicie o seguinte comando do editor nano para criar uma nova configuração de bloco de servidor Nginx /etc/nginx/sites-available/wildfly.

sudo nano /etc/nginx/sites-available/wildfly

Insira a configuração abaixo para configurar o Nginx como um proxy reverso para sua instalação do WildFly. Certifique-se de alterar o domínio dentro da opção server_name, você pode usar um nome de domínio local.

server {  
    listen          80;  
    server_name     wildfly.howtoforge.local;  
  
    location / {  
        include conf.d/proxy_headers.conf;  
        proxy_pass http://127.0.0.1:8080;  
    }  
  
    location /management {  
        include conf.d/proxy_headers.conf;  
        proxy_pass http://127.0.0.1:9990/management;  
    }  
  
    location /console {  
        include conf.d/proxy_headers.conf;  
        proxy_pass http://127.0.0.1:9990/console;  
    }  
  
    location /logout {  
        include conf.d/proxy_headers.conf;  
        proxy_pass http://127.0.0.1:9990/logout;  
    }  
  
    location /error {  
        include conf.d/proxy_headers.conf;  
        proxy_pass http://127.0.0.1:9990;  
    }  
  
}

Salve e feche o arquivo quando terminar.

Agora execute o comando abaixo para ativar o arquivo de host virtual wildfly e verificar sua sintaxe do Nginx.

sudo ln -s /etc/nginx/sites-available/wildfly /etc/nginx/sites-enabled/  
sudo nginx -t

Se você tiver uma sintaxe adequada do Nginx, a saída “syntax is ok—test is successful“ será exibida.

Por fim, execute o comando abaixo para reiniciar o serviço Nginx e aplicar as alterações que você fez. Em seguida, verifique o serviço Nginx para garantir que o serviço está em execução.

sudo systemctl restart nginx  
sudo systemctl status nginx

Se o Nginx estiver em execução, você deve obter a saída active (running).

Acessando o WildFly via Cliente

Em sua máquina cliente, abra o arquivo hosts usando seu editor de texto. Para usuários do Windows, abra o arquivo C:\Windows\System32\drivers\etc\hosts como administrador, enquanto para usuários de Linux ou macOS, abra o arquivo /etc/hosts com privilégios sudo.

Insira a seguinte configuração e certifique-se de alterar o nome de domínio local e o endereço IP com suas informações.

192.168.5.15  wildfly.howtoforge.local

Salve e feche o arquivo quando terminar.

Inicie seu navegador da web e visite seu domínio local do WildFly (por exemplo: http:wildfly.howtoforge.local/). Se sua instalação for bem-sucedida, você deve ver a página de índice padrão do WildFly, que é a seguinte:

Agora clique no link Console de Administração para acessar o console de administração do WildFly. Isso abrirá uma nova aba e você será redirecionado para o console de administração do WildFly com o caminho da URL /console.

Digite seu usuário administrador e senha para o console de administração do WildFly e clique em Entrar.

Se você tiver o usuário e a senha corretos, deverá ver o console de administração do WildFly como o seguinte.

Em seguida, clique no menu Runtime e selecione seu servidor. Você deve ver a confirmação de que o WildFly está em funcionamento.

Por fim, selecione o menu Status e você deve ver o status detalhado de sua instalação do WildFly, incluindo a configuração de heap alterada para 4GB.

Conclusão

Em conclusão, você agora terminou a instalação do WildFly no Debian 12 passo a passo. Você instalou o WildFly, habilitou o console de administração e criou um usuário administrador do WildFly. Além disso, você também configurou o Nginx como um proxy reverso para o WildFly. A partir de agora, você pode implantar e executar suas aplicações JBoss usando o tempo de execução do WildFly.