Migrationsplan für JBoss-Server anpassen
Prüfen Sie die Datei mit dem Migrationsplan, die bei der Migration erstellt wurde. Passen Sie die Datei vor der Migration an. Der detaillierte Migrationsplan legt fest, wie die Containerartefakte der Arbeitslast aus der Quelle extrahiert werden sollen.
In diesem Abschnitt werden der Inhalt des Migrationsplans und die Arten von Anpassungen beschrieben, die Sie vor dem Ausführen der Migration und dem Erstellen von Bereitstellungsartefakten prüfen sollten.
Hinweis
In diesem Dokument wird davon ausgegangen, dass Sie bereits eine Migration erstellt haben und die Migrationsplandatei vorhanden ist.
Migrationsplan bearbeiten
Nachdem Sie das Dateisystem kopiert und analysiert haben, finden Sie den Migrationsplan im neuen Verzeichnis, das im angegebenen Ausgabepfad erstellt wird: ANALYSIS_OUTPUT_PATH/config.yaml.
Bearbeiten Sie den Migrationsplan nach Bedarf und speichern Sie die Änderungen.
Struktur des Migrationsplans
Der Migrationsplan für eine JBoss-Arbeitslast hat die folgende Struktur, die Sie wie in den folgenden Abschnitten beschrieben anpassen können.
# Server name. Edit this to change the artifacts naming.
serverName: jboss-server
# JBoss home directory.
home: /opt/jboss/wildfly
# Parent Wildfly image for the generated container image.
fromImage: docker.io/jboss/wildfly:10.1.0.Final
# JBoss home directory in the target image.
targetImageHome: /opt/wildfly
# Configuration file path from source VM.
configurationFile: /opt/jboss/wildfly/standalone/configuration/standalone.xml
# Ports list to expose on the generated container image.
ports:
- name: management-http
port: 9990
- name: management-https
port: 9993
- name: ajp
port: 8009
- name: http
port: 8080
- name: https
port: 8433
- name: txn-recovery-environment
port: 4712
- name: txn-status-manager
port: 4713
# List of deployments files to copy.
deployments:
directory: /opt/jboss/wildfly/standalone/deployments
applications:
- test.war
# List of modules to copy in rsync filter format.
# Note: files under '/system/layers/base/' are JBoss/Wildfly binaries and should be copied only if they have been modified.
modules:
- '- system/layers/base'
# External paths required for running the JBoss server or apps.
additionalFiles: []
# Sensitive data which is filtered out of the container image.
# If includeSensitiveData is set to true the sensitive data is mounted on the container.
sensitiveData:
includeSensitiveData: false
sensitiveDataPaths:
- /opt/jboss/wildfly/standalone/configuration/application-roles.properties
- /opt/jboss/wildfly/standalone/configuration/application-users.properties
- /opt/jboss/wildfly/standalone/configuration/application.keystore
- /opt/jboss/wildfly/standalone/configuration/mgmt-groups.properties
- /opt/jboss/wildfly/standalone/configuration/mgmt-users.properties
Überprüfen Sie die Details des Migrationsplans und die Hinweise, um nach Bedarf Informationen hinzuzufügen.
Überlegen Sie insbesondere, ob Änderungen in den folgenden Abschnitten nötig sind.
Docker-Image angeben
Im Migrationsplan generieren wir basierend auf der JBoss-Version ein Docker-Community-Image-Tag. Die JBoss-Version wird erkannt und in eine Hauptversion konvertiert. Nebenversionen werden nicht unterstützt. Wenn wir keine JBoss-Version erkennen, enthält fromImage einen leeren String.
Im Migrationsplan stellt das Feld fromImage das Docker-Image-Tag dar, das als Basis des Container-Images verwendet wird.
Die ursprünglichen JBoss-Versionen auf der Quell-VM sind in der Datei discovery-report.yaml enthalten, die bei der ersten Erkennung generiert wird.
Wenn Sie das Docker-Community-Image ändern oder ein eigenes Docker-Image bereitstellen möchten, können Sie das fromImage-Tag im Migrationsplan mit dem folgenden Format ändern:
# Parent Wildfly image for the generated container image. fromImage: docker.io/jboss/wildfly:10.1.0.Final
Das Feld targetImageHome gibt den Pfad des JBoss-Basisverzeichnisses im Ziel-Image an und wird vom Feld fromImage abgeleitet. Sie müssen den Wert dieses Felds nur ändern, wenn Sie ein JBoss-Image mit einem anderen JBoss-Basiswert verwenden.
Anwendungen angeben
Wenn Sie Anwendungen aus dem Container-Image ausschließen möchten, entfernen Sie sie aus der Anwendungsliste.
Module angeben
Die Liste module enthält die vorhandenen JBoss-Module, die entweder mit einem Plus- oder einem Minuszeichen gekennzeichnet sind. Nur mit einem Pluszeichen gekennzeichnete Module werden dem generierten Container-Image hinzugefügt. Die Module, die mit einem Minuszeichen markiert sind, z. B. (/system/layers/base), sind bereits im Community-Image vorhanden und werden nur überschrieben, wenn Sie sie mit einem Pluszeichen neu markieren.
Migration vertraulicher Daten konfigurieren
Zum Hochladen sensibler Daten in das Repository müssen Sie das Feld includeSensitiveData im Migrationsplan auf true setzen.
Die Secrets werden in secrets.yaml hochgeladen.
Das Feld sensitiveDataPaths gibt die Listen der Dateien an, die aus dem Migrationsplan herausgefiltert werden sollen. Diese Dateien können vertrauliche Daten wie Zertifikate, Secret-Speicher, Nutzer und Passwörter enthalten, die von JBoss verwendet werden. Wenn Sie einen Dateipfad aus dem Feld sensitiveDataPaths entfernen, wird die Datei in das Image hochgeladen.