Ricerca nel sito web

Come installare il server delle applicazioni WildFly con il proxy inverso Nginx su Debian 12

Come installare il server delle applicazioni WildFly con il proxy inverso Nginx su Debian 12

Questa esercitazione esiste per queste versioni del sistema operativo

  • Debian 12 (topo di biblioteca)
  • Debian 11 (Bullseye)
  • Debian 10 (Buster)

Su questa pagina

  1. Prerequisiti
  2. Installazione di Java OpenJDK

  3. Installazione e configurazione di WildFly

    1. Aggiunta di utenti e gruppi wildfly
    2. Download del pacchetto binario WildFly
    3. Configurazione dell'installazione di WildFly
    4. Esecuzione di WildFly come servizio Systemd
  4. Aggiunta della gestione degli utenti WildFly
  5. Configurazione di Nginx come proxy inverso
  6. Accesso a WildFly tramite client
  7. Conclusione

WildFly, precedentemente JBoss, è un server di applicazioni gratuito e open source che consente di creare 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 di applicazioni 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 di applicazioni multipiattaforma che fornisce strumenti per applicazioni Java come EJB, JPA, Servlets, JAX-RS, Batch e sicurezza.

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

Prerequisiti

Prima di andare avanti, raccogli quanto segue:

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

Installazione di Java OpenJDK

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

Innanzitutto, esegui il seguente comando per aggiornare il tuo repository Debian.

sudo apt update

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

sudo apt install default-jdk

Inserire y per procedere con l'installazione.

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

java -version

Installazione e configurazione di WildFly

Dopo aver installato Java OpenJDK, è ora possibile avviare l'installazione di WildFly completando le seguenti attività:

  • Aggiunta di utenti e gruppi wildfly
  • Download del pacchetto binario WildFly
  • Configurazione dell'installazione di WildFly
  • Esecuzione di WildFly come servizio Systemd

Iniziamo.

Aggiunta di utenti e gruppi wildfly

Innanzitutto, creerai un nuovo utente di sistema e un gruppo wildfly che verrà utilizzato per eseguire l'installazione di WildFly.

Esegui il comando seguente per aggiungere un nuovo gruppo e 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

Download del pacchetto binario WildFly

Dopo aver aggiunto un utente systemd, scaricherai il pacchetto binario 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

Successivamente, visita la pagina di download di WildFly e copia il link all'ultima versione di WildFly. Scarica il pacchetto binario WildFly tramite il comando wget come il seguente. 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

Quindi, decomprimi il pacchetto binario 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 seguente per modificare la proprietà della directory /opt/wildfly con l'utente wildfly.

sudo chown -RH wildfly: /opt/wildfly

Configurazione dell'installazione di WildFly

In questo esempio, installerai WildFly su un singolo computer in modalità autonoma. Quindi, ogni configurazione che modifichi qui è correlata alle configurazioni standalone di WildFly.

Avviare il seguente comando nano editor per aprire il file /opt/wildfly/bin/standalone.conf.

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

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

Assicurarsi di regolare la dimensione massima della memoria heap con il server corrente. Nell'esempio seguente viene impostata la memoria heap massima su 4 GB.

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

Salva ed esci dal file quando hai finito.

Ora crea una nuova directory di configurazione /etc/wildfly usando il comando seguente.

sudo mkdir -p /etc/wildfly

Copiare il file di configurazione di WildFly in /etc/wildfly/wildfly.conf e aprirlo utilizzando il seguente comando nano editor.

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

Modificare il WILDFLY_BIND predefinito in 127.0.0.1 e aggiungere un WILDFLY_CONSOLE_BIND variabile per abilitare l'amministrazione della console WildFly. Sia WildFly che la console di amministrazione saranno in esecuzione in localhost.

The address to bind to
WILDFLY_BIND=127.0.0.1
Enable Admin
WILDFLY_CONSOLE_BIND=127.0.0.1

Al termine, salva ed esci dal file.

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

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 WildFly /opt/wildfly/bin/launch.sh utilizzando il seguente comando nano editor.

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

Al termine, salvare e chiudere il file.

Infine, esegui il comando seguente per modificare la proprietà WildFly directory di installazione /opt/wildfly all'utente wildfly.

sudo chown -RH wildfly: /opt/wildfly

Esecuzione di WildFly come servizio Systemd

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

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

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 WildFly.

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

Al termine, salva il file ed esci dall'editor.

Quindi, esegui il seguente comando systemctl per ricaricare il gestore systemd.

sudo systemctl daemon-reload

Quindi avvia e abilita il servizio wildfly utilizzando il comando seguente.

sudo systemctl start wildfly
sudo systemctl enable wildfly

Verificare il servizio wildfly per assicurarsi che sia in esecuzione eseguendo il comando seguente.

sudo systemctl status wildfly

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

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 utilizzate da WildFly.

Aggiunta della gestione degli utenti 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 il seguente.

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

Ora ti verrà chiesto quanto segue:

  • Immettere a per creare un nuovo utente di gestione WildFly.
  • Inserisci l'utente e la password dell'amministratore, quindi ripetili.
  • Premere ENTER quando viene richiesta la configurazione del gruppo.
  • Immettere yes per aggiungere l'utente a ManagementRealm.

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

Configurazione di Nginx come proxy inverso

A questo punto, hai completato l'installazione di WildFLy, abilitato la console di amministrazione e creato l'utente amministratore. Il passaggio successivo consiste nell'installare Nginx e configurarlo come proxy inverso per WildFly.

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

sudo apt install nginx

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

Crea una nuova configurazione delle intestazioni proxy Nginx /etc/nginx/conf.d/proxy_headers.conf utilizzando il comando nano editor seguente.

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

Inserire 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;
```

Al termine, salva ed esci dal file.

Quindi, avvia il seguente comando nano editor per creare una nuova configurazione del blocco del server Nginx /etc/nginx/sites-available/wildfly.

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

Inserisci la configurazione seguente per configurare Nginx come proxy inverso per l'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 seguente per attivare il file host virtuale 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 "la sintassi è ok—il test è riuscito".

Infine, esegui il comando seguente per riavviare il servizio Nginx e applicare le modifiche apportate. Quindi, 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 avere l'output attivo (in esecuzione).

Accesso a WildFly tramite client

Sul computer client, aprire il file hosts utilizzando l'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 i privilegi sudo.

Inserisci la seguente configurazione e assicurati di modificare 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 (ad esempio: http:wildfly.howtoforge.local/). Se l'installazione ha esito positivo, dovrebbe essere visualizzata la pagina di indice WildFly predefinita, che è la seguente:

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

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

Se disponi dell'utente e della password corretti, dovresti vedere la console di amministrazione di WildFly come segue.

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

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

Conclusione

In conclusione, ora hai terminato 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 proxy inverso per Wildfly. D'ora in poi, è possibile distribuire ed eseguire le applicazioni JBoss utilizzando il runtime dell'applicazione WildFly.