Share via

Schnellstart: Bereitstellen eines JBoss EAP-Clusters auf virtuellen Azure-Computern mithilfe der Azure-Portal

  • Artikel

In diesem Artikel erfahren Sie, wie Sie mithilfe des Azure-Portal schnell einen JBoss EAP-Cluster auf virtuellen Azure-Computern (VMs) bereitstellen.

In diesem Artikel wird das Azure Marketplace-Angebot für JBoss EAP Cluster verwendet, um Ihre Reise zu Azure-VMs zu beschleunigen. Das Angebot stellt automatisch eine Reihe von Ressourcen einschließlich Azure Red Hat Enterprise Linux (RHEL)-VMs, JBoss EAP-Instanzen auf jedem virtuellen Computer, Red Hat Build von OpenJDK auf jedem virtuellen Computer, einem JBoss EAP-Verwaltungskonsole und optional einer Azure-App Gatewayinstanz zur Auswahl. Um das Angebot anzuzeigen, besuchen Sie das Azure-Portal. Wenn Sie eine manuelle schrittweise Anleitung für die Installation von Red Hat JBoss EAP Cluster auf Azure-VMs bevorzugen, die die vom Angebot aktivierte Automatisierung nicht nutzen, finden Sie unter Lernprogramm: Manuelles Installieren von Red Hat JBoss EAP auf virtuellen Azure-Computern.

Voraussetzungen

  • Wenn Sie kein Azure-Abonnement besitzen, erstellen Sie ein kostenloses Konto, bevor Sie beginnen.
  • Stellen Sie sicher, dass die Azure-Identität, die Sie für die Anmeldung verwenden, im aktuellen Abonnement entweder über die Rolle Mitwirkender oder Besitzer verfügt. Eine Übersicht über Azure-Rollen finden Sie unter Was ist die rollenbasierte Zugriffssteuerung (Azure RBAC)?
  • Stellen Sie sicher, dass Sie über die erforderlichen Red Hat-Lizenzen verfügen. Sie benötigen ein Red Hat-Konto mit RHSM-Berechtigung (Red Hat Subscription Management) für JBoss EAP. Mit dieser Berechtigung kann das Azure-Portal die getestete und zertifizierte JBoss EAP-Version von Red Hat installieren.

    Hinweis

    Wenn Sie keine EAP-Berechtigung haben, können Sie sich über Red Hat Entwicklerabonnements für Einzelpersonen für ein kostenloses Entwicklerabonnement registrieren. Speichern Sie die Kontodetails, die Sie als RHSM-Benutzername und RHSM-Kennwort im nächsten Abschnitt verwenden.

  • Nachdem Sie registriert sind, können Sie die erforderlichen Anmeldeinformationen (Pool-IDs) mithilfe der folgenden Schritte finden. Sie verwenden weiter unten in diesem Artikel die Pool-IDs auch als RHSM-Pool-ID mit EAP-Berechtigung.

    1. Melden Sie sich bei Ihrem Red Hat-Konto an.

    2. Wenn Sie sich zum ersten Mal anmelden, werden Sie aufgefordert, Ihr Profil zu vervollständigen. Stellen Sie sicher, dass Sie als KontotypPersönlich auswählen, wie im folgenden Screenshot gezeigt.

      Screenshot der Seite

    3. Öffnen Sie auf der Registerkarte, auf der Sie angemeldet sind, das Red Hat-Entwicklerabonnement für Einzelpersonen. Über diesen Link gelangen Sie zu allen Abonnements in Ihrem Konto für die entsprechende SKU.

    4. Wählen Sie das erste Abonnement aus der Tabelle Alle erworbenen Abonnements aus.

    5. Kopieren Sie den Wert, und speichern Sie den Wert nach Masterpools aus Pool-IDs.

  • Java JDK, Version 11. In diesem Handbuch empfehlen wir den Red Hat Build von OpenJDK. Stellen Sie sicher, dass die Umgebungsvariable JAVA_HOME in den Shells korrekt festgelegt ist, in denen Sie die Befehle ausführen.
  • Git. Testen Sie mithilfe von git --version, ob git funktioniert. Dieses Lernprogramm wurde mit Version 2.34.1 getestet.
  • Maven. Testen Sie mithilfe von mvn -version, ob mvn funktioniert. Dieses Lernprogramm wurde mit Version 3.8.6 getestet.

Hinweis

Das Azure Marketplace-Angebot, das Sie in diesem Artikel verwenden werden, enthält Unterstützung für Red Hat Satellite für die Lizenzverwaltung. Die Verwendung von Red Hat Satellite liegt außerhalb des Umfangs dieser Schnellstartanleitung. Eine Übersicht über Red Hat Satellite finden Sie unter Red Hat Satellite. Weitere Informationen zum Verschieben Ihrer Red Hat JBoss EAP- und Red Hat Enterprise Linux-Abonnements zu Azure finden Sie im Red Hat Cloud Access-Programm.

Einrichten einer Azure-Datenbank für einen flexiblen PostgreSQL-Server

Die Schritte in diesem Abschnitt leiten Sie zur Bereitstellung eines flexiblen Azure Database for PostgreSQL-Servers, den Sie zum Konfigurieren der Datenbankverbindung verwenden, während Sie einen JBoss EAP-Cluster im nächsten Abschnitt einrichten.

Richten Sie zunächst mithilfe des folgenden Befehls einige Umgebungsvariablen ein.

export RG_NAME=<db-resource-group-name>
export SERVER_NAME=<database-server-name>
export ADMIN_PASSWORD=<postgresql-admin-password>

Ersetzen Sie die Platzhalter durch die folgenden Werte, die im gesamten Artikel verwendet werden:

  • <db-resource-group-name>: Der Name der Ressourcengruppe, die für den flexiblen PostgreSQL-Server verwendet werden soll , ejb040323postgresrgz. B. .
  • <database-server-name>: Der Name Ihres PostgreSQL-Servers, der in Azure eindeutig sein soll , z. B ejb040323postgresqlserver. .
  • <postgresql-admin-password>: Das Kennwort Ihres PostgreSQL-Servers. Dieses Kennwort muss mindestens 8 Zeichen und höchstens 128 Zeichen lang sein. Es muss Zeichen aus drei der folgenden Kategorien enthalten: Englische Großbuchstaben, englische Kleinbuchstaben, Zahlen (0-9) und nicht alphanumerische Zeichen (!, $, #, % usw.).

Führen Sie als Nächstes die folgenden Schritte aus, um einen flexiblen Azure-Server für PostgreSQL zu erstellen:

  1. Verwenden Sie den folgenden Befehl, um eine Azure-Datenbank für Einen flexiblen Server für PostgreSQL zu erstellen:

    az postgres flexible-server create \
    --resource-group ${RG_NAME} \
    --name ${SERVER_NAME} \
    --database-name testdb \
    --public-access 0.0.0.0  \
    --admin-user testuser \
    --admin-password ${ADMIN_PASSWORD} \
    --yes

  2. Verwenden Sie den folgenden Befehl, um den Host des PostgreSQL-Servers abzurufen:

    export DB_HOST=$(az postgres flexible-server show \
    --resource-group ${RG_NAME} \
    --name ${SERVER_NAME} \
    --query "fullyQualifiedDomainName" \
    --output tsv)

  3. Verwenden Sie den folgenden Befehl, um die VERBINDUNGS-URL DES PostgreSQL-Servers abzurufen:

    echo jdbc:postgresql://${DB_HOST}:5432/testdb

    Notieren Sie sich die Ausgabe, die Sie als Datenquelle Verbindungszeichenfolge des PostgreSQL-Servers weiter unten in diesem Artikel verwenden.

Bereitstellen eines JBoss EAP-Clusters auf Azure-VMs

Die Schritte in diesem Abschnitt leiten Sie zur Bereitstellung eines JBoss EAP-Clusters auf Azure-VMs.

Führen Sie die folgenden Schritte aus, um das Angebot des JBoss EAP-Clusters auf Azure-VMs zu finden:

  1. Melden Sie sich beim Azure-Portal an, indem Sie besuchenhttps://aka.ms/publicportal.

  2. Geben Sie in der Suchleiste oben im Azure-Portal JBoss EAP ein. Wählen Sie in den Suchergebnissen im Marketplace-Abschnitt JBoss EAP Cluster auf virtuellen Computern aus.

    Screenshot der Azure-Portal mit JBoss EAP Server auf Azure VM in den Suchergebnissen.

  3. Stellen Sie im Dropdownmenü sicher, dass PAYG ausgewählt ist.

Alternativ können Sie auch direkt zum JBoss EAP Cluster on VMs-Angebot wechseln. In diesem Fall ist der richtige Plan bereits für Sie ausgewählt.

In beiden Fällen stellt dieses Angebot einen JBoss EAP-Cluster auf Azure-VMs bereit, indem Sie Ihr Red Hat-Abonnement zur Bereitstellungszeit bereitstellen. Das Angebot führt den Cluster unter Red Hat Enterprise Linux mit einer Pay-as-you-go-Zahlungskonfiguration für die Basis-VMs aus.

Die folgenden Schritte zeigen, wie Sie den im folgenden Screenshot gezeigten Bereich " Grundlagen" ausfüllen.

Screenshot der Azure-Portal mit dem Bereich

  1. Wählen Sie auf der Angebotsseite Erstellen aus.
  2. Stellen Sie im Bereich Grundlagen sicher, dass der im Feld Abonnement angezeigte Wert dem Wert entspricht, für den die Rollen im Abschnitt mit Voraussetzungen aufgeführt sind.
  3. Sie müssen das Angebot in einer leeren Ressourcengruppe bereitstellen. Wählen Sie im Feld Ressourcengruppe die Option Neu erstellen aus, und geben Sie einen Wert für die Ressourcengruppe ein. Da Ressourcengruppen innerhalb eines Abonnements eindeutig sein müssen, wählen Sie einen eindeutigen Namen aus. Eine einfache Möglichkeit, eindeutige Namen zu haben, besteht darin, eine Kombination aus Ihren Initialen, dem heutigen Datum und einer Kennung zu verwenden. Beispiel: ejb040323jbosseapcluster.
  4. Wählen Sie unter Instanzdetails die Region für die Bereitstellung aus.
  5. Belassen Sie die Standardgröße des virtuellen Computers als Größe des virtuellen Computers.
  6. Belassen Sie die Standardoption OpenJDK 17 als JDK-Version.
  7. Belassen Sie den Standardwert jbossuser als Username.
  8. Belassen Sie das Standardoptionskennwort als Authentifizierungstyp.
  9. Geben Sie ein Kennwort für das Kennwort ein. Verwenden Sie denselben Wert zum Bestätigen des Passworts.
  10. Verwenden Sie 3 für die Anzahl der virtuellen Computer zum Erstellen.
  11. Belassen Sie unter Optional Basic Configuration die Standardoption Ja als Standardeinstellungen für optionale Konfiguration akzeptieren.
  12. Scrollen Sie nach unten im Bereich Grundlagen und beachten Sie die hilfreichen Links für das Melden von Problemen, Abrufen von Hilfe und Teilen von Feedback.
  13. Wählen Sie Weiter: JBoss-EAP-Einstellungen aus.

Die folgenden Schritte zeigen, wie Sie den im folgenden Screenshot gezeigten Bereich des JBoss EAP Einstellungen ausfüllen.

Screenshot der Azure-Portal mit dem Bereich

  1. Lassen Sie die Standardoption "Verwaltete Aufgaben" beibehalten Standard um verwaltete Aufgaben zu verwenden Standard oder eigenständige Hosts, um einen Cluster zu bilden.
  2. Belassen Sie den Standardwert jbossadmin als JBoss EAP Admin-Benutzernamen.
  3. Geben Sie ein JBoss EAP-Kennwort für das EAP-Kennwort von JBoss an. Verwenden Sie denselben Wert zum Bestätigen des Passworts. Speichern Sie den Wert für die spätere Verwendung beiseite.
  4. Lassen Sie die Standardoption Nein für die Verbindung mit einem vorhandenen Red Hat Satellite Server?.
  5. Geben Sie Ihren RHSM-Benutzernamen für RHSM-Benutzernamen an. Der Wert ist identisch mit dem Wert, der im Abschnitt "Voraussetzungen" vorbereitet wurde.
  6. Geben Sie Ihr RHSM-Kennwort für das RHSM-Kennwort an. Verwenden Sie denselben Wert zum Bestätigen des Passworts. Der Wert ist identisch mit dem Wert, der im Abschnitt "Voraussetzungen" vorbereitet wurde.
  7. Geben Sie Ihre RHSM-Pool-ID für RHSM-Pool-ID mit EAP-Berechtigung an. Der Wert ist identisch mit dem Wert, der im Abschnitt "Voraussetzungen" vorbereitet wurde.
  8. Wählen Sie "Weiter" aus: Azure-App lizenzierungsgateway.

Die folgenden Schritte zeigen, wie Sie den bereich Azure-App lizenzierungsgateway ausfüllen, der im folgenden Screenshot gezeigt wird.

Screenshot der Azure-Portal mit dem JBoss EAP-Cluster auf VMs Azure-App lication Gateway-Bereich.

  1. Wählen Sie "Ja" für Verbinden aus, um das Gateway für Azure-App lizenzierung zu Azure-App.

  2. Klicken Sie auf Weiter: Netzwerk aus.

    In diesem Bereich können Sie das virtuelle Netzwerk und das Subnetz anpassen, in dem der JBoss EAP-Cluster bereitgestellt wird. Diese Anpassung ist in Situationen hilfreich, in denen der CIDR-Speicherplatz gesteuert wird. Informationen zu virtuellen Netzwerken finden Sie unter Erstellen, Ändern oder Löschen eines virtuellen Netzwerks. Übernehmen Sie die Standardwerte in diesem Bereich.

  3. Wählen Sie Weiter: Datenbank aus.

Die folgenden Schritte zeigen, wie Sie den im folgenden Screenshot gezeigten Datenbankbereich ausfüllen und die Bereitstellung starten.

Screenshot der Azure-Portal mit dem JBoss EAP-Cluster auf VMs-Datenbankbereich.

  1. Wählen Sie "Ja" für Verbinden in der Datenbank aus.
  2. Wählen Sie PostgreSQL für datenbanktyp auswählen.
  3. Füllen Sie java:jboss/datasources/JavaEECafeDB für JNDI-Namen aus.
  4. Geben Sie die URL der CONNECTION-Verbindung des PostgreSQL-Servers an, den Sie zuvor gespeichert haben, für Datenquellen-Verbindungszeichenfolge (hosts:postgresql://<host>:<port>/<database>).
  5. Füllen Sie den Testbenutzer für den Datenbankbenutzernamen aus.
  6. Geben Sie den Wert für den Platzhalter <postgresql-admin-password>an, den Sie zuvor angegeben haben, für das Datenbankkennwort. Verwenden Sie denselben Wert zum Bestätigen des Passworts.
  7. Klicken Sie auf Überprüfen + erstellen. Stellen Sie sicher, dass im oberen Bereich die grüne Meldung Überprüfung erfolgreich angezeigt wird. Wenn die Nachricht nicht angezeigt wird, beheben Sie alle Überprüfungsprobleme und wählen Sie dann erneut Überprüfen + erstellen aus.
  8. Klicken Sie auf Erstellen.
  9. Verfolgen Sie den Status der Bereitstellung auf der Seite Bereitstellung wird durchgeführt.

Abhängig von den Netzwerkbedingungen und anderen Aktivitäten in der ausgewählten Region kann die Bereitstellung bis zu 35 Minuten dauern. Danach sollte der Text "Ihre Bereitstellung abgeschlossen " auf der Bereitstellungsseite angezeigt werden.

Überprüfen der Funktionsfähigkeit der Bereitstellung

Führen Sie die folgenden Schritte aus, um die Funktionalität der Bereitstellung für einen JBoss EAP-Cluster auf Azure-VMs von der Red Hat JBoss Enterprise Application Platform Verwaltungskonsole zu überprüfen:

  1. Wählen Sie auf der Bereitstellungsseite "Ausgaben" aus.

  2. Wählen Sie das Symbol "Kopieren" neben "adminConsole" aus.

    Screenshot der Azure-Portal mit den Bereitstellungsausgaben mit hervorgehobener adminConsole-URL.

  3. Fügen Sie die URL in einen mit dem Internet verbundenen Webbrowser ein, und drücken Sie die EINGABETASTE. Wie im folgenden Screenshot dargestellt, sollte der vertraute Anmeldebildschirm der Red Hat JBoss Enterprise Application Platform-Verwaltungskonsole angezeigt werden.

    Screenshot des JBoss EAP-Verwaltungskonsole Anmeldebildschirms.

  4. Füllen Sie jbossadmin für JBoss EAP-Administratorbenutzername Aus, geben Sie den Wert für das JBoss EAP-Kennwort an, das Sie vor dem Kennwort angegeben haben, und wählen Sie dann "Anmelden" aus.

  5. Wie im folgenden Screenshot gezeigt, sollte die vertraute Red Hat JBoss Enterprise Application Platform Willkommensseite der Verwaltungskonsole angezeigt werden.

    Screenshot der Willkommensseite der JBoss EAP-Verwaltungskonsole.

  6. Wählen Sie die Registerkarte "Laufzeit" aus. Wählen Sie im Navigationsbereich die Topologie aus. Sie sollten sehen, dass der Cluster einen do Standard Controllermaster und zwei Arbeitsknoten enthält, wie im folgenden Screenshot gezeigt:

    Screenshot der JBoss EAP-Verwaltungskonsole Runtime-Topologie.

  7. Wählen Sie die Registerkarte "Konfiguration" aus. Wählen Sie im Navigationsbereich "Profile>ha>Datasources & Drivers>Datasources" aus. Sie sollten sehen, dass die Datenquelle dataSource-Postgresql aufgeführt ist, wie im folgenden Screenshot gezeigt:

    Screenshot der Registerkarte

Lassen Sie die Verwaltungskonsole geöffnet. Sie verwenden sie zum Bereitstellen einer Beispiel-App im JBoss EAP-Cluster im nächsten Abschnitt.

Bereitstellen der App im JBoss EAP-Cluster

Führen Sie die folgenden Schritte aus, um die Java EE Cafe-Beispielanwendung im Red Hat JBoss EAP-Cluster bereitzustellen:

  1. Führen Sie die folgenden Schritte aus, um das Java EE Cafe-Beispiel zu erstellen. Bei diesen Schritten wird davon ausgegangen, dass Sie eine lokale Umgebung mit Git und Maven installiert haben:

    1. Verwenden Sie den folgenden Befehl, um den Quellcode von GitHub zu klonen und das Tag auszuchecken, das dieser Version des Artikels entspricht:

      git clone https://github.com/Azure/rhel-jboss-templates.git --branch 20230418 --single-branch

      Wenn eine Fehlermeldung mit dem Text You are in 'detached HEAD' stateangezeigt wird, können Sie sie sicher ignorieren.

    2. Verwenden Sie den folgenden Befehl, um den Quellcode zu erstellen:

      mvn clean install --file rhel-jboss-templates/eap-coffee-app/pom.xml

      Mit diesem Befehl wird die Datei rhel-jboss-templates/eap-coffee-app/target/javaee-café.war erstellt. Sie laden diese Datei im nächsten Schritt hoch.

  2. Führen Sie die folgenden Schritte in der Red Hat JBoss Enterprise Application Platform Verwaltungskonsole aus, um das Javaee-café.war in das Inhalts-Repository hochzuladen.

    1. Wählen Sie auf der Registerkarte "Bereitstellungen" des EAP-Verwaltungskonsole "Red Hat JBoss EAP" im Navigationsbereich "Inhalts-Repository" aus.

    2. Wählen Sie "Hinzufügen" und dann "Inhalt hochladen" aus.

      Screenshot der Registerkarte

    3. Verwenden Sie die Browserdateiauswahl, um die Datei javaee-café.war auszuwählen.

    4. Wählen Sie Weiter aus.

    5. Übernehmen Sie die Standardwerte auf dem nächsten Bildschirm, und wählen Sie dann "Fertig stellen" aus.

    6. Wählen Sie " Inhalt anzeigen" aus.

  3. Führen Sie die folgenden Schritte aus, um eine Anwendung für folgendes main-server-groupbereitzustellen:

    1. Wählen Sie im Inhalts-Repository javaee-café.war aus.

    2. Öffnen Sie das Dropdownmenü, und wählen Sie "Bereitstellen" aus.

    3. Wählen Sie Standard-server-gruppe als Servergruppe für die Bereitstellung von javaee-café.war aus.

    4. Wählen Sie Bereitstellen aus, um die Bereitstellung zu starten. Es sollte eine Benachrichtigung wie der folgende Screenshot angezeigt werden:

      Screenshot des Hinweises zur erfolgreichen Bereitstellung.

Sie haben nun die Bereitstellung der Java EE-Anwendung abgeschlossen. Führen Sie die folgenden Schritte aus, um auf die Anwendung zuzugreifen und alle Einstellungen zu überprüfen:

  1. Verwenden Sie den folgenden Befehl, um die öffentliche IP-Adresse des Azure-App lizenzgateways abzurufen. Ersetzen Sie den Platzhalter <resource-group-name> durch den Namen der Ressourcengruppe, in der der JBoss EAP-Cluster bereitgestellt wird.

    az network public-ip show \
    --resource-group <resource-group-name> \
    --name gwip \
    --query '[ipAddress]' \
    --output tsv

  2. Kopieren Sie die Ausgabe, bei der es sich um die öffentliche IP-Adresse des bereitgestellten Azure-App lication Gateways handelt.

  3. Öffnen Sie einen mit dem Internet verbundenen Webbrowser.

  4. Navigieren Sie mit der URL http://<gateway-public-ip-address>/javaee-cafezur Anwendung. Ersetzen Sie den Platzhalter <gateway-public-ip-address> durch die öffentliche IP-Adresse des zuvor kopierten Azure-App lication Gateways.

  5. Versuchen Sie, Kaffee hinzuzufügen und zu entfernen.

Bereinigen von Ressourcen

Zum Vermeiden von Azure-Gebühren sollten Sie nicht benötigte Ressourcen bereinigen. Wenn Sie den auf Azure-VMs bereitgestellten JBoss EAP-Cluster nicht mehr benötigen, heben Sie die Registrierung der JBoss-EAP-Server auf, und entfernen Sie die Azure-Ressourcen.

Führen Sie den folgenden Befehl aus, um die Registrierung der JBoss-EAP-Server und VMs von der Red Hat-Abonnementverwaltung aufzuheben. Ersetzen Sie den Platzhalter <resource-group-name> durch den Namen der Ressourcengruppe, in der der JBoss EAP-Cluster bereitgestellt wird.

# Unregister domain controller
az vm run-command invoke \
    --resource-group <resource-group-name> \
    --name jbosseapVm-adminVM \
    --command-id RunShellScript \
    --scripts "sudo subscription-manager unregister"

# Unregister host controllers
az vm run-command invoke \
    --resource-group <resource-group-name> \
    --name jbosseapVm1 \
    --command-id RunShellScript \
    --scripts "sudo subscription-manager unregister"
az vm run-command invoke \
    --resource-group <resource-group-name> \
    --name jbosseapVm1 \
    --command-id RunShellScript \
    --scripts "sudo subscription-manager unregister"

Führen Sie die folgenden Befehle aus, um die beiden Ressourcengruppen zu entfernen, in denen der JBoss EAP-Cluster und die Azure-Datenbank für PostgreSQL flexible Server bereitgestellt werden. Ersetzen Sie den Platzhalter <resource-group-name> durch den Namen der Ressourcengruppe, in der der JBoss EAP-Cluster bereitgestellt wird. Stellen Sie sicher, dass die Umgebungsvariable $RG_NAME mit dem Namen der Ressourcengruppe festgelegt ist, auf der der flexible Server der PostgreSQL bereitgestellt wird.

az group delete --name <resource-group-name> --yes --no-wait
az group delete --name $RG_NAME --yes --no-wait

Nächste Schritte

Weitere Informationen zum Bereitstellen von JBoss EAP in Azure finden Sie unter den folgenden Links:

Red Hat JBoss EAP in Azure