Migrationsplan für JBoss-Server anpassen
Prüfen Sie die Datei für den Migrationsplan, die bei der Migration erstellt wurde. Passen Sie die Datei vor der Migration an. Die Details Ihres Migrationsplans werden verwendet, um die Containerartefakte der Arbeitslast aus der Quelle zu extrahieren.
In diesem Abschnitt werden der Inhalt des Migrationsplans und die Arten von Anpassungen dargestellt, die Sie vor dem Ausführen der Migration und vor dem Erstellen von Deployment-Artefakten prüfen sollten.
Hinweise
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 Leitbemerkungen, um nach Bedarf Informationen hinzuzufügen.
Berücksichtigen Sie insbesondere Änderungen in folgenden Abschnitten.
Docker-Image angeben
Im Migrationsplan generieren wir ein Docker-Community-Image-Tag basierend auf der JBoss-Version. 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 von 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 in Ihrem 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
Um vertrauliche Daten in das Repository hochzuladen, 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. Diese Dateien können vertrauliche Informationen 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.