So installieren Sie den WildFly Java-Anwendungsserver mit Nginx-Proxy auf Ubuntu 20.04

WildFly, früher bekannt als JBoss AS, ist eine leichtgewichtige Implementierung des JEE (Java Enterprise Edition) Containers. Seine flexible Anwendungsruntime ist in Java geschrieben und hilft Ihnen, fantastische Anwendungen zu erstellen.

WildFly ist eine plattformübergreifende Anwendungsruntime, die auf Linux-, macOS- und Windows-Betriebssystemen läuft. Entwickelt von JBoss Inc. und 2006 von RedHat übernommen, wurde es zu WildFly.

In diesem Tutorial zeigen wir Ihnen, wie Sie WildFly auf dem neuesten Ubuntu 20.04 installieren. Wir installieren die neueste Version von WildFly 20, aktivieren die Administrationskonsole für WildFly, erstellen den WildFly-Administrationsbenutzer und richten Nginx als Reverse-Proxy für WildFly ein.

Voraussetzungen

Für diesen Leitfaden installieren wir WildFly auf dem neuesten Ubuntu Server 20.04 FocalFossa mit 2 GB RAM, 50 GB freiem Speicherplatz und 2 CPUs.

Was werden wir tun?

• Java OpenJDK 11 installieren
• Neuen Benutzer hinzufügen und WildFly herunterladen
• Grundkonfiguration von WildFly
• WildFly-Administrationskonsole aktivieren
• Administrationsbenutzer für WildFly einrichten
• Nginx als Reverse-Proxy für WildFly einrichten
• Testen

Schritt 1 - Java OpenJDK installieren

Zuerst installieren wir das Java OpenJDK auf dem Ubuntu-Server 20.04. Wir verwenden das Java OpenJDK 11 für unsere WildFly-Installation, das die Standardversion der Java-Pakete im Ubuntu 20.04-Repository ist.

Aktualisieren Sie alle Paket-Repositorys und installieren Sie Java OpenJDK mit dem folgenden apt-Befehl.

sudo apt update  
sudo apt install default-jdk

Sobald die Installation abgeschlossen ist, überprüfen Sie die Java-Version mit dem folgenden Befehl.

java -version

Unten ist das Ergebnis, das Sie erhalten werden.

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)

Das Ergebnis zeigt, dass die Installation von Java OpenJDK auf Ubuntu 20.04 abgeschlossen ist.

Schritt 2 - Neuen Benutzer hinzufügen und WildFly herunterladen

In diesem Schritt erstellen wir einen neuen Systembenutzer und die Gruppe ‘wildfly’ und laden den Quellcode von WildFly in das Verzeichnis ‘/opt/wildfly’ herunter.

Erstellen Sie jetzt einen neuen Benutzer und eine Gruppe mit dem Namen ‘wildfly’ mit den folgenden Befehlen.

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

Gehen Sie als Nächstes in das Verzeichnis ‘/opt’ und laden Sie den WildFly-Quellcode mit dem wget-Befehl wie folgt herunter.

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

Der WildFly-Quellcode wurde heruntergeladen.

Extrahieren Sie nun den WildFly-Quellcode und benennen Sie das extrahierte Verzeichnis in ‘wildfly’ um.

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

Ändern Sie danach den Eigentümer des Verzeichnisses ‘wildfly’ in den Benutzer und die Gruppe ‘wildfly’.

chown -RH wildfly:wildfly /opt/wildfly

Das Ergebnis zeigt, dass das WildFly-Installationsverzeichnis im Verzeichnis ‘/opt/wildfly’ liegt. Der WildFly-Dienst wird unter dem neuen Benutzer ‘wildfly’ ausgeführt, den wir gerade erstellt haben.

Schritt 3 - Grundkonfiguration von WildFly

Nachdem wir den WildFly-Quellcode heruntergeladen haben, richten wir WildFly im Ubuntu-System ein.

Erstellen Sie ein neues Konfigurationsverzeichnis ‘/etc/wildfly’ und kopieren Sie die Beispielkonfiguration ‘wildfly.conf’ hinein.

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

Kopieren Sie als Nächstes die Dienstdatei ‘wildfly.service’ in das Verzeichnis ‘/etc/systemd/system’.

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

Kopieren Sie danach das Beispiel des WildFly-Startskripts in das Verzeichnis ‘/opt/wildfly/bin’ und machen Sie es ausführbar.

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

Laden Sie jetzt den systemd-Manager neu, um die neue ‘wildfly.service’-Datei anzuwenden.

systemctl daemon-reload

Starten Sie den WildFly-Dienst und fügen Sie ihn zum Systemstart hinzu.

systemctl start wildfly  
systemctl enable wildfly

Der WildFly-Dienst läuft jetzt auf dem Ubuntu-System mit der Standardkonfiguration.

Überprüfen Sie den WildFly-Dienst mit dem folgenden Befehl.

ss -plnt  
systemctl status wildfly

Und Sie erhalten das folgende Ergebnis.

Wie zu sehen ist, läuft WildFly als Systemd-Dienst auf dem Standard-TCP-Port ‘8080’ auf dem Ubuntu-System.

Schritt 4 - WildFly-Administrationskonsole aktivieren

In diesem Schritt richten wir WildFly so ein, dass es auf der lokalen IP-Adresse ‘127.0.0.1’ läuft und aktivieren die Administrationskonsole. Wir werden die WildFly-Konfiguration ‘wildfly.conf’, das WildFly-Startskript ‘launch.sh’ und die WildFly-Dienstdatei ‘wildfly.service’ bearbeiten.

Bearbeiten Sie die WildFly-Konfiguration ‘/etc/wildfly/wildfly.conf’ mit dem vim-Editor.

vim /etc/wildfly/wildfly.conf

Ändern Sie jetzt den Wert von ‘WILDFLY_BIND’ auf die lokale IP-Adresse ‘127.0.0.1’.

WILDFLY_BIND=127.0.0.1

Um die WildFly-Administrationskonsole zu aktivieren, fügen Sie die Konfiguration ‘WILDFLY_CONSOLE_BIND’ unten hinzu.

WILDFLY_CONSOLE_BIND=127.0.0.1

Speichern und schließen.

Bearbeiten Sie als Nächstes das Startskript für WildFly ‘/opt/wildfly/bin/launch.sh’ mit dem vim-Editor.

vim /opt/wildfly/bin/launch.sh

Fügen Sie in den Zeilen ‘domain.sh‘ und ‘standalone.sh‘ eine zusätzliche Option hinzu, um die WildFly-Administrationskonsole wie folgt zu aktivieren.

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

Speichern und schließen.

Bearbeiten Sie als Nächstes die Standarddienstdatei für WildFly ‘/etc/systemd/system/wildfly.service’ mit dem vim-Editor.

vim /etc/systemd/system/wildfly.service

Fügen Sie in der Zeile ‘ExecStart=/opt/wildfly/bin/launch.sh….‘ die Option ‘$WILDFLY_CONSOLE_BIND‘ wie folgt hinzu.

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

Speichern und schließen.

Laden Sie jetzt den systemd-Manager neu und starten Sie den WildFly-Dienst neu.

systemctl daemon-reload  
systemctl restart wildfly

Der WildFly-Dienst läuft mit aktivierter Administrationskonsole, überprüfen Sie dies mit dem folgenden Befehl.

ss -plnt  
systemctl status wildfly

Unten ist das Ergebnis, das Sie erhalten werden.

Das Ergebnis zeigt, dass WildFly auf der lokalen IP-Adresse ‘127.0.0.1‘ mit dem Standard-TCP-Port ‘8080‘ läuft und die WildFly-Administrationskonsole auf dem TCP-Port ‘9990‘ aktiviert ist.

Schritt 5 - Administrationsbenutzer für WildFly einrichten

In diesem Schritt erstellen wir einen neuen Benutzer zur Verwaltung von WildFly mit dem Skript ‘add-user.sh’, das von WildFly bereitgestellt wird.

Führen Sie das WildFly-Skript ‘add-user.sh’ wie folgt aus.

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

Für den Benutzertyp geben Sie ‘ a ‘ ein, um den Verwaltungsbenutzer (Admin zur Verwaltung von WildFly) zu erstellen.

Was für einen Benutzertyp möchten Sie hinzufügen?   
a) Verwaltungsbenutzer (mgmt-users.properties)   
b) Anwendungsbenutzer (application-users.properties)  
(a): a

Geben Sie jetzt Ihren Benutzernamen und Ihr Passwort ein und stellen Sie sicher, dass Sie ein sicheres Passwort verwenden.

Geben Sie die Details des neuen Benutzers ein, den Sie hinzufügen möchten.  
Verwende das Realm 'ManagementRealm', das aus den vorhandenen Property-Dateien entdeckt wurde.  
Benutzername : hakase  
Passwortempfehlungen sind unten aufgeführt. Um diese Einschränkungen zu ändern, bearbeiten Sie die Konfigurationsdatei add-user.properties.  
 - Das Passwort sollte sich vom Benutzernamen unterscheiden  
 - Das Passwort sollte nicht einer der folgenden eingeschränkten Werte sein {root, admin, administrator}  
 - Das Passwort sollte mindestens 8 Zeichen, 1 alphabetisches Zeichen, 1 Ziffer, 1 nicht-alphanumerisches Symbol enthalten  
Passwort :   
Passwort erneut eingeben :

Für die Gruppe des neuen Benutzers drücken Sie einfach ‘ Enter ‘, um fortzufahren.

Welche Gruppen möchten Sie, dass dieser Benutzer angehört? (Bitte geben Sie eine durch Kommas getrennte Liste ein oder lassen Sie es leer für keine)[  ]:

Geben Sie als Nächstes ‘ yes ‘ ein, um Ihren Benutzer zur ‘ ManagementRealm ‘ in WildFly hinzuzufügen.

Überprüfen Sie, ob der Benutzer 'hakase' für das Realm 'ManagementRealm' hinzugefügt wird.  
Ist das korrekt yes/no? yes  
Benutzer 'hakase' zur Datei '/opt/wildfly/standalone/configuration/mgmt-users.properties' hinzugefügt  
Benutzer 'hakase' zur Datei '/opt/wildfly/domain/configuration/mgmt-users.properties' hinzugefügt  
Benutzer 'hakase' mit Gruppen zur Datei '/opt/wildfly/standalone/configuration/mgmt-groups.properties' hinzugefügt  
Benutzer 'hakase' mit Gruppen zur Datei '/opt/wildfly/domain/configuration/mgmt-groups.properties' hinzugefügt

Geben Sie ‘ yes ‘ ein, um Ihren Benutzer als Prozess zur Verwaltung des Master-Slave-Host-Controllers von WildFly zu aktivieren.

Wird dieser neue Benutzer für einen AS-Prozess verwendet, um sich mit einem anderen AS-Prozess zu verbinden?   
e.g. für einen Slave-Host-Controller, der sich mit dem Master verbindet oder für eine Remoting-Verbindung für Server-zu-Server EJB-Aufrufe.   
yes/no? yes  
Um den Benutzer darzustellen, fügen Sie Folgendes zur Definition der Serveridentitäten hinzu 

Das Ergebnis zeigt, dass der Administrations- und Managementbenutzer für WildFly erstellt wurde.

Schritt 6 - Nginx als Reverse-Proxy für WildFly einrichten

In diesem Schritt installieren und konfigurieren wir Nginx als Reverse-Proxy für WildFly auf dem Ubuntu-System.

Installieren Sie die Nginx-Pakete mit dem folgenden apt-Befehl.

sudo apt install nginx -y

Sobald die Installation abgeschlossen ist, gehen Sie in das Konfigurationsverzeichnis ‘/etc/nginx/‘.

cd /etc/nginx/

Erstellen Sie eine neue Datei ‘proxy_headers.conf’ im Verzeichnis ‘/etc/nginx/conf.d’ mit dem vim-Editor.

vim conf.d/proxy_headers.conf

Fügen Sie die folgende Konfiguration ein.

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

Speichern und schließen.

Erstellen Sie als Nächstes eine neue virtuelle Hostkonfiguration für WildFly im Verzeichnis ‘/etc/nginx/sites-available’.

vim sites-available/wildfly

Ändern Sie die IP-Adresse in Ihre eigene und fügen Sie die Konfiguration ein.

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

Speichern und schließen.

Aktivieren Sie als Nächstes den WildFly-virtuellen Host und überprüfen Sie die Nginx-Konfiguration.

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

Stellen Sie sicher, dass es keinen Fehler gibt, und starten Sie dann den Nginx-Dienst neu.

systemctl restart nginx

Das Ergebnis zeigt, dass die Nginx-Installation und -Konfiguration als Reverse-Proxy für WildFly abgeschlossen ist.

Schritt 7 - Testen

Öffnen Sie Ihren Webbrowser und geben Sie die IP-Adresse Ihres Servers in die Adresszeile ein.

http://192.168.1.50/

Jetzt erhalten Sie die Standard-Indexseite von WildFly wie unten gezeigt.

Greifen Sie als Nächstes auf die WildFly-Administrationskonsole unter dem URL-Pfad ‘/console’ wie unten gezeigt zu.

http://192.168.1.50/console/

Melden Sie sich mit Ihrem WildFly-Administrationsbenutzer und Passwort an.

Jetzt erhalten Sie das WildFly-Administrations-Dashboard wie unten gezeigt.

Das Ergebnis zeigt, dass die Installation von WildFly mit Nginx-Reverse-Proxy auf dem Ubuntu 20.04-Server erfolgreich abgeschlossen wurde.