Wie Sie Ihre Anwendungen auf Red Hat OpenShift bereitstellen 4.x

Online bearbeiten

Im Folgenden wird beschrieben, wie Sie mit den Transformation Advisor migrationsartefakte verwendet werden, um Ihre Anwendungen in einem Liberty-Container und in einem OpenShift -Cluster bereitzustellen.

Sie können

  • Stellen Sie eine einzelne Anwendung in einem Liberty-Container bereit.

  • Stellen Sie mehrere Anwendungen aus einem Cluster oder einer Gruppe in einem Liberty-Container bereit.

Einzelne Anwendung implementieren

In diesem Abschnitt wird erläutert, wie eine einzelne Java-Anwendung unter Verwendung von Migrationsartefakten auf Liberty und OpenShift bereitgestellt werden kann.

Ein binäres Projekt

Im folgenden Abschnitt wird beschrieben, wie ein binärbasiertes Projekt in Red Hat™ OpenShiftimplementiert wird. Für das binäre Projekt werden Sie Binärdateien für die Anwendung und alle Abhängigkeiten bereitstellen.

Sie können Ihre Anwendung in drei Schritten migrieren. In diesem Dokument wird auf die folgenden Variablen verwiesen:

  • <BINARY_FILE_LOCATION> ist die Position der Binärdateien für Ihre Anwendung, einschließlich aller Abhängigkeiten und gemeinsam genutzten Bibliotheksdateien.

  • <APPLICATION_FILE> ist die Binärdatei für Ihre Anwendung.

  • <DEPENDENCY_FILE_LOCATION> ist die Position aller Abhängigkeiten und gemeinsam genutzten Bibliotheksdateien, die Ihre Anwendung erfordert.

  • <APP_CONTEXT_ROOT> ist das Kontextstammverzeichnis für Ihre Anwendung. Wenn nicht anderweitig definiert, z. B. in ibm-web-ext-xml, entspricht dies dem Attribut name im Element application der Datei server.xml .

  • <APPLICATION_NAME> ist der Name der Anwendung.

  • <CONTAINER_ID> ist die Container-ID für Ihr Docker-Image. Geben Sie "docker ps" ein, um diesen Wert abzurufen.

  • <IMAGE_REFERENCE> ist die Referenz für dieses Image, einschließlich Registry, Repository und Tag, z. B. docker.io/myspace/myappimage:1.0.0

  • <LIBERTY_HOME> ist die Position, an der Sie Liberty installiert haben.

  • <LIBERTY_MACHINE> ist die Maschine, auf der Sie das Liberty-Profil installiert haben.

  • <MIGRATION_ARTIFACTS_HOME> ist der Ort, an dem Sie die Artefakte entpackt Transformation Advisor artefakte entpackt oder das Repository geklont haben.

  • <OCP_PROJECT> ist der Name des OpenShift -Projekts, in dem Sie die Anwendung installieren wollen.

SCHRITT 1: Java-Anwendung auf Liberty migrieren

In diesem Schritt migrieren Sie Ihre Anwendung auf einen lokalen Liberty-Server. Auf diese Weise können Sie überprüfen, ob Ihre Anwendung auf Liberty ordnungsgemäß funktioniert, und gegebenenfalls Änderungen an der Konfiguration vornehmen. Nachdem Sie anhand eines Tests festgestellt haben, dass Ihre Anwendung in Liberty funktioniert, können Sie einen Liberty-Container für Ihre Anwendung erstellen.

Schritt 1 Voraussetzungen

  • Eine Liberty-Installation

    • Sie können WebSphere Liberty hier erhalten.

    Hinweis: Wenn Ihre Anwendung Java EE 6 Funktionen erfordert, benötigen Sie Websphere Liberty.

    • Sie können Open Liberty hier erhalten.

  • Eine Kopie der Migrationsartefakte, die Sie von Transformation Advisor auf dem Rechner, auf dem Sie Liberty installiert haben.

Schritt 1 Aufgaben

  1. Fügen Sie Ihre Anwendungsdatei zum Migrationspaket hinzu und entfernen Sie die Platzhalterdatei:

    cp <BINARY_FILE_LOCATION>/<APPLICATION_FILE> <MIGRATION_ARTIFACTS_HOME>/target/
rm <MIGRATION_ARTIFACTS_HOME>/target/*.placeholder

  2. Fügen Sie Ihre Abhängigkeitsdatei(en) dem Migrationspaket hinzu und entfernen Sie die Platzhalterdatei(en):

    cp <DEPENDENCY_FILE_LOCATION>/* <MIGRATION_ARTIFACTS_HOME>/src/main/liberty/lib
rm <MIGRATION_ARTIFACTS_HOME>/src/main/liberty/lib/*.placeholder
    Hinweis: Die Platzhalterdateien enthalten den/die Namen aller Abhängigkeiten für Ihre Anwendung.

  3. Erstellen Sie einen Server in der Liberty-Installation, damit Ihre Anwendung ausgeführt werden kann:

    cd <LIBERTY_HOME>/bin
./server create server1

  4. Wechseln Sie zu der Position Ihrer Migrationsartefakte und kopieren Sie die Binärdatei für die Anwendung (.ear/.war) aus dem Zielverzeichnis in das Verzeichnis 'Apps' von Liberty:

    cd <MIGRATION_ARTIFACTS_HOME>
cp target/*.war <LIBERTY_HOME>/usr/servers/server1/apps
  5. Wenn es noch nicht existiert, erstellen Sie das Verzeichnis.
    <LIBERTY_HOME>/usr/shared/config/lib/global
    Kopieren Sie alle zusätzlichen Binärdateien vom Migrationsort an diesen Ort:
    mkdir -p <LIBERTY_HOME>/usr/shared/config/lib/global
cp src/main/liberty/lib/* <LIBERTY_HOME>/usr/shared/config/lib/global

  6. Aktualisieren Sie den " server.xml, falls erforderlich:

    • Wenn Transformation Advisor die Datei server.xml für das Migrations-Bundle erstellt, werden sensible Daten als Variablen am Ende der Datei server.xml mit leeren Standardwerten extrahiert. Stellen Sie sicher, dass die Standardwerte der Variablen ordnungsgemäß festgelegt sind.

    • Sind in dieser Datei zusätzliche Binärdateien aufgelistet, die Sie nicht benötigen, entfernen Sie alle Verweise auf diese Dateien.

    Hinweis: Setzen Sie nur Standardwerte für die in der Datei server.xml definierten Variablen. Wenn der Wert in der Datei server.xml festgelegt ist, kann er während der Bereitstellung nicht überschrieben werden.

  7. Kopieren Sie den erzeugten " server.xml an die Stelle des standardmäßigen " server.xml:

    cp src/main/liberty/config/server.xml <LIBERTY_HOME>/usr/servers/server1/server.xml

  8. Starten Sie den Liberty-Server:

    <LIBERTY_HOME>/bin/server start server1

  9. Überprüfen Sie die Liberty-Protokolle, um sicherzustellen, dass Ihre Anwendung ordnungsgemäß gestartet wurde, und um die URL für den Zugriff zu ermitteln:

    cd <LIBERTY_HOME>/usr/servers/server1/logs
vi messages.log
    Hinweis: Möglicherweise haben Sie in server.xml Funktionen definiert, die in Liberty nicht standardmäßig installiert sind. Diese werden im Protokoll aufgeführt. In diesem Fall installieren Sie die erforderlichen Funktionen mit bin/featureUtility.

    Wenn Sie ein dataSource Element in der server.xml definieren, kann ein ähnliches Authentifizierungsproblem auftreten:

    invalid username/password; logon denied

    Wenn dieses Problem auftritt, müssen Sie möglicherweise den Standardwert für die in Ihren Datenquelleneigenschaften verwendeten Authentifizierungsdatenvariablen aktualisieren.

  10. Überprüfen Sie, ob die Protokolle eine Zeile ähnlich dieser enthalten:

    • Der TCP-Kanal defaultHttpEndpoint wurde gestartet und wartet nun auf Anfragen an Host * ( IPv6 ) Port 9080.

    • Wenn Sie dies nicht sehen, ist ein Problem beim Starten des Servers oder der Anwendung aufgetreten. Durchsuchen Sie die Protokolldatei nach weiteren Details und führen Sie ein entsprechendes Debugging durch.

  11. Öffnen Sie Ihre Bewerbung im Browser, indem Sie den folgenden Link aufrufen:

    http://<LIBERTY_HOME_MACHINE_IP>:9080/<APP_CONTEXT_ROOT>
    Hinweis: Die Migrationsartefakte unterstützen Sie bei der Migration Ihrer Anwendung. Je nach Art und Komplexität Ihrer Anwendung kann eine zusätzliche Konfiguration erforderlich sein, um diese Task vollständig ausführen zu können. So kann es beispielsweise erforderlich sein, zusätzliche Konfigurationen vorzunehmen, um Ihre Anwendung mit einer Benutzerregistrierung zu verbinden oder um Sicherheitsrollenbindungen für Benutzer zu konfigurieren. Weitere Informationen finden Sie in der Produktdokumentation.

SCHRITT 2: Liberty containerisieren

In diesem Schritt containerisieren Sie Ihre funktionierende Liberty-Installation. Sie werden ein Liberty-Image erstellen, auf dem Ihre migrierte Anwendung installiert ist und funktioniert, und anschließend das Image testen, um zu bestätigen, dass es ordnungsgemäß funktioniert.

Hinweis: Wenn Sie podman anstelle von docker verwenden, ersetzen Sie einfach das Wort docker in jedem Befehl durch podman.

Schritt 2 Voraussetzungen

Schritt 2 Aufgaben

  1. Stoppen Sie den Liberty-Server, sofern er aktiv ist, um sicherzustellen, dass die erforderlichen Ports verfügbar sind:

    <LIBERTY_HOME>/bin/server stop server1

  2. Wenn Sie Docker verwenden, stellen Sie sicher, dass der Docker-Service aktiv ist. Wenn nicht, starten Sie ihn:

    service docker start

  3. Gehen Sie zu dem Ort, an dem sich Ihre Migrationsartefakte befinden, und erstellen Sie Ihr Image aus der Dockerdatei:

    cd <MIGRATION_ARTIFACTS_HOME>
docker build --no-cache -t "<IMAGE_REFERENCE>" -f Containerfile .

    Das Migrationspaket enthält eine pom.xml Datei, mit der die Anwendung und alle Abhängigkeiten von Maven gezogen werden können. Sie müssen diese Option in Containerfile aktivieren und die Platzhalter in der Datei pom.xml mit den richtigen Werten aktualisieren.

    Hinweis: Die Details zu dieser Vorgehensweise finden Sie im Abschnitt Abhängigkeiten mit Maven hinzufügen.

  4. Führen Sie das Image aus und stellen Sie sicher, dass es ordnungsgemäß funktioniert:

    docker run -p 9080:9080 <IMAGE_REFERENCE>

  5. Wenn alles gut aussieht, wurde das Image gestartet und dem Port 9080 zugeordnet. Sie können sie über diesen Link in Ihrem Browser aufrufen:

    http://<LIBERTY_HOME_MACHINE_IP>:9080/<APP_CONTEXT_ROOT>

    Optional : Überprüfen Sie Ihr Image, sobald es läuft, indem Sie sich in den Container einloggen:

    docker exec -ti <CONTAINER_ID> bash

    Auf diese Weise können Sie das Dateisystem des Containers durchsuchen, in dem Ihre Anwendung ausgeführt wird.

SCHRITT 3: Image in Red Hat OpenShift bereitstellen

In diesem Schritt implementieren Sie das erstellte Image in Red Hat OpenShift. Diese Anweisungen beziehen sich auf OpenShift 4 + und wurden in OpenShift 4.12validiert.

Schritt 3 Voraussetzungen

  • Zugriff auf eine öffentliche oder private Red Hat OpenShift-Umgebung mit Version 4+.

  • Zugriff auf die Image-Registry

    • Sie müssen das Image Ihrer migrierten Anwendung per Push-Operation an eine Position übertragen, auf die der OpenShift-Cluster zugreifen kann. Sie können eine öffentlich zugängliche Registry (z.B. Dockerhub) oder Ihre eigene private Registry verwenden. Die Migrationsartefakte, die von Transformation Advisor erzeugten Migrationsartefakte (insbesondere die Datei application-cr.yaml ) müssen mit der von Ihnen verwendeten Bildreferenz aktualisiert werden. Wenn Sie keine geeignete Registrierung zur Verfügung haben, können Sie in Dockerhub oder Podman eine eigene Registrierung erstellen, die Sie verwenden können, bis eine geeignete Registrierung gefunden ist.

      • Wie Sie Ihre eigene Registry in Dockerhub erstellen können, erfahren Sie hier

      • Wie Sie Ihre eigene Registrierung in Podman erstellen können, erfahren Sie hier

  • Eine Kopie der Migrationsartefakte, die Sie von Transformation Advisor auf dem Rechner, auf dem Sie Liberty installiert haben.

  • WebSphere Liberty Operator oder Open Liberty Operator

    • Damit Sie Ihre Anwendung auf " WebSphere Liberty auf " OpenShift, einsetzen können, müssen Sie zunächst den Operator " WebSphere Liberty auf Ihrem Cluster installiert haben.

      • WebSphere Liberty Operator ist im IBM Operatorkatalog verfügbar. Zu den Operatoren wechseln ...OperatorHub -Benutzerschnittstelle und klicken Sie auf IBM Operator Catalog Source. Sie können die Suche verwenden, um den Operator WebSphere Liberty schnell zu finden.

      • Klicken Sie auf die Operatorbenutzerschnittstelle von WebSphere Liberty und befolgen Sie die Installationsanweisungen.

      • Sie haben die Möglichkeit, den Operator clusterweit zu installieren, der in der Lage ist, WebSphere Liberty -Anwendungen in allen Namensbereichen zu installieren, oder Sie können den Operator in einem bestimmten Namensbereich installieren. Wählen Sie je nach Vorgabe eine der beiden Optionen aus.

      • Ausführliche Informationen über den Operator WebSphere Liberty finden Sie in der Dokumentation hier.

      • Einzelheiten zur Installation des IBM Operator Catalog finden Sie in der Dokumentation hier.

    • Um Unterstützung für Ihre Anwendung zu erhalten, die auf Open Liberty auf OpenShift, bereitgestellt wird, müssen Sie die Pods mit WebSphere Produktannotationen versehen. Weitere Informationen finden Sie unter Tracking Liberty-Lizenznutzung in Kubernetes

    • Für die Bereitstellung von Open Liberty benötigen Sie den Betreiber von Open Liberty, der die Bereitstellung vornimmt.

      • Sie müssen zuerst den Operator Open Liberty in Ihrem Cluster installiert haben.

      • Der Operator Open Liberty ist im zertifizierten Katalog verfügbar. Zu den Operatoren wechseln ...OperatorHub -Benutzerschnittstelle und klicken Sie auf Zertifiziert Source. Mithilfe der Suchfunktion können Sie den Open Liberty-Operator rasch finden.

      • Klicken Sie auf die Benutzerschnittstelle für den Open Liberty-Operator und führen Sie die Installation gemäß den Anweisungen durch.

      • Sie haben die Möglichkeit, den Operator clusterweit zu installieren, wodurch Open Liberty-Anwendungen übergreifend in allen Namensbereich installiert werden können, ODER Sie können den Operator optional in einem bestimmten Namensbereich installieren. Wählen Sie je nach Vorgabe eine der beiden Optionen aus.

      • Ausführliche Informationen über den Operator Open Liberty finden Sie in der Dokumentation hier.

Schritt 3 Aufgaben

  1. Übertragen Sie das Anwendungsimage per Push-Operation an eine Registry, auf die der OpenShift-Cluster zugreifen kann. Beispiel:

    docker push <IMAGE_REFERENCE>

    wobei <IMAGE_REFERENCE> die Bildreferenz ist, mit der Sie das Bild bei der Erstellung gekennzeichnet haben, z. B. docker.io/myspace/myappimage:1.0.0.

    Hinweis: Möglicherweise müssen Sie sich bei dieser Bildregistrierung anmelden, um den Push-Vorgang erfolgreich durchführen zu können. Wenn Ihre Registry authentifizierte Pull-Operationen erfordert, müssen Sie Ihren Cluster mit einem geheimen Schlüssel für Pull-Operationen einrichten. Weitere Informationen finden Sie in der Dokumentation OpenShift.

  2. Melden Sie sich beim OpenShift-Cluster an und erstellen Sie ein neues Projekt in OpenShift.

    oc login -u <USER_NAME>

    Wenn Sie beim Installieren des Liberty-Operators noch keinen Namensbereich erstellt haben, erstellen Sie jetzt einen.

    oc new-project <OCP_PROJECT>

  3. Stellen Sie Ihr Image mit dem zugehörigen Operator bereit. Gehen Sie dazu gemäß den folgenden Anweisungen vor:

    1. Wechseln Sie in das Verzeichnis kustomize unter <MIGRATION_ARTIFACTS_HOME>:

      cd <MIGRATION_ARTIFACTS_HOME>/deploy/kustomize
    2. Aktualisieren Sie die IMAGE_REFERENCE in der Datei base/application-cr.yaml so, dass sie mit der Referenz auf das Anwendungsbild übereinstimmt, die Sie in Aufgabe 1 hinzugefügt haben.
    3. Prüfen Sie, ob die in der Datei base/<APPLICATION_NAME>-configmap.yaml definierten Werte alle korrekt sind.
    4. Aktualisieren Sie die Datei overlays/dev/<APPLICATION_NAME>-secret.yaml , um den Wert für die sensiblen Daten hinzuzufügen. Der Wert muss base64 kodiert sein. Sie können den Befehl echo -n 'your-secret-password' | base64 aufrufen, um die verschlüsselte Zeichenfolge für Ihre sensiblen Daten zu erhalten.
    5. Erstellen Sie die benutzerdefinierte Ressource (CR) für Ihre Liberty-Anwendung mit dem Befehl apply -k , um ein Verzeichnis mit kustomization.yaml anzugeben:
      oc apply -k overlays/dev
    6. Sie können den Status Ihrer Implementierung durch Ausführung von oc get deployments anzeigen. Wenn Sie den Status nach ein paar Minuten nicht sehen, fragen Sie die Pods ab und holen Sie dann die Liberty-Pod-Protokolle:
      oc get pods
oc logs <pod>
    7. Sie können nun auf Ihre Anwendung zugreifen, indem Sie in OpenShift zur Benutzeroberfläche Networking...Routes navigieren und den Namespace auswählen, in dem Sie die Anwendung bereitgestellt haben.
  4. Optional : Wenn Sie Ihre Anwendung von OpenShift, löschen möchten, können Sie sie über die Benutzeroberfläche OpenShift deinstallieren. Navigieren Sie zu Operators...Installed operators in OpenShift, um den Liberty-Operator zu finden. Klicken Sie auf die Registerkarte All instances , um Ihre Anwendungsinstanz zu finden, und deinstallieren Sie sie bei Bedarf.

Abhängigkeiten mit Maven hinzufügen

Übersicht

Das Migrationspaket enthält eine pom.xml Datei, mit der die Anwendung und alle Abhängigkeiten von Maven gezogen werden können. Sie müssen diese Option in Containerfile aktivieren und die Platzhalter in der Datei pom.xml mit den richtigen Werten aktualisieren.

-Tasks

  1. Zum Migrationspaket navigieren

    cd <MIGRATION_ARTIFACTS_HOME>

  2. Bearbeiten Sie die Datei pom.xml und aktualisieren Sie die Platzhalterwerte mit den entsprechenden Werten:

    • Legen Sie die korrekten Werte für das Element <dependency> fest

    • Stellen Sie die richtigen Werte für jedes der <artifactItem> Elemente ein

  3. Bearbeiten Sie die Containerfile so, dass die Abhängigkeiten während der Erstellung des Images berücksichtigt werden.

    • Entfernen Sie das Kommentarzeichen aus der Zeile RUN mvn -X initialize process-resources verify .

Quellenprojekt

Übersicht

Wenn Sie eine Anwendung migrieren, müssen Sie häufig Änderungen am Quellcode vornehmen, um eine erfolgreiche Migration auf die neue Zielplattform sicherzustellen. Die genaue Art der Änderungen variiert von Anwendung zu Anwendung. Transformation Advisor berichtet über die Änderungen, die für jede einzelne Anwendung erforderlich sind, und stuft Anwendungen, die Codeänderungen erfordern, als moderat oder komplex ein. Um genau festzustellen, wo diese Änderungen im Code vorgenommen werden müssen, können Sie das Plugin WebSphere Application Migration Toolkit (WAMT) Eclipse verwenden. Das Tool kann auch mögliche Korrekturen vorschlagen. Unter diesem Link finden Sie weitere Einzelheiten: https://developer.ibm.com/wasdev/downloads/#asset/tools-WebSphere_Application_Server_Migration_Toolkit.

Die folgenden Tasks helfen beim Erstellen des Quellcodes für ein Image.

-Tasks

  1. Zum Migrationspaket navigieren

    cd <MIGRATION_ARTIFACTS_HOME>

  2. Bearbeiten Sie die Datei pom.xml und aktualisieren oder löschen Sie die Platzhalterwerte mit den entsprechenden Werten:

    • Legen Sie die korrekten Werte für das Element <dependency> fest

    • Stellen Sie die richtigen Werte für jedes der <artifactItem> Elemente ein

  3. Aktualisieren Sie die Datei pom.xml , um die Anwendung nach Ihren Vorgaben zu erstellen

    • Wenn Sie bereits eine pom.xml für Ihre Anwendung haben, können Sie diese verwenden oder mit dem Migrationspaket pom.xml zusammenführen, je nach Bedarf.

  4. Bearbeiten Sie die Containerfile so, dass der Quellcode während der Erstellung des Images erstellt wird.

    • Entfernen Sie das Kommentarzeichen aus der Zeile RUN mvn clean package .

Bereitstellung eines Clusters oder einer Gruppe von Anwendungen

In diesem Abschnitt wird beschrieben, wie Sie das Migrationspaket für ein Cluster oder eine Gruppe verwenden, um mehrere Anwendungen in einem einzelnen Liberty-Container bereitzustellen. Sie können jede Anwendung zunächst einzeln migrieren und sie dann in einer einzigen Bereitstellung zusammenführen oder sie in einem ersten Schritt alle auf einmal bereitstellen.

Wenn Sie einen Cluster migrieren, ist es unwahrscheinlich, dass eine Kollision zwischen den Komponenten Ihrer Anwendungen auftritt. In diesem Fall ist der Ansatz "Alle Anwendungen auf einmal" der schnellste Ansatz für die Migration Ihres Clusters.

Wenn Sie eine Gruppe migrieren, ist es wahrscheinlicher, dass bei der gemeinsamen Implementierung der Anwendungen eine Featurekollision auftritt, da die Anwendungen zuvor möglicherweise nicht zusammen ausgeführt wurden. Es wird empfohlen, den Ansatz "Alle Anwendungen auf einmal" zu wählen, aber wenn Sie auf Probleme stoßen, empfiehlt es sich, den Ansatz " Anwendung für Anwendung " zu wählen, um diese zu lösen.

Alle Anwendungen auf einmal

Sie können alle Anwendungen in drei Schritten migrieren. In diesem Dokument wird auf die folgenden Variablen verwiesen:

  • <APP_CONTEXT_ROOT> ist das Kontextstammverzeichnis für Ihre Anwendung. Wenn nicht anderweitig definiert, z. B. in ibm-web-ext-xml, entspricht dies dem Attribut name im Element <application> der Datei server.xml .
  • <APPLICATION_NAME> ist der Name der Anwendung.
  • <MIGRATION_ARTIFACTS_HOME> ist der Ort, an dem Sie die Artefakte entpackt Transformation Advisor artefakte entpackt oder das Repository geklont haben.
  • <IMAGE_REFERENCE> ist die Referenz für dieses Bild, einschließlich der Registrierung, des Repository und des Tags, z. B. docker.io/myspace/myappimage:1.0.0.

SCHRITT 1: Anwendungen und Abhängigkeitsdateien zusammenstellen und Konfiguration aktualisieren

In diesem Schritt stellen Sie Ihre Anwendungsdateien und alle Abhängigkeiten zusammen und aktualisieren die Konfigurationsdateien.

Schritt 1 Aufgaben

  1. Fügen Sie Ihre Anwendungsdatei (en) zum Migrationsbundle hinzu und entfernen Sie die Platzhalterdateien:

    cp <BINARY_FILE_LOCATION>/<APPLICATION_FILE> <MIGRATION_ARTIFACTS_HOME>/target/
rm <MIGRATION_ARTIFACTS_HOME>/target/*.placeholder

  2. Fügen Sie Ihre Abhängigkeitsdatei(en) dem Migrationspaket hinzu und entfernen Sie die Platzhalterdatei(en):

    cp <DEPENDENCY_FILE_LOCATION>/* <MIGRATION_ARTIFACTS_HOME>/src/main/liberty/lib
rm <MIGRATION_ARTIFACTS_HOME>/src/main/liberty/lib/*.placeholder

  3. Die Platzhalterdateien enthalten den/die Namen aller Abhängigkeiten für Ihre Anwendung.

    Hinweis: Wenn Sie Maven verwenden, um Ihre Anwendung und Abhängigkeiten zu importieren, können Sie die Aufgaben 1 und 2 dieses Schrittes überspringen.

  4. Aktualisieren Sie ggf. alle " server.xml -Dateien der Anwendung:

    • Die Datei server.xml unter <MIGRATION_ARTIFACTS_HOME>/src/main/liberty/config enthält eine Reihe von Includes, die die Dateien server.xml für jede Anwendung einschließen.

    • Die Dateien der Anwendung server.xml finden Sie an folgenden Stellen: <MIGRATION_ARTIFACTS_HOME>/apps/<APPLICATION_NAME>/src/main/liberty/config.

    • Der Name der Datei server.xml für jeden Antrag lautet <APPLICATION_NAME>_server_config.xml.

    • Ändern Sie jede server.xml Datei, indem Sie Standardwerte für alle sensiblen Daten eingeben, die Transformation Advisor entfernt wurden.

    • Wenn in der Datei " server.xml zusätzliche Binärdateien aufgeführt sind, die Sie nicht benötigen, entfernen Sie alle Verweise auf diese.

    Hinweis: Setzen Sie nur Standardwerte für die in der Datei server.xml definierten Variablen. Wenn der Wert in der Datei server.xml festgelegt ist, kann er während der Bereitstellung nicht überschrieben werden.

SCHRITT 2: Alle Anwendungen in Liberty containerisieren

In diesem Schritt containerisieren Sie Ihre funktionierende Liberty-Installation. Sie erstellen ein Liberty-Image, in dem alle migrierten Anwendungen installiert und funktionsfähig sind, und testen anschließend das Image, um sicherzustellen, dass es ordnungsgemäß funktioniert.

Hinweis: Wenn Sie podman anstelle von docker verwenden, ersetzen Sie einfach das Wort docker in jedem Befehl durch podman.

Schritt 2 Voraussetzungen

  • Sie haben Schritt 1 abgeschlossen: Sammeln Sie Anwendungen und Abhängigkeitsdateien und aktualisieren Sie die Konfiguration.

  • Docker oder Podman ist installiert.

  • Die Maschine, auf der Sie diese Task ausführen, benötigt Zugriff auf das Internet, um das Liberty-Basisimage herunterzuladen.

Schritt 2 Aufgaben

  1. Wenn Sie Docker verwenden, stellen Sie sicher, dass der Docker-Service aktiv ist. Wenn das nicht der Fall ist, starten Sie es:

    service docker start

  2. Gehen Sie zu dem Ort, an dem sich Ihre Migrationsartefakte befinden, und erstellen Sie Ihr Image aus der Dockerfile:

    cd <MIGRATION_ARTIFACTS_HOME>
docker build --no-cache -t "<IMAGE_REFERENCE>" -f Containerfile .
    Hinweis: Das Migrationspaket enthält eine pom.xml Datei, mit der die Anwendung und alle Abhängigkeiten von Maven gezogen werden können. Sie müssen diese Option in Containerfile aktivieren und die Platzhalter in der Datei pom.xml mit den richtigen Werten aktualisieren. Die Details dazu finden Sie im Abschnitt Abhängigkeiten mit Maven hinzufügen.

  3. Führen Sie das Image aus und stellen Sie sicher, dass es ordnungsgemäß funktioniert:

    docker run -p 9080:9080 <IMAGE_REFERENCE>

  4. Wenn alles gut aussieht, wurde das Image gestartet und auf den Port 9080 abgebildet. Sie können sie über diesen Link in Ihrem Browser aufrufen:

    http://<LIBERTY_HOME_MACHINE_IP>:9080/>

  5. Jede Bewerbung ist erhältlich unter:

    http://<LIBERTY_HOME_MACHINE_IP>:9080/<APP_CONTEXT_ROOT>

  6. Optional : Überprüfen Sie Ihr Image, sobald es läuft, indem Sie sich in den Container einloggen:

    docker exec -ti <CONTAINER_ID> bash

    Dadurch können Sie das Dateisystem des Containers durchsuchen, in dem Ihre Anwendungen ausgeführt werden.

SCHRITT 3: Verteilen Sie Ihr Image mit allen Anwendungen auf Red Hat OpenShift

In diesem Schritt implementieren Sie das erstellte Image in Red Hat OpenShift. Diese Anweisungen beziehen sich auf OpenShift 4 + und wurden in OpenShift 4.12validiert. Führen Sie die gleichen Schritte aus, als ob Ihr Bild eine einzige Anwendung hätte - siehe hier.

Ein binäres Projekt-Anwendung nach Anwendung

Bei diesem Ansatz werden Sie jede Anwendung einzeln konfigurieren, containerisieren und bereitstellen und sie dann gemeinsam einsetzen.

Tasks

  1. Führen Sie die Schritte für die Bereitstellung einer einzelnen Anwendung für jede Anwendung aus.

    cd <MIGRATION_ARTIFACTS_HOME>/apps

    Jede Anwendung einzeln bereitstellen

  2. Verteilen Sie nun alle Anwendungen zusammen, indem Sie diese Schritte befolgen.

    Hinweis: Wenn Sie Anwendungen gemeinsam einsetzen, kann es zu einem Funktionskonflikt kommen. In diesem Fall müssen Sie entweder die Anwendungen, die den Konflikt verursachen, in eine andere Bereitstellung verschieben oder die Anwendungen so aktualisieren, dass sie keine widersprüchlichen Funktionen mehr benötigen.

Verwaltung von Schlüsselspeichern während der Bereitstellung

When deploying to OpenShift, if your application is configured to use non default keystores then the default route will not work without configuration changes.

Keystores in einem Container konfigurieren

Hinweis: Wenn Sie die Bereitstellung auf OpenShift planen, können Sie den Operator verwenden, um die erforderlichen Zertifikate zu generieren; Einzelheiten hierzu finden Sie im nächsten Abschnitt.

Transformation Advisor migriert die Keystore-Informationen im Migrationspaket nicht automatisch. Bei der Ausführung in einem Container mit dem Standard Containerfile , der von Transformation Advisor erzeugt wird, gibt der Liberty-Server Meldungen aus, die darauf hinweisen, dass die nicht standardmäßigen Keystore-Dateien nicht gefunden werden können.

Anweisungen zum Konfigurieren von Keystores im Liberty-Server finden Sie in der Liberty -Dokumentation „Konfigurieren der Sicherheit“.

Keystores in einer OpenShift -Implementierung konfigurieren

Bei der Implementierung in OpenShift können Sie den Liberty-Operator verwenden, um alle erforderlichen Zertifikate zu generieren, oder eigene Zertifikate verwenden.

Verwendung des Liberty Operators zur Erzeugung von Zertifikaten

Führen Sie die folgenden Schritte aus, um mit dem Liberty Operator die Zertifikate für Ihre Anwendung zu erstellen.

  1. Ändern Sie die Datei server.xml und entfernen Sie alle <keystore> -Attribute.

  2. Erstellen und implementieren Sie das Image wie gewohnt.

In diesem Fall wird die gesamte Zertifizierungsgenerierung und das Keystore-Management vom Operator abgewickelt. Weitere Einzelheiten hierzu finden Sie in der Liberty-Dokumentation.

Verwendung Ihres eigenen Zertifikats und Keystores in OpenShift

Sie können Ihre Implementierung für die Verwendung eigener Zertifikate konfigurieren und die Sicherheit selbst verwalten. Weitere Einzelheiten hierzu finden Sie in der Liberty-Dokumentation zur Angabe von Zertifikaten.