Come installare WildFly Application Server con Nginx Reverse Proxy su Debian 12

WildFly, precedentemente JBoss, è un server applicativo gratuito e open-source che ti aiuta a costruire e distribuire applicazioni web Java. È scritto in Java e conforme alle specifiche Java EE (Enterprise Edition). WildFly è stato creato da JBoss ma ora è sviluppato da RedHat. È un server applicativo potente, pronto per la produzione, modulare e leggero che fornisce tutti gli strumenti e le funzionalità necessari per eseguire e distribuire applicazioni web Java.

WildFly è un server applicativo multipiattaforma che fornisce strumenti per applicazioni Java come EJB, JPA, Servlets, JAX-RS, Batch e sicurezza.

In questa guida, imparerai come installare WildFly o JBoss runtime applicativo su un server Debian 12 passo dopo passo. Installerai WildFly, abiliterai la console di amministrazione, creerai un utente amministratore WildFly e installerai e configurerai Nginx come reverse proxy.

Prerequisiti

Prima di procedere, raccogli i seguenti elementi:

• Un server Debian 12 con 4GB o più di memoria.
• Un utente non root con privilegi di amministratore sudo.

Installazione di Java OpenJDK

WildFly è un runtime applicativo Java flessibile e leggero per costruire applicazioni. In questa sezione, installerai e utilizzerai Java OpenJDK 17 per installare WildFly sul tuo server Debian.

Per prima cosa, esegui il seguente comando per aggiornare il tuo repository Debian.

sudo apt update

Ora, installa il pacchetto Java OpenJDK eseguendo il comando qui sotto. Questo installerà il pacchetto default-jdk, che è equivalente alla versione Java OpenJDK 17 LTS (Long Term Supports).

sudo apt install default-jdk

Inserisci y per procedere con l’installazione.

Dopo aver installato Java, verifica la versione di Java utilizzando il comando qui sotto. Dovresti vedere che Java OpenJDK 17 è installato.

java -version

Installazione e configurazione di WildFly

Dopo aver installato Java OpenJDK, puoi ora avviare l’installazione di WildFly completando i seguenti compiti:

• Aggiungere l’utente e il gruppo wildfly
• Scaricare il pacchetto binario di WildFly
• Configurare l’installazione di WildFly
• Eseguire WildFly come servizio Systemd

Iniziamo.

Aggiungere l’utente e il gruppo wildfly

Per prima cosa, creerai un nuovo utente di sistema e un gruppo wildfly che verranno utilizzati per eseguire la tua installazione di WildFly.

Esegui il comando qui sotto per aggiungere un nuovo gruppo e un utente chiamato wildfly eseguendo il seguente comando. Con questo, imposterai anche la directory home predefinita per gli utenti wildfly su /opt/wildfly, che verrà utilizzata come directory di installazione di WildFly.

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

Scaricare il pacchetto binario di WildFly

Dopo aver aggiunto un utente systemd, scaricherai il pacchetto binario di WildFly tramite wget. Assicurati di visitare la pagina di download di WildFly per ottenere l’ultima versione.

Prima di ciò, installa unzip tramite il seguente comando apt.

sudo apt install unzip -y

Dopo di che, visita la pagina di download di WildFly e copia il link all’ultima versione di WildFly. Scarica il pacchetto binario di WildFly tramite il comando wget come segue. In questo esempio, installerai WildFly 30.0.0.

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

Successivamente, estrai il pacchetto binario di WildFly e sposta la directory estratta in /opt/wildfly.

unzip wildfly-30.0.0.Final.zip  
sudo mv wildfly-30.0.0.Final /opt/wildfly

Infine, esegui il comando qui sotto per cambiare la proprietà della directory /opt/wildfly all’utente wildfly.

sudo chown -RH wildfly: /opt/wildfly

Configurare l’installazione di WildFly

In questo esempio, installerai WildFly su una singola macchina in modalità standalone. Quindi, ogni configurazione che modifichi qui è relativa alle configurazioni standalone di WildFly.

Lancia il seguente comando dell’editor nano per aprire il file /opt/wildfly/bin/standalone.conf.

sudo nano /opt/wildfly/bin/standalone.conf

Cambia il valore Xmx512m all’interno della variabile ambientale JBOSS_JAVA_SIZING per aumentare la dimensione massima della memoria heap predefinita di WildFly, come segue.

Assicurati di regolare la dimensione massima della memoria heap con il tuo server attuale. Il seguente esempio imposta la memoria heap massima su 4GB.

  JBOSS_JAVA_SIZING="-Xms64m -Xmx4096m -XX:MetaspaceSize=96M -XX:MaxMetaspaceSize=256m"

Salva e chiudi il file quando hai finito.

Ora crea una nuova directory di configurazione /etc/wildfly utilizzando il comando qui sotto.

sudo mkdir -p /etc/wildfly

Copia il file di configurazione di WildFly in /etc/wildfly/wildfly.conf e aprilo utilizzando il seguente comando dell’editor nano.

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

Cambia il valore predefinito WILDFLY_BIND in 127.0.0.1 e aggiungi una variabile WILDFLY_CONSOLE_BIND per abilitare la console di amministrazione di WildFly. Sia WildFly che la console di amministrazione verranno eseguiti in localhost.

# L'indirizzo a cui collegarsi  
WILDFLY_BIND=127.0.0.1  
  
# Abilita Admin  
WILDFLY_CONSOLE_BIND=127.0.0.1

Quando hai finito, salva e chiudi il file.

Successivamente, copia lo script di avvio di WildFly in /opt/wildfly/bin/launch.sh e rendilo eseguibile tramite il comando chmod qui sotto

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

Apri lo script di avvio di WildFly /opt/wildfly/bin/launch.sh utilizzando il seguente comando dell’editor nano.

sudo nano /opt/wildfly/bin/launch.sh

Inserisci la nuova opzione di comando ‘-bmanagement $4‘ per abilitare la console di amministrazione di WildFly in questo modo.

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 quando hai finito.

Infine, esegui il comando qui sotto per cambiare la proprietà della directory di installazione di WildFly /opt/wildfly all’utente wildfly.

sudo chown -RH wildfly: /opt/wildfly

Eseguire WildFly come servizio Systemd

Dopo aver configurato WildFly in modalità standalone, imposterai un file di servizio systemd per WildFly. Questo ti consente di eseguire WildFly in background e gestire WildFly facilmente tramite l’utilità systemctl.

Copia il file di servizio systemd di WildFly in /etc/systemd/system/wildfly.service e modificalo utilizzando il seguente comando dell’editor nano.

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

All’interno dell’opzione ExecStart, aggiungi un nuovo parametro di avvio $WILDFLY_CONSOLE_BIND per abilitare la console di amministrazione di WildFly.

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

Quando hai finito, salva il file e chiudi l’editor.

Successivamente, esegui il comando systemctl qui sotto per ricaricare il gestore systemd.

sudo systemctl daemon-reload

Poi avvia e abilita il servizio wildfly utilizzando il comando qui sotto.

sudo systemctl start wildfly  
sudo systemctl enable wildfly

Verifica il servizio wildfly per assicurarti che il servizio sia in esecuzione eseguendo il seguente comando.

sudo systemctl status wildfly

Se il servizio wildfly è in esecuzione, verrà visualizzato il seguente output.

Puoi anche verificare l’elenco delle porte aperte sul tuo sistema eseguendo il seguente comando.

ss -antpl | grep -i java

Dovresti vedere più porte 8080, 8443 e 9990 che WildFly utilizza.

Aggiungere la gestione degli utenti di WildFly

Dopo aver installato WildFly, creerai un nuovo utente amministratore per WildFly tramite lo script /opt/wildfly/bin/add-user.sh.

Esegui lo script /opt/wildfly/bin/add-user.sh come segue.

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

Ora ti verrà chiesto quanto segue:

• Inserisci a per creare un nuovo utente di gestione WildFly.
• Inserisci il tuo nome utente e password amministratore, quindi ripetilo.
• Premi INVIO quando ti viene chiesto di configurare il gruppo.
• Inserisci sì per aggiungere il tuo utente al ManagementRealm.

Una volta terminato il processo, dovresti vedere che il tuo nuovo utente è stato aggiunto alla configurazione di WildFly.

Configurare Nginx come Reverse Proxy

A questo punto, hai completato l’installazione di WildFly, abilitato la console di amministrazione e creato l’utente amministratore. Il passo successivo è installare Nginx e configurarlo come reverse proxy per WildFly.

Esegui il comando apt qui sotto per installare Nginx sul tuo server Debian. Inserisci y per procedere con l’installazione.

sudo apt install nginx

Una volta installato Nginx, lo configurerai come reverse proxy per WildFly.

Crea una nuova configurazione degli header proxy di Nginx /etc/nginx/conf.d/proxy_headers.conf utilizzando il seguente comando dell’editor nano.

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

Inserisci la seguente configurazione nel file.

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 quando hai finito.

Successivamente, lancia il seguente comando dell’editor nano per creare una nuova configurazione del blocco server Nginx /etc/nginx/sites-available/wildfly.

sudo nano /etc/nginx/sites-available/wildfly

Inserisci la configurazione qui sotto per impostare Nginx come reverse proxy per la tua installazione di WildFly. Assicurati di cambiare il dominio all’interno dell’opzione server_name, puoi utilizzare un nome di dominio locale.

server {  
    listen          80;  
    server_name     wildfly.howtoforge.local;  
  
    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 il file quando hai finito.

Ora esegui il comando qui sotto per attivare il file del virtual host wildfly e verificare la sintassi di Nginx.

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

Se hai una sintassi Nginx corretta, verrà visualizzato l’output “syntax is ok—test is successful“.

Infine, esegui il comando qui sotto per riavviare il servizio Nginx e applicare le modifiche che hai effettuato. Poi, verifica il servizio Nginx per assicurarti che il servizio sia in esecuzione.

sudo systemctl restart nginx  
sudo systemctl status nginx

Se Nginx è in esecuzione, dovresti ottenere l’output active (running).

Accesso a WildFly tramite Client

Sul tuo computer client, apri il file hosts utilizzando il tuo editor di testo. Per gli utenti Windows, apri il file C:\Windows\System32\drivers\etc\hosts come amministratore, mentre per gli utenti Linux o macOS, apri il file /etc/hosts con privilegi sudo.

Inserisci la seguente configurazione e assicurati di cambiare il nome di dominio locale e l’indirizzo IP con le tue informazioni.

192.168.5.15  wildfly.howtoforge.local

Salva e chiudi il file quando hai finito.

Avvia il tuo browser web e visita il tuo dominio locale WildFly (es.: http:wildfly.howtoforge.local/). Se la tua installazione è riuscita, dovresti vedere la pagina indice predefinita di WildFly, che è la seguente:

Ora fai clic sul link Console di Amministrazione per accedere alla console di amministrazione di WildFly. Questo aprirà una nuova scheda e verrai reindirizzato alla console di amministrazione di WildFly con il percorso URL /console.

Inserisci il tuo utente amministratore e la password per la console di amministrazione di WildFly, quindi fai clic su Accedi.

Se hai l’utente e la password corretti, dovresti vedere la console di amministrazione di WildFly come segue.

Successivamente, fai clic sul menu Runtime e seleziona il tuo server. Dovresti vedere la conferma che WildFly è attivo e funzionante.

Infine, seleziona il menu Status e dovresti vedere lo stato dettagliato della tua installazione di WildFly, inclusa la configurazione della heap cambiata a 4GB.

Conclusione

In conclusione, hai ora completato l’installazione di WildFly su Debian 12 passo dopo passo. Hai installato WildFly, abilitato la console di amministrazione e creato un utente amministratore WildFly. Inoltre, hai anche configurato Nginx come reverse proxy per WildFly. D’ora in poi, puoi distribuire ed eseguire le tue applicazioni JBoss utilizzando il runtime applicativo WildFly.