Come installare WildFly Java Application Server con Nginx su Ubuntu 22.04

Wildfly è un runtime per applicazioni semplice, leggero e flessibile utilizzato per costruire applicazioni Java. È scritto in Java e può funzionare su sistemi operativi Linux, macOS e Windows. È un server applicativo enterprise e completamente funzionale che fornisce tutte le funzionalità necessarie per eseguire un’applicazione web Java.

Caratteristiche

Gratuito e open-source
Modulare e leggero.
Risparmia risorse con una gestione efficiente.
Risparmia tempo con uno sviluppo più veloce.

Questo tutorial ti mostrerà come installare Wildfly con Nginx come proxy inverso su Ubuntu 22.04.

Requisiti

Un server che esegue Ubuntu 22.04.
Un nome di dominio valido puntato all’IP del tuo server.
Una password di root configurata sul tuo server.

Aggiorna il sistema

Per prima cosa, dovrai aggiornare tutti i pacchetti del tuo sistema alla versione aggiornata. Puoi aggiornare tutti eseguendo il seguente comando.

apt update -y  
apt upgrade -y

Una volta aggiornati tutti i pacchetti, puoi procedere al passaggio successivo.

Installa Java JDK

Wildfly è un’applicazione basata su Java. Quindi dovrai installare Java sul tuo server. Puoi installare Java JDK con il seguente comando.

apt install default-jdk -y

Una volta installato Java, puoi verificare la versione di Java utilizzando il seguente comando.

java --version

Dovresti vedere la versione di Java nel seguente output.

openjdk 11.0.17 2022-10-18
OpenJDK Runtime Environment (build 11.0.17+8-post-Ubuntu-1ubuntu222.04)
OpenJDK 64-Bit Server VM (build 11.0.17+8-post-Ubuntu-1ubuntu222.04, mixed mode, sharing)

Scarica e installa Wildfly

Prima di iniziare, dovrai creare un utente e un gruppo dedicati per eseguire Wildfly. Puoi crearli entrambi utilizzando il seguente comando.

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

Successivamente, scarica l’ultima versione di Wildfly utilizzando il seguente comando.

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

Una volta completato il download, estrai il file scaricato con il seguente comando.

unzip wildfly-26.1.3.Final.zip

Successivamente, sposta la directory Wildfly estratta nella directory /opt.

mv wildfly-26.1.3.Final /opt/wildfly

Successivamente, cambia la proprietà della directory Wildfly utilizzando il seguente comando.

chown -RH wildfly: /opt/wildfly

Una volta fatto, puoi procedere a configurare Wildfly.

Configura Wildfly

Per prima cosa, crea una directory di configurazione di Wildfly utilizzando il seguente comando.

mkdir -p /etc/wildfly

Successivamente, copia il file di configurazione di Wildfly nella directory /etc/wildfly.

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

Successivamente, copia il file di servizio di Wildfly nella directory systemd.

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

Successivamente, copia il file launch.sh di Wildfly nella directory /opt/wildfly/bin/.

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

Successivamente, imposta i permessi di esecuzione sul file di script.

chmod +x /opt/wildfly/bin/*.sh

Poi, ricarica il demone systemd per applicare le modifiche.

systemctl daemon-reload

Successivamente, avvia il servizio wildfly e aggiungilo all’avvio del sistema.

systemctl start wildfly  
systemctl enable wildfly

Ora puoi verificare lo stato di Wildfly utilizzando il seguente comando.

systemctl status wildfly

Otterrai il seguente output.

? wildfly.service - The WildFly Application Server
     Loaded: loaded (/etc/systemd/system/wildfly.service; disabled; vendor preset: enabled)
     Active: active (running) since Wed 2023-02-15 09:34:24 UTC; 4s ago
   Main PID: 20425 (launch.sh)
      Tasks: 61 (limit: 4579)
     Memory: 111.6M
        CPU: 6.919s
     CGroup: /system.slice/wildfly.service
             ??20425 /bin/bash /opt/wildfly/bin/launch.sh standalone standalone.xml 0.0.0.0
             ??20426 /bin/sh /opt/wildfly/bin/standalone.sh -c standalone.xml -b 0.0.0.0
             ??20534 java "-D[Standalone]" -server -Xms64m -Xmx512m -XX:MetaspaceSize=96M -XX:MaxMetaspaceSize=256m -Djava.net.preferIPv4Stac>

Feb 15 09:34:24 ubuntu2204 systemd[1]: Started The WildFly Application Server.

Per impostazione predefinita, Wildfly ascolta sulle porte 8080 e 9990. Puoi controllarle con il seguente comando.

ss -antpl | grep -i java

Dovresti vedere il seguente output.

LISTEN 0      4096         0.0.0.0:8443      0.0.0.0:*    users:(("java",pid=20534,fd=498))                                                                
LISTEN 0      50         127.0.0.1:9990      0.0.0.0:*    users:(("java",pid=20534,fd=497))                                                                
LISTEN 0      4096         0.0.0.0:8080      0.0.0.0:*    users:(("java",pid=20534,fd=495))

Configura la console di amministrazione di Wildfly

Per impostazione predefinita, la console di amministrazione di Wildfly è disabilitata. Quindi dovrai abilitarla per accedere a Wildfly dal browser web.

Per prima cosa, modifica il file di configurazione di Wildfly utilizzando il seguente comando.

nano /etc/wildfly/wildfly.conf

Cambia le seguenti righe.

WILDFLY_BIND=127.0.0.1
WILDFLY_CONSOLE_BIND=127.0.0.1

Salva e chiudi il file quando hai finito. Poi, modifica il file launch.sh con il seguente comando.

nano /opt/wildfly/bin/launch.sh

Modifica le seguenti righe:

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

Salva e chiudi il file, poi modifica il file di servizio di Wildfly.

nano /etc/systemd/system/wildfly.service

Modifica la seguente riga.

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

Salva e chiudi il file, poi ricarica il demone systemd per applicare le modifiche.

systemctl daemon-reload

Ora, riavvia il servizio Wildfly per implementare le modifiche.

systemctl restart wildfly

Aggiungi un utente amministrativo a Wildfly

Successivamente, dovrai aggiungere un utente admin per accedere alla console di amministrazione di Wildfly. Puoi aggiungerlo con il seguente comando.

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

Ti verrà chiesto il tipo di utente che desideri aggiungere:

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

Fornisci i dettagli del tuo nuovo utente come mostrato di seguito:

Using the realm 'ManagementRealm' as discovered from the existing property files.
Username : wadmin
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 :

Ti verrà chiesto a quale gruppo desideri che questo utente appartenga:

What groups do you want this user to belong to? (Please enter a comma separated list, or leave blank for none)[  ]:

Premi semplicemente il tasto invio. Dovresti vedere il seguente output.

About to add user 'wadmin' for realm 'ManagementRealm'
Is this correct yes/no? yes
Added user 'wadmin' to file '/opt/wildfly/standalone/configuration/mgmt-users.properties'
Added user 'wadmin' to file '/opt/wildfly/domain/configuration/mgmt-users.properties'
Added user 'wadmin' with groups  to file '/opt/wildfly/standalone/configuration/mgmt-groups.properties'
Added user 'wadmin' 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

Configura Nginx per Wildfly

A questo punto, Wildfly è installato e configurato per funzionare su localhost. Ora, dovrai configurare Nginx come proxy inverso per accedere all’interfaccia web di Wildfly.

Per prima cosa, installa il pacchetto Nginx utilizzando il seguente comando.

apt install nginx -y

Successivamente, crea un file di configurazione proxy_headers.

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

Aggiungi le seguenti configurazioni:

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

Salva e chiudi il file, poi crea un nuovo file di configurazione per il virtual host.

nano /etc/nginx/conf.d/wildfly.conf

Aggiungi le seguenti configurazioni.

server {
  listen          80;
  server_name     wildfly.example.com;

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

}

Salva il file, poi verifica la configurazione di Nginx per eventuali errori di sintassi.

ginx -t

Se tutto è a posto, otterrai il seguente output.

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

Infine, riavvia il servizio Nginx per implementare le modifiche.

systemctl restart nginx

Puoi verificare lo stato del servizio Nginx con il seguente comando.

systemctl status nginx