Como Instalar o Servidor de Aplicação Java WildFly com Proxy Reverso Nginx no Ubuntu 20.04

WildFly ou anteriormente conhecido como JBoss AS é uma implementação leve do contêiner JEE (Java Enterprise Edition). Seu ambiente de execução de aplicativos flexível é escrito em Java e ajuda você a construir aplicativos fantásticos.

WildFly é um ambiente de execução de aplicativos multiplataforma que roda em sistemas operacionais Linux, macOS e Windows. Criado pela JBoss Inc, em 2006 foi adquirido pela RedHat e se tornou o WildFly.

Neste tutorial, mostraremos como instalar o WildFly na versão mais recente do Ubuntu 20.04. Instalaremos a versão mais recente do WildFly 20, habilitaremos o console de administração do WildFly, criaremos o usuário administrador do WildFly e configuraremos o Nginx como um proxy reverso para o WildFly.

Pré-requisitos

Para este guia, instalaremos o WildFly no mais recente Ubuntu Server 20.04 FocalFossa com 2 GB de RAM, 50 GB de espaço livre em disco e 2 CPUs.

O que faremos?

• Instalar Java OpenJDK 11
• Adicionar Novo Usuário e Baixar WildFly
• Configuração Básica do WildFly
• Habilitar Console de Administração do WildFly
• Configurar Usuário Administrador para WildFly
• Configurar Nginx como um Proxy Reverso para WildFly
• Testes

Passo 1 - Instalar Java OpenJDK

Primeiro, instalaremos o Java OpenJDK no servidor Ubuntu 20.04. E usaremos o Java OpenJDK 11 para nossa instalação do WildFly, que é a versão padrão dos pacotes Java no repositório do Ubuntu 20.04.

Atualize todos os repositórios de pacotes e instale o Java OpenJDK usando o comando apt abaixo.

sudo apt update  
sudo apt install default-jdk

Uma vez que toda a instalação esteja concluída, verifique a versão do Java usando o seguinte comando.

java -version

Abaixo está o resultado que você obterá.

openjdk version "11.0.7" 2020-04-14  
OpenJDK Runtime Environment (build 11.0.7+10-post-Ubuntu-3ubuntu1)  
OpenJDK 64-Bit Server VM (build 11.0.7+10-post-Ubuntu-3ubuntu1, mixed mode, sharing)

Como resultado, a instalação do Java OpenJDK no Ubuntu 20.04 foi concluída.

Passo 2 - Adicionar Novo Usuário e Baixar WildFly

Neste passo, criaremos um novo usuário e grupo do sistema ‘wildfly’ e baixaremos o código-fonte do wildfly para o diretório ‘/opt/wildfly’.

Agora crie um novo usuário e grupo chamado ‘wildfly’ usando os comandos abaixo.

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

Em seguida, vá para o diretório ‘/opt’ e baixe o código-fonte do wildfly usando o comando wget como abaixo.

cd /opt/  
wget -q wget https://download.jboss.org/wildfly/20.0.1.Final/wildfly-20.0.1.Final.tar.gz

O código-fonte do wildfly foi baixado.

Agora extraia o código-fonte do wildfly e renomeie o diretório extraído para ‘wildfly’.

tar -xf wildfly-20.0.1.Final.tar.gz  
mv wildfly-20.0.1.Final wildfly

Depois disso, altere a propriedade do diretório ‘wildfly’ para o usuário e grupo ‘wildfly’.

chown -RH wildfly:wildfly /opt/wildfly

Como resultado, o diretório de instalação do wildfly está localizado no diretório ‘/opt/wildfly’. O serviço wildfly será executado sob o novo usuário chamado ‘wildfly’ que acabamos de criar.

Passo 3 - Configuração Básica do WildFly

Após baixar o código-fonte do wildfly, configuraremos o wildfly no sistema Ubuntu.

Crie um novo diretório de configuração ‘/etc/wildfly’ e copie a configuração de exemplo ‘wildfly.conf’ para ele.

mkdir -p /etc/wildfly  
cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.conf /etc/wildfly/

Em seguida, copie o arquivo de serviço ‘wildfly.service’ para o diretório ‘/etc/systemd/system’.

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

Depois disso, copie o script de lançamento de exemplo do wildfly para o diretório ‘/opt/wildfly/bin’ e torne-o executável.

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

Agora recarregue o gerenciador systemd para aplicar o novo arquivo ‘wildfly.service’.

systemctl daemon-reload

Inicie o serviço wildfly e adicione-o ao boot do sistema.

systemctl start wildfly  
systemctl enable wildfly

O serviço wildfly está em execução no sistema Ubuntu com a configuração padrão.

Verifique o serviço wildfly usando o seguinte comando.

ss -plnt  
systemctl status wildfly

E você obterá o resultado abaixo.

Como pode ser visto, o wildfly está em execução como um serviço systemd na porta TCP padrão ‘8080’ no sistema Ubuntu.

Passo 4 - Habilitar Console de Administração do WildFly

Neste passo, configuraremos o wildfly para rodar no endereço IP local ‘127.0.0.1’ e habilitaremos seu console de administração. Editaremos a configuração do wildfly ‘wildfly.conf’, o script de início do wildfly ‘launch.sh’ e o arquivo de serviço do wildfly ‘wildfly.service’.

Edite a configuração do wildfly ‘/etc/wildfly/wildfly.conf’ usando o editor vim.

vim /etc/wildfly/wildfly.conf

Agora altere o valor de ‘WILDFLY_BIND’ para o endereço IP local ‘127.0.0.1’.

WILDFLY_BIND=127.0.0.1

Para habilitar o console de administração do wildfly, adicione a configuração ‘WILDFLY_CONSOLE_BIND’ abaixo.

WILDFLY_CONSOLE_BIND=127.0.0.1

Salve e feche.

Em seguida, edite o script de início do wildfly ‘/opt/wildfly/bin/launch.sh’ usando o editor vim.

vim /opt/wildfly/bin/launch.sh

Nas linhas ‘ domain.sh ‘ e ‘ standalone.sh ‘, adicione a opção adicional para habilitar o console de administração do wildfly como abaixo.

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.

Em seguida, edite o arquivo de serviço padrão do wildfly ‘/etc/systemd/system/wildfly.service’ usando o editor vim.

vim /etc/systemd/system/wildfly.service

Na linha ‘ ExecStart=/opt/wildfly/bin/launch.sh…. ‘, adicione a opção ‘ $WILDFLY_CONSOLE_BIND ‘ como abaixo.

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

Salve e feche.

Agora recarregue o gerenciador systemd e reinicie o serviço wildfly.

systemctl daemon-reload  
systemctl restart wildfly

O serviço wildfly está em execução com o console de administração habilitado, verifique usando o comando abaixo.

ss -plnt  
systemctl status wildfly

Abaixo está o resultado que você obterá.

Como resultado, o wildfly está em execução no endereço IP local ‘ 127.0.0.1 ‘ com a porta TCP padrão ‘ 8080 ‘, e o console de administração do wildfly habilitado na porta TCP ‘ 9990 ‘.

Passo 5 - Configurar Usuário Administrador WildFly

Neste passo, criaremos um novo usuário para gerenciar o wildfly usando o script ‘add-user.sh’ fornecido pelo wildfly.

Execute o script ‘add-user.sh’ do wildfly como abaixo.

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

Para o tipo de usuário, digite ‘ a ‘ para criar o usuário de gerenciamento (admin para gerenciar o wildfly).

Que tipo de usuário você deseja adicionar?   
a) Usuário de Gerenciamento (mgmt-users.properties)   
b) Usuário de Aplicação (application-users.properties)  
(a): a

Agora digite seu nome de usuário e senha, e certifique-se de usar uma senha segura.

Digite os detalhes do novo usuário a ser adicionado.  
Usando o reino 'ManagementRealm' conforme descoberto a partir dos arquivos de propriedades existentes.  
Nome de usuário : hakase  
As recomendações de senha estão listadas abaixo. Para modificar essas restrições, edite o arquivo de configuração add-user.properties.  
 - A senha deve ser diferente do nome de usuário  
 - A senha não deve ser um dos seguintes valores restritos {root, admin, administrator}  
 - A senha deve conter pelo menos 8 caracteres, 1 caractere(s) alfabético(s), 1 dígito(s), 1 símbolo(s) não alfanumérico(s)  
Senha :   
Repetir Senha :

Para o grupo do novo usuário, apenas pressione ‘ Enter ‘ para continuar.

Quais grupos você deseja que este usuário pertença? (Por favor, insira uma lista separada por vírgulas, ou deixe em branco para nenhum)[  ]:

Em seguida, digite ‘ yes ‘ para adicionar seu usuário ao ‘ ManagementRealm ‘ no wildfly.

Sobre adicionar o usuário 'hakase' para o reino 'ManagementRealm'  
Está correto sim/não? yes  
Usuário 'hakase' adicionado ao arquivo '/opt/wildfly/standalone/configuration/mgmt-users.properties'  
Usuário 'hakase' adicionado ao arquivo '/opt/wildfly/domain/configuration/mgmt-users.properties'  
Usuário 'hakase' com grupos  adicionado ao arquivo '/opt/wildfly/standalone/configuration/mgmt-groups.properties'  
Usuário 'hakase' com grupos  adicionado ao arquivo '/opt/wildfly/domain/configuration/mgmt-groups.properties'

Digite ‘ yes ‘ para habilitar seu usuário como um processo para gerenciar o controlador de host mestre-escravo do wildfly.

Este novo usuário será usado para um processo AS se conectar a outro processo AS?   
e.g. para um controlador de host escravo se conectando ao mestre ou para uma conexão Remota para chamadas EJB de servidor para servidor.   
yes/no? yes  
Para representar o usuário, adicione o seguinte à definição de identidades do servidor 

Como resultado, o usuário administrador e de gerenciamento para o wildfly foi criado.

Passo 6 - Configurar Nginx como um Proxy Reverso para WildFly

Neste passo, instalaremos e configuraremos o Nginx como um proxy reverso para o wildfly no sistema Ubuntu.

Instale os pacotes do Nginx usando o comando apt abaixo.

sudo apt install nginx -y

Uma vez que toda a instalação esteja concluída, vá para o diretório de configuração ‘/etc/nginx/‘.

cd /etc/nginx/

Crie um novo arquivo ‘proxy_headers.conf’ sob o diretório ‘/etc/nginx/conf.d’ usando o editor vim.

vim conf.d/proxy_headers.conf

Cole a seguinte configuração.

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 feche.

Em seguida, crie uma nova configuração de host virtual para o wildfly sob o diretório ‘/etc/nginx/sites-available’.

vim sites-available/wildfly

Altere o endereço IP pelo seu e cole a configuração nele.

server {  
  listen          80;  
  server_name     SERVER-IP;  
  
  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.

Em seguida, ative o host virtual do wildfly e verifique a configuração do Nginx.

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

Agora certifique-se de que não há erro, então reinicie o serviço Nginx.

systemctl restart nginx

Como resultado, a instalação e configuração do Nginx como um proxy reverso para o wildfly foi concluída.

Passo 7 - Testes

Abra seu navegador e digite o endereço IP do seu servidor na barra de endereços.

http://192.168.1.50/

Agora você verá a página de índice padrão do wildfly como abaixo.

Em seguida, acesse o console de administração do wildfly no caminho da URL ‘/console’ como abaixo.

http://192.168.1.50/console/

Faça login usando seu usuário e senha de administrador do wildfly.

Agora você verá o painel de administração do wildfly como abaixo.

Como resultado, a instalação do wildfly com proxy reverso Nginx no servidor Ubuntu 20.04 foi concluída com sucesso.