Como Instalar WildFly com Nginx como um Proxy Reverso no Debian 10

WildFly é um runtime de aplicação gratuito, de código aberto e multiplataforma escrito em Java e desenvolvido pela Red Hat que permite desenvolver ótimas aplicações a partir de um único IDE. É leve, rápido, flexível e baseado em subsistemas plugáveis. Ele roda em sistemas operacionais Windows e Linux e tem como objetivo fornecer aos usuários um ambiente de runtime Java rápido e estável. O WildFly vem com um rico conjunto de recursos, incluindo, Runtime Rápido e Personalizável, Escalabilidade, Configuração e Gerenciamento Unificados, Carregamento Concorrente, Ligação Rápida, Gerenciamento de Domínio e muito mais.

Neste tutorial, vamos mostrar os passos para instalar o WildFly com o Nginx como um proxy reverso no Debian 10.

Requisitos

• Um servidor rodando Debian 10.
• Uma senha de root configurada para o seu servidor.

Começando

Antes de começar, você precisará atualizar seu sistema com a versão mais recente. Você pode fazer isso executando o seguinte comando:

apt-get update -y  
apt-get upgrade -y

Uma vez que seu servidor esteja atualizado, reinicie seu servidor para aplicar as mudanças.

Instalar Java

O WildFly requer que a versão 8 do Java esteja instalada em seu servidor. Por padrão, o Java 8 não está disponível no repositório padrão do Debian 10. Portanto, você precisará baixar o Java 8 do site oficial.

Após baixar o Java 8, extraia a fonte do Java para o diretório /usr/lib/jvm com o seguinte comando:

mkdir /usr/lib/jvm/  
tar -zxvf jdk-8u221-linux-x64.tar.gz -C /usr/lib/jvm/

Em seguida, execute o seguinte comando para mudar a versão padrão do Java:

update-alternatives --config java

Selecione a versão 8 do Java e pressione Enter. Você deve ver a seguinte saída:

There are 2 choices for the alternative java (providing /usr/bin/java).

  Selection    Path                                         Priority   Status
------------------------------------------------------------
* 0            /usr/lib/jvm/java-11-openjdk-amd64/bin/java   1111      auto mode
  1            /usr/lib/jvm/java-11-openjdk-amd64/bin/java   1111      manual mode
  2            /usr/lib/jvm/jdk1.8.0_221/bin/java            1         manual mode

Press  to keep the current choice[*], or type selection number: 2
update-alternatives: using /usr/lib/jvm/jdk1.8.0_221/bin/java to provide /usr/bin/java (java) in manual mode

Em seguida, verifique a versão do Java usando o seguinte comando:

java -version

Você deve obter a seguinte saída:

java version "1.8.0_221"
Java(TM) SE Runtime Environment (build 1.8.0_221-b11)
Java HotSpot(TM) 64-Bit Server VM (build 25.221-b11, mixed mode)

Instalar WildFly

Primeiro, você precisará criar um usuário e grupo para o WildFly. Você pode criá-lo com o seguinte comando:

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

Em seguida, baixe a versão mais recente do WildFly com o seguinte comando:

wget https://download.jboss.org/wildfly/17.0.1.Final/wildfly-17.0.1.Final.zip

Uma vez que o download esteja completo, extraia o arquivo baixado com o seguinte comando:

unzip wildfly-17.0.1.Final.zip

Em seguida, copie o diretório extraído para /opt/ com o seguinte comando:

cp -r wildfly-17.0.1.Final /opt/wildfly

Em seguida, mude a propriedade do diretório wildfly para o usuário wildfly, conforme mostrado abaixo:

chown -RH wildfly:wildfly /opt/wildfly

Uma vez que você tenha terminado, pode prosseguir para o próximo passo.

Configurar WildFly

Em seguida, você precisará copiar os arquivos necessários para configurar o WildFly.

Primeiro, copie o arquivo de configuração do WildFly para o diretório /etc/wildfly:

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

Em seguida, copie o arquivo launch.sh para o diretório /opt/wildfly/bin/ com o seguinte comando:

cp /opt/wildfly/docs/contrib/scripts/systemd/launch.sh /opt/wildfly/bin/

Em seguida, dê permissão de execução ao arquivo launch.sh:

sh -c 'chmod +x /opt/wildfly/bin/*.sh'

Em seguida, copie o arquivo de unidade systemd do WildFly para o diretório /etc/systemd/system/:

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

Em seguida, recarregue o daemon systemd com o seguinte comando:

systemctl daemon-reload

Em seguida, inicie o serviço WildFly e habilite-o para iniciar na inicialização com o seguinte comando:

systemctl start wildfly  
systemctl enable wildfly

Agora você pode verificar o status do serviço WildFly com o seguinte comando:

systemctl status wildfly

Você deve obter a seguinte saída:

? wildfly.service - The WildFly Application Server
   Loaded: loaded (/etc/systemd/system/wildfly.service; disabled; vendor preset: enabled)
   Active: active (running) since Tue 2019-09-10 00:19:27 EDT; 1s ago
 Main PID: 1142 (launch.sh)
    Tasks: 7 (limit: 1138)
   Memory: 24.7M
   CGroup: /system.slice/wildfly.service
           ??1142 /bin/bash /opt/wildfly/bin/launch.sh standalone standalone.xml 0.0.0.0
           ??1143 /bin/sh /opt/wildfly/bin/standalone.sh -c standalone.xml -b 0.0.0.0
           ??1200 java -D[Standalone] -server -Xms64m -Xmx512m -XX:MetaspaceSize=96M -XX:MaxMetaspaceSize=256m -Djava.net.preferIPv4Stack=true -

Sep 10 00:19:27 debian systemd[1]: Started The WildFly Application Server.

Configurar Autenticação do WildFly

Em seguida, você precisará criar um usuário administrador para o WildFly acessar o console de administração do WildFly. Você pode criá-lo com o seguinte comando:

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

Você deve ver a seguinte saída:

What type of user do you wish to add? 
 a) Management User (mgmt-users.properties) 
 b) Application User (application-users.properties)
(a): a

Digite a e pressione Enter para criar um usuário de gerenciamento. Durante o processo de criação do usuário, você precisará fornecer nome de usuário, senha e nome do grupo, conforme mostrado abaixo:

Enter the details of the new user to add.
Using realm 'ManagementRealm' as discovered from the existing property files.
Username : wildflyadmin
Password recommendations are listed below. To modify these restrictions edit the add-user.properties configuration file.
 - The password should be different from the username
 - The password should not be one of the following restricted values {root, admin, administrator}
 - The password should contain at least 8 characters, 1 alphabetic character(s), 1 digit(s), 1 non-alphanumeric symbol(s)
Password : 
Re-enter Password : 
What groups do you want this user to belong to? (Please enter a comma separated list, or leave blank for none)[  ]: 
About to add user 'wildflyadmin' for realm 'ManagementRealm'
Is this correct yes/no? yes
Added user 'wildflyadmin' to file '/opt/wildfly/standalone/configuration/mgmt-users.properties'
Added user 'wildflyadmin' to file '/opt/wildfly/domain/configuration/mgmt-users.properties'
Added user 'wildflyadmin' with groups  to file '/opt/wildfly/standalone/configuration/mgmt-groups.properties'
Added user 'wildflyadmin' with groups  to file '/opt/wildfly/domain/configuration/mgmt-groups.properties'
Is this new user going to be used for one AS process to connect to another AS process? 
e.g. for a slave host controller connecting to the master or for a Remoting connection for server to server EJB calls.
yes/no? yes
To represent the user add the following to the server-identities definition 

Uma vez que você tenha feito isso, pode prosseguir para o próximo passo.

Configurar WildFly para Acessível de Sistemas Remotos

Por padrão, o WildFly é acessível apenas a partir do sistema local. Portanto, você precisará configurá-lo para acesso a partir do sistema remoto. Você pode fazer isso editando o arquivo /etc/wildfly/wildfly.conf:

nano /etc/wildfly/wildfly.conf

Adicione a seguinte linha ao final do arquivo:

WILDFLY_CONSOLE_BIND=0.0.0.0

Salve e feche o arquivo quando terminar. Em seguida, abra o arquivo /opt/wildfly/bin/launch.sh conforme mostrado abaixo:

nano /opt/wildfly/bin/launch.sh

Altere o arquivo conforme mostrado abaixo:

if [ "x$WILDFLY_HOME" = "x" ]; then
    WILDFLY_HOME="/opt/wildfly"
fi

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. Em seguida, abra o arquivo /etc/systemd/system/wildfly.service.

nano /etc/systemd/system/wildfly.service

Altere o arquivo conforme mostrado abaixo:

[Unit]
Description=The WildFly Application Server
After=syslog.target network.target
Before=httpd.service

[Service]
Environment=LAUNCH_JBOSS_IN_BACKGROUND=1
EnvironmentFile=-/etc/wildfly/wildfly.conf
User=wildfly
LimitNOFILE=102642
PIDFile=/var/run/wildfly/wildfly.pid
ExecStart=/opt/wildfly/bin/launch.sh $WILDFLY_MODE $WILDFLY_CONFIG $WILDFLY_BIND $WILDFLY_CONSOLE_BIND
StandardOutput=null

[Install]
WantedBy=multi-user.target

Salve o arquivo. Em seguida, crie o diretório /var/run/wildfly e defina as permissões corretas:

mkdir /var/run/wildfly/  
chown wildfly:wildfly /var/run/wildfly/

Finalmente, recarregue o daemon systemd e reinicie o serviço WildFly para aplicar as mudanças:

systemctl daemon-reload  
systemctl restart wildfly

Uma vez que você tenha feito isso, pode prosseguir para o próximo passo.

Acessar WildFly

O WildFly agora está instalado e configurado para acesso a partir do sistema remoto. Por padrão, o console de gerenciamento do WildFly está ouvindo na porta 9990. Você pode acessá-lo visitando a URL http://192.168.0.4:9990. Você será redirecionado para a seguinte página:

Agora, forneça seu nome de usuário e senha de administrador e clique no botão Entrar. Você deve ver o console de gerenciamento do WildFly na seguinte tela:

Você também pode acessar a aplicação WildFly visitando a URL http://192.168.0.4:8080. Você deve ver a seguinte página:

Configurar Nginx como um Proxy Reverso para WildFly

Em seguida, você precisará configurar o Nginx como um proxy reverso para encaminhar solicitações que chegam na porta 80 para a 8080.

Primeiro, instale o Nginx com o seguinte comando:

apt-get install nginx -y

Uma vez que o Nginx tenha sido instalado, crie um novo arquivo de host virtual para o Nginx com o seguinte comando:

nano /etc/nginx/sites-available/wildfly.conf

Adicione as seguintes linhas:

upstream wildfly {
  server 127.0.0.1:8080 weight=100 max_fails=5 fail_timeout=5;
}

server {
  listen          80;
  server_name     192.168.0.4;

  location / {
        proxy_set_header X-Forwarded-Host $host;
        proxy_set_header X-Forwarded-Server $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_pass http://wildfly/;
  }
}

Salve e feche o arquivo quando terminar. Em seguida, verifique o Nginx para qualquer erro de sintaxe com o seguinte comando:

ginx -t

Você deve obter a seguinte saída:

ginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

Em seguida, habilite o host virtual do Nginx e reinicie o Nginx com o seguinte comando:

ln -s /etc/nginx/sites-available/wildfly.conf /etc/nginx/sites-enabled/  
systemctl restart nginx

Agora você pode acessar a aplicação WildFly sem especificar a porta 8080.

É isso. Você instalou e configurou com sucesso o WildFly com o Nginx como um proxy reverso no Debian 10. Sinta-se à vontade para me perguntar se você tiver alguma dúvida.