So installieren Sie den WildFly-Anwendungsserver mit Nginx-Proxy auf Debian 12

WildFly, früher JBoss, ist ein kostenloser und Open-Source-Anwendungsserver, der Ihnen hilft, Java-Webanwendungen zu erstellen und bereitzustellen. Er ist in Java geschrieben und entspricht den Java EE (Enterprise Edition) Spezifikationen. WildFly wurde von JBoss entwickelt, wird aber jetzt von RedHat weiterentwickelt. Es ist ein leistungsstarker, produktionsbereiter, modularer und leichter Anwendungsserver, der alle notwendigen Werkzeuge und Funktionen bietet, um Java-Webanwendungen auszuführen und bereitzustellen.

WildFly ist ein plattformübergreifender Anwendungsserver, der Werkzeuge für Java-Anwendungen wie EJBs, JPA, Servlets, JAX-RS, Batch und Sicherheit bereitstellt.

In diesem Leitfaden lernen Sie, wie Sie WildFly oder die JBoss-Anwendungsruntime Schritt für Schritt auf einem Debian 12-Server installieren. Sie installieren WildFly, aktivieren die Administrationskonsole, erstellen einen WildFly-Admin-Benutzer und installieren und konfigurieren Nginx als Reverse-Proxy.

Voraussetzungen

Bevor Sie fortfahren, sammeln Sie Folgendes:

• Einen Debian 12-Server mit 4 GB oder mehr Speicher.
• Einen Nicht-Root-Benutzer mit Sudo-Administratorrechten.

Installation von Java OpenJDK

WildFly ist eine flexible und leichte Java-Anwendungsruntime zum Erstellen von Anwendungen. In diesem Abschnitt installieren und verwenden Sie Java OpenJDK 17, um WildFly auf Ihrem Debian-Server zu installieren.

Zuerst führen Sie den folgenden Befehl aus, um Ihr Debian-Repository zu aktualisieren.

sudo apt update

Jetzt installieren Sie das Java OpenJDK-Paket, indem Sie den folgenden Befehl ausführen. Dies installiert das Paket default-jdk, das dem Java OpenJDK 17 LTS (Long Term Supports) entspricht.

sudo apt install default-jdk

Geben Sie y ein, um mit der Installation fortzufahren.

Nachdem Sie Java installiert haben, überprüfen Sie die Java-Version mit dem folgenden Befehl. Sie sollten sehen, dass Java OpenJDK 17 installiert ist.

java -version

Installation und Konfiguration von WildFly

Nachdem Sie Java OpenJDK installiert haben, können Sie nun mit der Installation von WildFly beginnen, indem Sie die folgenden Aufgaben abschließen:

• Hinzufügen des Benutzers und der Gruppe wildfly
• Herunterladen des WildFly-Binärpakets
• Konfigurieren der WildFly-Installation
• Ausführen von WildFly als Systemd-Dienst

Lassen Sie uns anfangen.

Hinzufügen des Benutzers und der Gruppe wildfly

Zuerst erstellen Sie einen neuen Systembenutzer und eine Gruppe namens wildfly, die verwendet wird, um Ihre WildFly-Installation auszuführen.

Führen Sie den folgenden Befehl aus, um eine neue Gruppe und einen Benutzer namens wildfly hinzuzufügen, indem Sie den folgenden Befehl ausführen. Damit richten Sie auch das Standard-Heimverzeichnis für wildfly-Benutzer auf /opt/wildfly ein, das als Installationsverzeichnis für WildFly verwendet wird.

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

Herunterladen des WildFly-Binärpakets

Nachdem Sie einen systemd-Benutzer hinzugefügt haben, laden Sie das WildFly-Binärpaket über wget herunter. Stellen Sie sicher, dass Sie die WildFly-Downloadseite besuchen, um die neueste Version zu erhalten.

Davor installieren Sie unzip mit dem folgenden apt-Befehl.

sudo apt install unzip -y

Danach besuchen Sie die WildFly-Downloadseite und kopieren den Link zur neuesten Version von WildFly. Laden Sie das WildFly-Binärpaket über den wget-Befehl wie folgt herunter. In diesem Beispiel installieren Sie WildFly 30.0.0.

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

Als nächstes entpacken Sie das WildFly-Binärpaket und verschieben das extrahierte Verzeichnis nach /opt/wildfly.

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

Zuletzt führen Sie den folgenden Befehl aus, um den Besitz des Verzeichnisses /opt/wildfly auf den Benutzer wildfly zu ändern.

sudo chown -RH wildfly: /opt/wildfly

Konfigurieren der WildFly-Installation

In diesem Beispiel installieren Sie WildFly auf einer einzelnen Maschine im Standalone-Modus. Daher beziehen sich alle Konfigurationen, die Sie hier ändern, auf die Standalone-Konfigurationen von WildFly.

Starten Sie den folgenden nano-Editor-Befehl, um die Datei /opt/wildfly/bin/standalone.conf zu öffnen.

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

Ändern Sie den Wert Xmx512m innerhalb der Umgebungsvariable JBOSS_JAVA_SIZING, um die standardmäßige maximale Heap-Speichergröße von WildFly zu erhöhen, wie folgt.

Stellen Sie sicher, dass Sie die maximale Heap-Speichergröße an Ihren aktuellen Server anpassen. Das folgende Beispiel setzt die maximale Heap-Speichergröße auf 4GB.

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

Speichern Sie die Datei und beenden Sie den Editor, wenn Sie fertig sind.

Erstellen Sie nun ein neues Konfigurationsverzeichnis /etc/wildfly mit dem folgenden Befehl.

sudo mkdir -p /etc/wildfly

Kopieren Sie die WildFly-Konfigurationsdatei nach /etc/wildfly/wildfly.conf und öffnen Sie sie mit dem folgenden nano-Editor-Befehl.

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

Ändern Sie den Standardwert WILDFLY_BIND auf 127.0.0.1 und fügen Sie eine Variable WILDFLY_CONSOLE_BIND hinzu, um die WildFly-Administrationskonsole zu aktivieren. Sowohl WildFly als auch die Administrationskonsole werden auf localhost ausgeführt.

# Die Adresse, an die gebunden werden soll  
WILDFLY_BIND=127.0.0.1  
  
# Admin aktivieren  
WILDFLY_CONSOLE_BIND=127.0.0.1

Wenn Sie fertig sind, speichern Sie die Datei und beenden Sie den Editor.

Kopieren Sie als Nächstes das WildFly-Startskript nach /opt/wildfly/bin/launch.sh und machen Sie es mit dem chmod-Befehl unten ausführbar.

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

Öffnen Sie das WildFly-Startskript /opt/wildfly/bin/launch.sh mit dem folgenden nano-Editor-Befehl.

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

Fügen Sie die neue Befehlsoption ‘-bmanagement $4‘ hinzu, um die WildFly-Administrationskonsole zu aktivieren, wie folgt.

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 Sie die Datei und schließen Sie den Editor, wenn Sie fertig sind.

Zuletzt führen Sie den folgenden Befehl aus, um das Verzeichnis der WildFly-Installation /opt/wildfly auf den Benutzer wildfly zu ändern.

sudo chown -RH wildfly: /opt/wildfly

Ausführen von WildFly als Systemd-Dienst

Nachdem Sie WildFly im Standalone-Modus konfiguriert haben, richten Sie eine systemd-Dienstdatei für WildFly ein. Dadurch können Sie WildFly im Hintergrund ausführen und WildFly einfach über das Systemctl-Dienstprogramm verwalten.

Kopieren Sie die WildFly-Systemd-Dienstdatei nach /etc/systemd/system/wildfly.service und ändern Sie sie mit dem folgenden nano-Editor-Befehl.

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

Innerhalb der ExecStart-Option fügen Sie einen neuen Startparameter $WILDFLY_CONSOLE_BIND hinzu, um die WildFly-Administrationskonsole zu aktivieren.

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

Wenn Sie fertig sind, speichern Sie die Datei und beenden Sie den Editor.

Führen Sie als Nächstes den folgenden systemctl-Befehl aus, um den systemd-Manager neu zu laden.

sudo systemctl daemon-reload

Starten Sie dann den WildFly-Dienst und aktivieren Sie ihn mit dem folgenden Befehl.

sudo systemctl start wildfly  
sudo systemctl enable wildfly

Überprüfen Sie den WildFly-Dienst, um sicherzustellen, dass der Dienst läuft, indem Sie den folgenden Befehl ausführen.

sudo systemctl status wildfly

Wenn der WildFly-Dienst läuft, wird die folgende Ausgabe angezeigt.

Sie können auch die Liste der offenen Ports auf Ihrem System überprüfen, indem Sie den folgenden Befehl ausführen.

ss -antpl | grep -i java

Sie sollten mehrere Ports 8080, 8443 und 9990 sehen, die WildFly verwendet.

Hinzufügen der WildFly-Benutzerverwaltung

Nachdem Sie WildFly installiert haben, erstellen Sie einen neuen Admin-Benutzer für WildFly über das Skript /opt/wildfly/bin/add-user.sh.

Führen Sie das Skript /opt/wildfly/bin/add-user.sh wie folgt aus.

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

Jetzt werden Sie mit Folgendem gefragt:

• Geben Sie a ein, um einen neuen WildFly-Managementbenutzer zu erstellen.
• Geben Sie Ihren Admin-Benutzernamen und Ihr Passwort ein und wiederholen Sie es.
• Drücken Sie ENTER, wenn Sie nach der Gruppenkonfiguration gefragt werden.
• Geben Sie ja ein, um Ihren Benutzer zum ManagementRealm hinzuzufügen.

Sobald der Vorgang abgeschlossen ist, sollten Sie sehen, dass Ihr neuer Benutzer zur WildFly-Konfiguration hinzugefügt wurde.

Einrichten von Nginx als Reverse-Proxy

An diesem Punkt haben Sie die WildFly-Installation abgeschlossen, die Administrationskonsole aktiviert und den Admin-Benutzer erstellt. Der nächste Schritt besteht darin, Nginx zu installieren und es als Reverse-Proxy für WildFly zu konfigurieren.

Führen Sie den folgenden apt-Befehl aus, um Nginx auf Ihrem Debian-Server zu installieren. Geben Sie y ein, um mit der Installation fortzufahren.

sudo apt install nginx

Sobald Nginx installiert ist, konfigurieren Sie es als Reverse-Proxy für WildFly.

Erstellen Sie eine neue Nginx-Proxy-Header-Konfiguration /etc/nginx/conf.d/proxy_headers.conf mit dem folgenden nano-Editor-Befehl.

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

Fügen Sie die folgende Konfiguration in die Datei 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 Sie die Datei und beenden Sie den Editor, wenn Sie fertig sind.

Starten Sie als Nächstes den folgenden nano-Editor-Befehl, um eine neue Nginx-Serverblockkonfiguration /etc/nginx/sites-available/wildfly zu erstellen.

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

Fügen Sie die folgende Konfiguration ein, um Nginx als Reverse-Proxy für Ihre WildFly-Installation einzurichten. Stellen Sie sicher, dass Sie die Domain innerhalb der server_name-Option ändern; Sie können einen lokalen Domainnamen verwenden.

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

Speichern Sie die Datei und schließen Sie den Editor, wenn Sie fertig sind.

Führen Sie nun den folgenden Befehl aus, um die virtuelle Host-Datei wildfly zu aktivieren und Ihre Nginx-Syntax zu überprüfen.

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

Wenn Sie eine korrekte Nginx-Syntax haben, wird die Ausgabe “Syntax ist ok—Test erfolgreich“ angezeigt.

Zuletzt führen Sie den folgenden Befehl aus, um den Nginx-Dienst neu zu starten und die Änderungen anzuwenden, die Sie vorgenommen haben. Überprüfen Sie dann den Nginx-Dienst, um sicherzustellen, dass der Dienst läuft.

sudo systemctl restart nginx  
sudo systemctl status nginx

Wenn Nginx läuft, sollten Sie die Ausgabe aktiv (laufend) erhalten.

Zugriff auf WildFly über den Client

Öffnen Sie auf Ihrem Client-Computer die Hosts-Datei mit Ihrem Texteditor. Für Windows-Benutzer öffnen Sie die Datei C:\Windows\System32\drivers\etc\hosts als Administrator, während Linux- oder macOS-Benutzer die /etc/hosts-Datei mit Sudo-Rechten öffnen.

Fügen Sie die folgende Konfiguration ein und stellen Sie sicher, dass Sie den lokalen Domainnamen und die IP-Adresse mit Ihren Informationen ändern.

192.168.5.15  wildfly.howtoforge.local

Speichern Sie die Datei und schließen Sie den Editor, wenn Sie fertig sind.

Starten Sie Ihren Webbrowser und besuchen Sie Ihre lokale WildFly-Domain (z. B.: http:wildfly.howtoforge.local/). Wenn Ihre Installation erfolgreich war, sollten Sie die Standard-WildFly-Indexseite sehen, die wie folgt aussieht:

Klicken Sie nun auf den Link Administrationskonsole, um auf die WildFly-Administrationskonsole zuzugreifen. Dies öffnet einen neuen Tab, und Sie werden zur WildFly-Administrationskonsole mit dem URL-Pfad /console weitergeleitet.

Geben Sie Ihren Admin-Benutzernamen und Ihr Passwort für die WildFly-Administrationskonsole ein und klicken Sie auf Anmelden.

Wenn Sie den richtigen Benutzer und das richtige Passwort haben, sollten Sie die WildFly-Administrationskonsole wie folgt sehen.

Klicken Sie als Nächstes auf das Menü Runtime und wählen Sie Ihren Server aus. Sie sollten die Bestätigung sehen, dass WildFly läuft.

Wählen Sie zuletzt das Menü Status aus, und Sie sollten den detaillierten Status Ihrer WildFly-Installation sehen, einschließlich der Heap-Konfiguration, die auf 4 GB geändert wurde.

Fazit

Zusammenfassend haben Sie nun die Installation von WildFly auf Debian 12 Schritt für Schritt abgeschlossen. Sie haben WildFly installiert, die Administrationskonsole aktiviert und einen WildFly-Admin-Benutzer erstellt. Darüber hinaus haben Sie Nginx als Reverse-Proxy für WildFly konfiguriert. Von nun an können Sie Ihre JBoss-Anwendungen mit der WildFly-Anwendungsruntime bereitstellen und ausführen.