Wie installiere ich WildFly Java Application Server mit Nginx Reverse Proxy unter Ubuntu 20.04

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

WildFly ist eine plattformübergreifende Anwendungslaufzeit, die auf den Betriebssystemen Linux, MacOS und Windows läuft. Sie wurde von JBoss Inc. entwickelt und 2006 von RedHat übernommen und zur WildFly.

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

Voraussetzungen

Für diese Anleitung werden wir WildFly auf dem neuesten Ubuntu-Server 20.04 FocalFossa mit 2 GB RAM, 50 GB freiem Festplattenspeicher und 2 CPUs installieren.

Was werden wir tun?

• Java OpenJDK 11 installieren
• Neuen Benutzer hinzufügen und WildFly herunterladen
• WildFly Grundkonfiguration
• Aktivieren der WildFly Admin-Konsole
• Admin-Benutzer für WildFly einrichten
• Einrichten von Nginx als Reverse-Proxy für WildFly
• testen.

Schritt 1 – Java OpenJDK installieren

Zuerst werden wir das Java OpenJDK auf dem Ubuntu-Server 20.04 installieren. Und wir werden das Java OpenJDK 11 für unsere WildFly-Installation verwenden, bei der es sich um die Standardversion der Java-Pakete auf dem Ubuntu-Repository 20.04 handelt.

Aktualisieren Sie das Repository aller Pakete und installieren Sie Java OpenJDK mit dem untenstehenden apt-Befehl.

sudo apt update
sudo apt install default-jdk

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

java -version

Unten sehen Sie 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)

Als Ergebnis wurde die Installation von Java OpenJDK auf Ubuntu 20.04 abgeschlossen.

Schritt 2 – Neuen Benutzer hinzufügen und WildFly herunterladen

In diesem Schritt werden wir einen neuen Systembenutzer und die Gruppe ‚wildfly‘ erstellen und den Quellcode von wildfly in das Verzeichnis ‚/opt/wildfly‘ herunterladen.

Erstellen Sie nun einen neuen Benutzer und eine neue Gruppe mit dem Namen ‚wildfly‘ mit Hilfe der folgenden Befehle.

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

Als nächstes gehen Sie in das Verzeichnis ‚/opt‘ und laden Sie den wildfly-Quellcode mit dem wget Befehl wie unten beschrieben 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 Besitzer des Verzeichnisses „wildfly“ auf den Benutzer und die Gruppe „wildfly“.

chown -RH wildfly:wildfly /opt/wildfly

Folglich befindet sich das Installationsverzeichnis von WildFly im Verzeichnis ‚/opt/wildfly‘. Der wildfly-Dienst wird unter dem neuen Benutzer namens „wildfly“ laufen, den wir gerade oben angelegt haben.

Schritt 3 – WildFly-Grundkonfiguration

Nachdem Sie den wildfly-Quellcode heruntergeladen haben, richten wir den wildfly-Dienst auf dem 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/

Als nächstes kopieren Sie 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 nun den Systemmanager neu, um die neue Datei ‚wildfly.service‘ 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 ist auf dem Ubuntu-System mit der Standardkonfiguration einsatzbereit.

Prüfen Sie den Wildflugdienst mit dem folgenden Befehl.

ss -plnt
systemctl status wildfly

Und Sie erhalten das Ergebnis wie unten angegeben.

Wie zu sehen ist, läuft die wildfly als Systemdienst auf dem Standard-TCP-Port ‚8080‘ des Ubuntu-Systems.

Schritt 4 – Aktivieren der WildFly Admin-Konsole

In diesem Schritt richten wir einen „wildfly“ ein, der auf der lokalen IP-Adresse ‚127.0.0.1‘ läuft und seine Verwaltungskonsole aktiviert. Wir werden die wildfly-Konfiguration ‚wildfly.conf‘, das wildfly-Startskript ‚launch.sh‘ und die wildfly-Dienstdatei ‚wildfly.service‘ bearbeiten.

Wir editieren die wildfly-Konfiguration ‚/etc/wildfly/wildfly.conf‘ mit dem vim-Editor.

vim /etc/wildfly/wildfly.conf

Ändern Sie nun den Wert von ‚WILDFLY_BIND‘ mit der lokalen IP-Adresse ‚127.0.0.1‘.

WILDFLY_BIND=127.0.0.1

Um die Verwaltungskonsole von wildfly zu aktivieren, fügen Sie unten die Konfiguration ‚WILDFLY_CONSOLE_BIND‘ hinzu.

WILDFLY_CONSOLE_BIND=127.0.0.1

Speichern und schließen.

Als nächstes editieren Sie das Startskript für den Start von wildfly ‚/opt/wildfly/bin/launch.sh‘ mit dem Editor vim.

vim /opt/wildfly/bin/launch.sh

Fügen Sie in den Zeilen ‚domain.sh‚ und ’standalone.sh‚ eine zusätzliche Option hinzu, um die Verwaltungskonsole von wildfly wie unten beschrieben 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.

Als nächstes editieren Sie die Standard-Dienst-Datei für wildfly ‚/etc/systemd/system/wildfly.service‘ mit dem vim-Editor.

vim /etc/systemd/system/wildfly.service

Auf der ‚ExecStart=/opt/wildfly/bin/launch.sh…. Zeile fügen Sie die Option ‚$WILDFLY_CONSOLE_BIND‚ wie unten beschrieben hinzu.

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

Speichern und schließen.

Laden Sie nun den Systemmanager neu und starten Sie den wildfly-Dienst neu.

systemctl daemon-reload
systemctl restart wildfly

Der wildfly-Dienst wird mit aktivierter Verwaltungskonsole ausgeführt, überprüfen Sie dies mit dem nachstehenden Befehl.

ss -plnt
systemctl status wildfly

Unten sehen Sie das Ergebnis, das Sie erhalten werden.

Als Ergebnis läuft die WildFly auf der lokalen IP-Adresse ‚127.0.0.1‚ mit dem Standard-TCP-Port ‚8080‚, und die WildFly-Verwaltungskonsole ist auf dem TCP-Port ‚9990‚ aktiviert.

Schritt 5 – Admin-Benutzer WildFly einrichten

In diesem Schritt werden wir einen neuen Benutzer für die Verwaltung von wildfly mit dem von wildfly zur Verfügung gestellten Skript ‚add-user.sh‘ anlegen.

Führen Sie das wildfly-Skript „add-user.sh“ wie unten beschrieben aus.

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

Geben Sie als Benutzertyp ‚a‚ ein, um den Management-Benutzer (admin für die Verwaltung der Wildfliege) anzulegen.

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

Geben Sie nun Ihren Benutzernamen und Ihr Passwort ein, und stellen Sie sicher, dass Sie das sichere Passwort verwenden.

Enter the details of the new user to add.
Using the realm 'ManagementRealm' as discovered from the existing property files.
Username : hakase
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 :

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

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

Als nächstes geben Sie ‚ja‚ ein, um Ihren Benutzer zum ‚ManagementRealm‚ auf wildfly hinzuzufügen.

About to add user 'hakase' for realm 'ManagementRealm'
Is this correct yes/no? yes
Added user 'hakase' to file '/opt/wildfly/standalone/configuration/mgmt-users.properties'
Added user 'hakase' to file '/opt/wildfly/domain/configuration/mgmt-users.properties'
Added user 'hakase' with groups  to file '/opt/wildfly/standalone/configuration/mgmt-groups.properties'
Added user 'hakase' with groups  to file '/opt/wildfly/domain/configuration/mgmt-groups.properties'

Geben Sie ‚ja‚ ein, um Ihren Benutzer als Prozess für die Verwaltung des Master-Slave-Host-Controllers von wildfly zu aktivieren.

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 <secret value="YXNoN2RhNjVzZyMkJQ==" />

Infolgedessen wurde der Admin- und Management-Benutzer für wildfly erstellt.

Schritt 6 – Einrichten von Nginx als Reverse-Proxy für WildFly

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

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

sudo apt install nginx -y

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

cd /etc/nginx/

Erstellen Sie eine neue Datei ‚proxy_headers.conf‘ unter dem Verzeichnis ‚/etc/nginx/conf.d‘ mit dem Editor vim.

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.

Als Nächstes erstellen Sie eine neue Konfiguration des virtuellen Hosts für wildfly unter dem Verzeichnis ‚/etc/nginx/sites-available‘.

vim sites-available/wildfly

Ändern Sie die IP-Adresse mit Ihrer eigenen und fügen Sie die Konfiguration dort 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 virtuellen Host wildfly und überprüfen Sie die Nginx-Konfiguration.

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

Stellen Sie jetzt sicher, dass kein Fehler vorliegt, und starten Sie dann den Nginx-Dienst neu.

systemctl restart nginx

Als Ergebnis ist die Installation und Konfiguration von Nginx, einem Reverse-Proxy für wildfly, abgeschlossen.

Schritt 7 – Testen

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

http://192.168.1.50/

Nun erhalten Sie die Standard-Indexseite von WildFly wie unten dargestellt.

Als Nächstes rufen Sie die WildFly-Verwaltungskonsole über den URL-Pfad ‚/console‘ wie unten beschrieben auf.

http://192.168.1.50/console/

Melden Sie sich mit Ihrem wildfly Admin-Benutzer und Passwort an.

Nun erhalten Sie das Dashboard von wildfly admin wie unten dargestellt.

Infolgedessen wurde die Installation von wildfly mit Nginx Reverse Proxy auf Ubuntu 20.04 Server erfolgreich abgeschlossen.