Cómo instalar el servidor de aplicaciones WildFly Java con Nginx como proxy inverso en Ubuntu 20.04

WildFly o anteriormente conocido como JBoss AS es una implementación ligera del contenedor JEE (Java Enterprise Edition). Su entorno de ejecución de aplicaciones flexible está escrito en Java y te ayuda a construir aplicaciones fantásticas.

WildFly es un entorno de ejecución de aplicaciones multiplataforma que funciona en sistemas operativos Linux, macOS y Windows. Creado por JBoss Inc, y en 2006 fue adquirido por RedHat y se convirtió en WildFly.

En este tutorial, te mostraremos cómo instalar WildFly en el último Ubuntu 20.04. Instalaremos la última versión de WildFly 20, habilitaremos la consola de administración para WildFly, crearemos el usuario administrador de WildFly y configuraremos Nginx como un proxy inverso para WildFly.

Requisitos previos

Para esta guía, instalaremos WildFly en el último Ubuntu Server 20.04 FocalFossa con 2 GB de RAM, 50 GB de espacio en disco libre y 2 CPUs.

¿Qué haremos?

• Instalar Java OpenJDK 11
• Agregar nuevo usuario y descargar WildFly
• Configuración básica de WildFly
• Habilitar la consola de administración de WildFly
• Configurar usuario administrador para WildFly
• Configurar Nginx como un proxy inverso para WildFly
• Pruebas

Paso 1 - Instalar Java OpenJDK

Primero, instalaremos Java OpenJDK en el servidor Ubuntu 20.04. Y estaremos usando Java OpenJDK 11 para nuestra instalación de WildFly, que es la versión predeterminada de los paquetes de Java en el repositorio de Ubuntu 20.04.

Actualiza todos los repositorios de paquetes e instala Java OpenJDK usando el comando apt a continuación.

sudo apt update  
sudo apt install default-jdk

Una vez que se complete toda la instalación, verifica la versión de Java usando el siguiente comando.

java -version

A continuación se muestra el resultado que obtendrás.

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, la instalación de Java OpenJDK en Ubuntu 20.04 se ha completado.

Paso 2 - Agregar nuevo usuario y descargar WildFly

En este paso, crearemos un nuevo usuario y grupo del sistema ‘wildfly’ y descargaremos el código fuente de wildfly en el directorio ‘/opt/wildfly’.

Ahora crea un nuevo usuario y grupo llamado ‘wildfly’ usando los comandos a continuación.

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

A continuación, ve al directorio ‘/opt’ y descarga el código fuente de wildfly usando el comando wget como se muestra a continuación.

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

El código fuente de wildfly ha sido descargado.

Ahora extrae el código fuente de wildfly y renombra el directorio extraído a ‘wildfly’.

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

Después de eso, cambia la propiedad del directorio ‘wildfly’ al usuario y grupo ‘wildfly’.

chown -RH wildfly:wildfly /opt/wildfly

Como resultado, el directorio de instalación de wildfly se encuentra en el directorio ‘/opt/wildfly’. El servicio de wildfly se ejecutará bajo el nuevo usuario llamado ‘wildfly’ que acabamos de crear.

Paso 3 - Configuración básica de WildFly

Después de descargar el código fuente de wildfly, configuraremos wildfly en el sistema Ubuntu.

Crea un nuevo directorio de configuración ‘/etc/wildfly’ y copia la configuración de muestra ‘wildfly.conf’ en él.

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

A continuación, copia el archivo de servicio ‘wildfly.service’ al directorio ‘/etc/systemd/system’.

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

Después de eso, copia el script de lanzamiento de muestra de wildfly al directorio ‘/opt/wildfly/bin’ y hazlo ejecutable.

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

Ahora recarga el administrador de systemd para aplicar el nuevo archivo ‘wildfly.service’.

systemctl daemon-reload

Inicia el servicio wildfly y agrégalo al arranque del sistema.

systemctl start wildfly  
systemctl enable wildfly

El servicio wildfly está en funcionamiento en el sistema Ubuntu con la configuración predeterminada.

Verifica el servicio wildfly usando el siguiente comando.

ss -plnt  
systemctl status wildfly

Y obtendrás el resultado a continuación.

Como se puede ver, wildfly se ejecuta como un servicio systemd en el puerto TCP predeterminado ‘8080’ en el sistema Ubuntu.

Paso 4 - Habilitar la consola de administración de WildFly

En este paso, configuraremos wildfly para que se ejecute en la dirección IP local ‘127.0.0.1’ y habilitaremos su consola de administración. Editaremos la configuración de wildfly ‘wildfly.conf’, el script de inicio de wildfly ‘launch.sh’ y el archivo de servicio de wildfly ‘wildfly.service’.

Edita la configuración de wildfly ‘/etc/wildfly/wildfly.conf’ usando el editor vim.

vim /etc/wildfly/wildfly.conf

Ahora cambia el valor de ‘WILDFLY_BIND’ por la dirección IP local ‘127.0.0.1’.

WILDFLY_BIND=127.0.0.1

Para habilitar la consola de administración de wildfly, agrega la configuración ‘WILDFLY_CONSOLE_BIND’ a continuación.

WILDFLY_CONSOLE_BIND=127.0.0.1

Guarda y cierra.

A continuación, edita el script de inicio para wildfly ‘/opt/wildfly/bin/launch.sh’ usando el editor vim.

vim /opt/wildfly/bin/launch.sh

En las líneas ‘ domain.sh ‘ y ‘ standalone.sh ‘, agrega una opción adicional para habilitar la consola de administración de wildfly como a continuación.

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.

A continuación, edita el archivo de servicio predeterminado para wildfly ‘/etc/systemd/system/wildfly.service’ usando el editor vim.

vim /etc/systemd/system/wildfly.service

En la línea ‘ ExecStart=/opt/wildfly/bin/launch.sh…. ‘, agrega la opción ‘ $WILDFLY_CONSOLE_BIND ‘ como a continuación.

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

Guarda y cierra.

Ahora recarga el administrador de systemd y reinicia el servicio wildfly.

systemctl daemon-reload  
systemctl restart wildfly

El servicio wildfly se está ejecutando con la consola de administración habilitada, verifica usando el comando a continuación.

ss -plnt  
systemctl status wildfly

A continuación se muestra el resultado que obtendrás.

Como resultado, wildfly se ejecuta en la dirección IP local ‘ 127.0.0.1 ‘ con el puerto TCP predeterminado ‘ 8080 ‘, y la consola de administración de wildfly habilitada en el puerto TCP ‘ 9990 ‘.

Paso 5 - Configurar usuario administrador WildFly

En este paso, crearemos un nuevo usuario para gestionar wildfly usando el script ‘add-user.sh’ proporcionado por wildfly.

Ejecuta el script ‘add-user.sh’ de wildfly como a continuación.

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

Para el tipo de usuario, escribe ‘ a ‘ para crear el usuario de gestión (administrador para gestionar wildfly).

¿Qué tipo de usuario deseas agregar?   
a) Usuario de gestión (mgmt-users.properties)   
b) Usuario de aplicación (application-users.properties)  
(a): a

Ahora escribe tu nombre de usuario y contraseña, y asegúrate de usar una contraseña segura.

Ingresa los detalles del nuevo usuario a agregar.  
Usando el reino 'ManagementRealm' como se descubrió en los archivos de propiedades existentes.  
Nombre de usuario : hakase  
Las recomendaciones de contraseña se enumeran a continuación. Para modificar estas restricciones, edita el archivo de configuración add-user.properties.  
 - La contraseña debe ser diferente del nombre de usuario  
 - La contraseña no debe ser uno de los siguientes valores restringidos {root, admin, administrator}  
 - La contraseña debe contener al menos 8 caracteres, 1 carácter alfabético, 1 dígito, 1 símbolo no alfanumérico  
Contraseña :   
Reingresar contraseña :

Para el grupo del nuevo usuario, simplemente presiona ‘ Enter ‘ para continuar.

¿Qué grupos deseas que pertenezca este usuario? (Por favor, ingresa una lista separada por comas, o deja en blanco para ninguno)[  ]:

A continuación, escribe ‘ yes ‘ para agregar tu usuario al ‘ ManagementRealm ‘ en wildfly.

A punto de agregar el usuario 'hakase' para el reino 'ManagementRealm'  
¿Es correcto? yes/no? yes  
Usuario 'hakase' agregado al archivo '/opt/wildfly/standalone/configuration/mgmt-users.properties'  
Usuario 'hakase' agregado al archivo '/opt/wildfly/domain/configuration/mgmt-users.properties'  
Usuario 'hakase' con grupos  agregado al archivo '/opt/wildfly/standalone/configuration/mgmt-groups.properties'  
Usuario 'hakase' con grupos  agregado al archivo '/opt/wildfly/domain/configuration/mgmt-groups.properties'

Escribe ‘ yes ‘ para habilitar tu usuario como un proceso para gestionar el controlador maestro-esclavo de wildfly.

¿Este nuevo usuario se utilizará para que un proceso AS se conecte a otro proceso AS?   
e.j. para un controlador de host esclavo conectándose al maestro o para una conexión remota para llamadas EJB de servidor a servidor.   
yes/no? yes  
Para representar al usuario, agrega lo siguiente a la definición de identidades del servidor 

Como resultado, se ha creado el usuario administrador y de gestión para wildfly.

Paso 6 - Configurar Nginx como un proxy inverso para WildFly

En este paso, instalaremos y configuraremos Nginx como un proxy inverso para wildfly en el sistema Ubuntu.

Instala los paquetes de Nginx usando el comando apt a continuación.

sudo apt install nginx -y

Una vez que se complete toda la instalación, ve al directorio de configuración ‘/etc/nginx/‘.

cd /etc/nginx/

Crea un nuevo archivo ‘proxy_headers.conf’ en el directorio ‘/etc/nginx/conf.d’ usando el editor vim.

vim conf.d/proxy_headers.conf

Pega la siguiente configuración.

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

Guarda y cierra.

A continuación, crea una nueva configuración de host virtual para wildfly en el directorio ‘/etc/nginx/sites-available’.

vim sites-available/wildfly

Cambia la dirección IP por la tuya y pega la configuración en él.

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

Guarda y cierra.

A continuación, activa el host virtual de wildfly y verifica la configuración de Nginx.

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

Ahora asegúrate de que no haya errores, luego reinicia el servicio de Nginx.

systemctl restart nginx

Como resultado, la instalación y configuración de Nginx como proxy inverso para wildfly se ha completado.

Paso 7 - Pruebas

Abre tu navegador web y escribe la dirección IP de tu servidor en la barra de direcciones.

http://192.168.1.50/

Ahora obtendrás la página de índice predeterminada de wildfly como a continuación.

A continuación, accede a la consola de administración de wildfly en la ruta URL ‘/console’ como a continuación.

http://192.168.1.50/console/

Inicia sesión usando tu usuario y contraseña de administrador de wildfly.

Ahora obtendrás el panel de control de administración de wildfly como a continuación.

Como resultado, la instalación de wildfly con Nginx como proxy inverso en el servidor Ubuntu 20.04 se ha completado con éxito.