Cómo instalar WildFly con Nginx como proxy inverso en Debian 10

WildFly es un entorno de ejecución de aplicaciones gratuito, de código abierto y multiplataforma escrito en Java y desarrollado por Red Hat que te permite desarrollar grandes aplicaciones desde un solo IDE. Es ligero, rápido, flexible y basado en subsistemas plugables. Se ejecuta en sistemas operativos Windows y Linux y tiene como objetivo proporcionar a los usuarios un entorno de ejecución Java rápido y estable. Wildfly viene con un rico conjunto de características que incluyen, ejecución rápida y personalizable, escalabilidad, configuración y gestión unificadas, carga concurrente, enlace rápido, gestión de dominios y muchas más.

En este tutorial, te mostraremos los pasos para instalar Wildfly con Nginx como proxy inverso en Debian 10.

Requisitos

• Un servidor que ejecute Debian 10.
• Una contraseña de root configurada en tu servidor.

Comenzando

Antes de comenzar, necesitarás actualizar tu sistema con la última versión. Puedes hacer esto ejecutando el siguiente comando:

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

Una vez que tu servidor esté actualizado, reinicia tu servidor para aplicar los cambios.

Instalar Java

WildFly requiere que la versión 8 de Java esté instalada en tu servidor. Por defecto, Java 8 no está disponible en el repositorio predeterminado de Debian 10. Así que necesitarás descargar Java 8 desde su sitio web oficial.

Después de descargar Java 8, extrae la fuente de Java en el directorio /usr/lib/jvm con el siguiente comando:

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

A continuación, ejecuta el siguiente comando para cambiar la versión predeterminada de Java:

update-alternatives --config java

Selecciona la versión 8 de Java y presiona Enter. Deberías ver la siguiente salida:

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

A continuación, verifica la versión de Java usando el siguiente comando:

java -version

Deberías obtener la siguiente salida:

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

Primero, necesitarás crear un usuario y un grupo para Wildfly. Puedes crearlo con el siguiente comando:

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

A continuación, descarga la última versión de Wildfly con el siguiente comando:

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

Una vez que se complete la descarga, extrae el archivo descargado con el siguiente comando:

unzip wildfly-17.0.1.Final.zip

A continuación, copia el directorio extraído a /opt/ con el siguiente comando:

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

A continuación, cambia la propiedad del directorio wildfly al usuario wildfly como se muestra a continuación:

chown -RH wildfly:wildfly /opt/wildfly

Una vez que hayas terminado, puedes proceder al siguiente paso.

Configurar Wildfly

A continuación, necesitarás copiar los archivos necesarios para configurar WildFly.

Primero, copia el archivo de configuración de WildFly al directorio /etc/wildfly:

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

A continuación, copia el archivo launch.sh al directorio /opt/wildfly/bin/ con el siguiente comando:

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

A continuación, otorga permisos de ejecución al archivo launch.sh:

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

A continuación, copia el archivo de unidad systemd de Wildfly al directorio /etc/systemd/system/:

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

A continuación, recarga el daemon de systemd con el siguiente comando:

systemctl daemon-reload

A continuación, inicia el servicio WildFly y habilítalo para que se inicie al arrancar con el siguiente comando:

systemctl start wildfly  
systemctl enable wildfly

Ahora puedes verificar el estado del servicio Wildfly con el siguiente comando:

systemctl status wildfly

Deberías obtener la siguiente salida:

? 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 la autenticación de WildFly

A continuación, necesitarás crear un usuario administrador para Wildfly para acceder a la consola de administración de WildFly. Puedes crearlo con el siguiente comando:

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

Deberías ver la siguiente salida:

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

Escribe a y presiona Enter para crear un usuario de gestión. Durante el proceso de creación del usuario, necesitarás proporcionar el nombre de usuario, la contraseña y el nombre del grupo como se muestra a continuación:

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 

Una vez que hayas terminado, puedes proceder al siguiente paso.

Configurar WildFly para ser accesible desde un sistema remoto

Por defecto, Wildfly es accesible solo desde el sistema local. Así que necesitarás configurarlo para acceder desde el sistema remoto. Puedes hacerlo editando el archivo /etc/wildfly/wildfly.conf:

nano /etc/wildfly/wildfly.conf

Agrega la siguiente línea al final del archivo:

WILDFLY_CONSOLE_BIND=0.0.0.0

Guarda y cierra el archivo cuando hayas terminado. Luego, abre el archivo /opt/wildfly/bin/launch.sh como se muestra a continuación:

nano /opt/wildfly/bin/launch.sh

Cambia el archivo como se muestra a continuación:

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

Guarda y cierra el archivo. Luego, abre el archivo /etc/systemd/system/wildfly.service.

nano /etc/systemd/system/wildfly.service

Cambia el archivo como se muestra a continuación:

[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

Guarda el archivo. Luego, crea el directorio /var/run/wildfly y establece los permisos correctos

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

Finalmente, recarga el daemon de systemd y reinicia el servicio Wildfly para aplicar los cambios:

systemctl daemon-reload  
systemctl restart wildfly

Una vez que hayas terminado, puedes proceder al siguiente paso.

Acceder a Wildfly

Wildfly ahora está instalado y configurado para ser accesible desde el sistema remoto. Por defecto, la consola de administración de Wildfly está escuchando en el puerto 9990. Puedes acceder a ella visitando la URL http://192.168.0.4:9990. Serás redirigido a la siguiente página:

Ahora, proporciona tu nombre de usuario y contraseña de administrador, y haz clic en el botón Iniciar sesión. Deberías ver la consola de administración de Wildfly en la siguiente pantalla:

También puedes acceder a la aplicación Wildfly visitando la URL http://192.168.0.4:8080. Deberías ver la siguiente página:

Configurar Nginx como proxy inverso para Wildfly

A continuación, necesitarás configurar Nginx como un proxy inverso para redirigir las solicitudes que llegan al puerto 80 al 8080.

Primero, instala Nginx con el siguiente comando:

apt-get install nginx -y

Una vez que Nginx se haya instalado, crea un nuevo archivo de host virtual para Nginx con el siguiente comando:

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

Agrega las siguientes líneas:

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/;
  }
}

Guarda y cierra el archivo cuando hayas terminado. Luego, verifica Nginx en busca de errores de sintaxis con el siguiente comando:

ginx -t

Deberías obtener la siguiente salida:

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

A continuación, habilita el host virtual de Nginx y reinicia Nginx con el siguiente comando:

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

Ahora puedes acceder a la aplicación Wildfly sin especificar el puerto 8080.

Eso es todo. Has instalado y configurado con éxito Wildfly con Nginx como proxy inverso en Debian 10. No dudes en preguntarme si tienes alguna pregunta.