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.

Nächste Schritte