Come installare WildFly Java Application Server con Nginx Reverse Proxy su Ubuntu 20.04

WildFly, precedentemente noto come JBoss AS, è un’implementazione leggera del contenitore JEE (Java Enterprise Edition). Il suo runtime applicativo flessibile è scritto in Java e ti aiuta a costruire fantastiche applicazioni.

WildFly è un runtime applicativo multi-piattaforma che gira su sistemi operativi Linux, macOS e Windows. Creato da JBoss Inc, nel 2006 è stato acquisito da RedHat e divenne WildFly.

In questo tutorial, ti mostreremo come installare WildFly sull’ultima versione di Ubuntu 20.04. Installeremo l’ultima versione di WildFly 20, abiliteremo la console di amministrazione per WildFly, creeremo l’utente amministratore di WildFly e configureremo Nginx come reverse proxy per WildFly.

Prerequisiti

Per questa guida, installeremo WildFly sull’ultima versione di Ubuntu Server 20.04 FocalFossa con 2 GB di RAM, 50 GB di spazio libero su disco e 2 CPU.

Cosa faremo?

• Installare Java OpenJDK 11
• Aggiungere un nuovo utente e scaricare WildFly
• Configurazione di base di WildFly
• Abilitare la console di amministrazione di WildFly
• Configurare l’utente amministratore per WildFly
• Configurare Nginx come reverse proxy per WildFly
• Testare

Passo 1 - Installare Java OpenJDK

Per prima cosa, installeremo Java OpenJDK sul server Ubuntu 20.04. Utilizzeremo Java OpenJDK 11 per la nostra installazione di WildFly, che è la versione predefinita dei pacchetti Java nel repository di Ubuntu 20.04.

Aggiorna tutti i repository dei pacchetti e installa Java OpenJDK utilizzando il comando apt qui sotto.

sudo apt update  
sudo apt install default-jdk

Una volta completata l’installazione, controlla la versione di Java utilizzando il seguente comando.

java -version

Di seguito è riportato il risultato che otterrai.

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)

Di conseguenza, l’installazione di Java OpenJDK su Ubuntu 20.04 è stata completata.

Passo 2 - Aggiungere un nuovo utente e scaricare WildFly

In questo passo, creeremo un nuovo utente di sistema e un gruppo ‘wildfly’ e scaricheremo il codice sorgente di wildfly nella directory ‘/opt/wildfly’.

Ora crea un nuovo utente e gruppo chiamato ‘wildfly’ utilizzando i comandi qui sotto.

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

Successivamente, vai nella directory ‘/opt’ e scarica il codice sorgente di wildfly utilizzando il comando wget come sotto.

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

Il codice sorgente di wildfly è stato scaricato.

Ora estrai il codice sorgente di wildfly e rinomina la directory estratta in ‘wildfly’.

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

Dopo di che, cambia la proprietà della directory ‘wildfly’ all’utente e al gruppo ‘wildfly’.

chown -RH wildfly:wildfly /opt/wildfly

Di conseguenza, la directory di installazione di wildfly si trova nella directory ‘/opt/wildfly’. Il servizio wildfly verrà eseguito sotto il nuovo utente chiamato ‘wildfly’ che abbiamo appena creato.

Passo 3 - Configurazione di base di WildFly

Dopo aver scaricato il codice sorgente di wildfly, configureremo wildfly sul sistema Ubuntu.

Crea una nuova directory di configurazione ‘/etc/wildfly’ e copia la configurazione di esempio ‘wildfly.conf’ al suo interno.

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

Successivamente, copia il file di servizio ‘wildfly.service’ nella directory ‘/etc/systemd/system’.

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

Dopo di che, copia l’esempio di script di avvio di wildfly nella directory ‘/opt/wildfly/bin’ e rendilo eseguibile.

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

Ora ricarica il gestore systemd per applicare il nuovo file ‘wildfly.service’.

systemctl daemon-reload

Avvia il servizio wildfly e aggiungilo all’avvio del sistema.

systemctl start wildfly  
systemctl enable wildfly

Il servizio wildfly è attivo e funzionante sul sistema Ubuntu con la configurazione predefinita.

Controlla il servizio wildfly utilizzando il seguente comando.

ss -plnt  
systemctl status wildfly

E otterrai il risultato qui sotto.

Come si può vedere, wildfly gira come servizio systemd sulla porta TCP predefinita ‘8080’ sul sistema Ubuntu.

Passo 4 - Abilitare la console di amministrazione di WildFly

In questo passo, configureremo wildfly per girare sull’indirizzo IP locale ‘127.0.0.1’ e abiliteremo la sua console di amministrazione. Modificheremo la configurazione di wildfly ‘wildfly.conf’, lo script di avvio di wildfly ‘launch.sh’ e il file di servizio di wildfly ‘wildfly.service’.

Modifica la configurazione di wildfly ‘/etc/wildfly/wildfly.conf’ utilizzando l’editor vim.

vim /etc/wildfly/wildfly.conf

Ora cambia il valore di ‘WILDFLY_BIND’ con l’indirizzo IP locale ‘127.0.0.1’.

WILDFLY_BIND=127.0.0.1

Per abilitare la console di amministrazione di wildfly, aggiungi la configurazione ‘WILDFLY_CONSOLE_BIND’ qui sotto.

WILDFLY_CONSOLE_BIND=127.0.0.1

Salva e chiudi.

Successivamente, modifica lo script di avvio di wildfly ‘/opt/wildfly/bin/launch.sh’ utilizzando l’editor vim.

vim /opt/wildfly/bin/launch.sh

Nelle righe ‘ domain.sh ‘ e ‘ standalone.sh ‘, aggiungi un’opzione aggiuntiva per abilitare la console di amministrazione di wildfly come sotto.

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.

Successivamente, modifica il file di servizio predefinito per wildfly ‘/etc/systemd/system/wildfly.service’ utilizzando l’editor vim.

vim /etc/systemd/system/wildfly.service

Nella riga ‘ ExecStart=/opt/wildfly/bin/launch.sh…. ‘, aggiungi l’opzione ‘ $WILDFLY_CONSOLE_BIND ‘ come sotto.

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

Salva e chiudi.

Ora ricarica il gestore systemd e riavvia il servizio wildfly.

systemctl daemon-reload  
systemctl restart wildfly

Il servizio wildfly è in esecuzione con la console di amministrazione abilitata, controlla utilizzando il comando qui sotto.

ss -plnt  
systemctl status wildfly

Di seguito è riportato il risultato che otterrai.

Di conseguenza, wildfly gira sull’indirizzo IP locale ‘ 127.0.0.1 ‘ con la porta TCP predefinita ‘ 8080 ‘, e la console di amministrazione di wildfly abilitata sulla porta TCP ‘ 9990 ‘.

Passo 5 - Configurare l’utente amministratore WildFly

In questo passo, creeremo un nuovo utente per gestire wildfly utilizzando lo script ‘add-user.sh’ fornito da wildfly.

Esegui lo script ‘add-user.sh’ di wildfly come sotto.

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

Per il tipo di utente, digita ‘ a ‘ per creare l’utente di gestione (amministratore per gestire wildfly).

Che tipo di utente desideri aggiungere?   
a) Utente di gestione (mgmt-users.properties)   
b) Utente applicativo (application-users.properties)  
(a): a

Ora digita il tuo nome utente e password, assicurati di utilizzare una password sicura.

Inserisci i dettagli del nuovo utente da aggiungere.  
Utilizzando il realm 'ManagementRealm' come scoperto dai file di proprietà esistenti.  
Nome utente : hakase  
Le raccomandazioni per la password sono elencate qui sotto. Per modificare queste restrizioni, modifica il file di configurazione add-user.properties.  
 - La password deve essere diversa dal nome utente  
 - La password non deve essere uno dei seguenti valori riservati {root, admin, administrator}  
 - La password deve contenere almeno 8 caratteri, 1 carattere alfabetico, 1 cifra, 1 simbolo non alfanumerico  
Password :   
Re-inserisci Password :

Per il gruppo del nuovo utente, premi semplicemente ‘ Invio ‘ per continuare.

A quali gruppi vuoi che appartenga questo utente? (Si prega di inserire un elenco separato da virgole, o lasciare vuoto per nessuno)[  ]:

Successivamente, digita ‘ yes ‘ per aggiungere il tuo utente al ‘ ManagementRealm ‘ su wildfly.

In procinto di aggiungere l'utente 'hakase' per il realm 'ManagementRealm'  
È corretto sì/no? yes  
Utente 'hakase' aggiunto al file '/opt/wildfly/standalone/configuration/mgmt-users.properties'  
Utente 'hakase' aggiunto al file '/opt/wildfly/domain/configuration/mgmt-users.properties'  
Utente 'hakase' con gruppi  aggiunto al file '/opt/wildfly/standalone/configuration/mgmt-groups.properties'  
Utente 'hakase' con gruppi  aggiunto al file '/opt/wildfly/domain/configuration/mgmt-groups.properties'

Digita ‘ yes ‘ per abilitare il tuo utente come processo per gestire il controller host master-slave di wildfly.

Questo nuovo utente verrà utilizzato per un processo AS per connettersi a un altro processo AS?   
e.g. per un controller host secondario che si connette al master o per una connessione remota per chiamate EJB server a server.   
sì/no? yes  
Per rappresentare l'utente aggiungi quanto segue alla definizione delle identità del server 

Di conseguenza, l’utente amministratore e di gestione per wildfly è stato creato.

Passo 6 - Configurare Nginx come reverse proxy per WildFly

In questo passo, installeremo e configureremo Nginx come reverse proxy per wildfly sul sistema Ubuntu.

Installa i pacchetti Nginx utilizzando il comando apt qui sotto.

sudo apt install nginx -y

Una volta completata l’installazione, vai nella directory di configurazione ‘/etc/nginx/‘.

cd /etc/nginx/

Crea un nuovo file ‘proxy_headers.conf’ sotto la directory ‘/etc/nginx/conf.d’ utilizzando l’editor vim.

vim conf.d/proxy_headers.conf

Incolla la seguente configurazione.

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.

Successivamente, crea una nuova configurazione di host virtuale per wildfly sotto la directory ‘/etc/nginx/sites-available’.

vim sites-available/wildfly

Cambia l’indirizzo IP con il tuo e incolla la configurazione al suo interno.

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

Salva e chiudi.

Successivamente, attiva l’host virtuale wildfly e controlla la configurazione di Nginx.

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

Ora assicurati che non ci siano errori, quindi riavvia il servizio Nginx.

systemctl restart nginx

Di conseguenza, l’installazione e la configurazione di Nginx come reverse proxy per wildfly sono state completate.

Passo 7 - Testare

Apri il tuo browser web e digita l’indirizzo IP del tuo server nella barra degli indirizzi.

http://192.168.1.50/

Ora otterrai la pagina indice predefinita di wildfly qui sotto.

Successivamente, accedi alla console di amministrazione di wildfly sul percorso URL ‘/console’ qui sotto.

http://192.168.1.50/console/

Accedi utilizzando il tuo utente amministratore di wildfly e la password.

Ora otterrai il dashboard di amministrazione di wildfly qui sotto.

Di conseguenza, l’installazione di wildfly con Nginx reverse proxy su Ubuntu 20.04 Server è stata completata con successo.