Migrieren zwischen Automation Suite-Clustern

Über die Clustermigration

Sie können von einem Automation Suite-Cluster zu einem anderen migrieren, wenn Sie den Namespace uipath anstelle eines benutzerdefinierten Namespace verwenden und von einer Automation Suite-Variante zu einer anderen wechseln möchten. Wir unterstützen die folgenden Szenarien:

• Migrieren von der Automation Suite unter Linux zu einer neuen Installation der Automation Suite auf EKS/AKS;

• Migrieren von der Automation Suite auf EKS/AKS zu einer neuen Installation der Automation Suite unter OpenShift;

• Migrieren von der Automation Suite auf OpenShift zu einer neuen Installation der Automation Suite auf EKS/AKS;

• Migrieren Sie von der Automation Suite auf EKS zur Automation Suite auf AKS oder von der Automation Suite auf AKS zur Automation Suite auf EKS.

Beachten Sie, dass Sie versuchen können, den Migrationsvorgang mehrmals durchzuführen, ohne dass Auswirkungen auf Ihren vorhandenen Cluster auftreten.

Die folgenden Migrationsszenarien werden nicht unterstützt:

• Migrieren von der Automation Suite unter Linux zu einer vorhandenen Installation der Automation Suite unter OpenShift;

• Migrieren einer Automation Suite im OpenShift-Cluster zur Automation Suite im Linux-Cluster.

Prozessübersicht

Schritt	Beschreibung
1.	Obligatorisch. Stellen Sie sicher, dass Sie die Migrationsanforderungen erfüllen. Anforderungen Datenmigration und Zuständigkeiten
2.	Obligatorisch. Bereiten Sie den Zielcluster und die Docker-Images für den Quell- sowie den Zielcluster vor. Vorbereiten des Zielclusters Optional. Wenn Ihre Bereitstellung offline ist oder wenn Sie eine private OCI-Registrierung verwenden, stellen Sie sicher, dass die erforderlichen Images verfügbar sind. Hydratisieren der OCI-konformen Registrierung in einem Offline-Setup Hydratisieren der OCI-konformen Registrierung in einem Online-Setup
3.	Obligatorisch. Starten Sie die Migration, verschieben Sie die Daten und führen Sie die Automation Suite-Installation aus. Ausführen der Clustermigration
4.	Optional. Wenn das AI Center sowohl im Quell- als auch im Zielcluster aktiviert ist, migrieren Sie die Fähigkeiten. Migrieren der AI Center-Fähigkeiten

Ausführliche Anweisungen zur Migration finden Sie in der Automation Suite in der EKS/AKS-Installationsanleitung.

Anforderungen

Um von einem Automation Suite-Cluster zu einem anderen zu migrieren, müssen die folgenden Voraussetzungen erfüllt sein:

• Laden Sie die folgenden Artefakte herunter:

  • uipathctl

  • versions.json

• Sie müssen eine Konnektivität zwischen den beiden Umgebungen herstellen.

• In Ihrem Quellcluster muss ein externer Objektspeicher konfiguriert sein. Wenn Sie clusterinternen Speicher verwenden, finden Sie weitere Informationen unter Migrieren des clusterinternen Objectstores zum externen Objectstore.

• Wenn Sie von der Automation Suite unter Linux migrieren, muss die Version Ihres Quellclusters 2022.10 oder höher sein.

• Wenn Sie auf OpenShift zur Automation Suite migrieren, muss die Version Ihres Quellclusters 2023.10 oder höher sein.

• Nur-Offline-Anforderungen: Sie müssen den Zielcluster hydratisieren.

Datenmigration und Zuständigkeiten

Daten	Migrationsmechanismus
	Status	Verantwortung
SQL	Beibehalten Sie haben zwei Optionen: Verwenden Sie dieselben Datenbanken für die neue Installation wieder. Verweisen Sie die SQL-Verbindungszeichenfolgen der Clusterkonfiguration auf den vorhandenen Datenbankserver. Klonen Sie Ihre Datenbanken und verwenden Sie stattdessen die Klone.	Kunde
Docker-Registrierung	Nicht migriert Wenn Sie eine private Registrierung verwenden, müssen Sie die Zielregistrierung hydratisieren. Wenn Sie registry.uipath.com für den Zielcluster verwenden, sind keine weiteren Schritte erforderlich.)	Kunde
FQDN	Erforderlich Sie müssen einen neuen FQDN für den neuen Cluster auswählen. Optional können Sie bei Bedarf zum vorherigen FQDN zurückkehren.	Kunde
Zertifikat	Nicht migriert Sie müssen Zertifikate als Teil der neuen Clusterinstallation mitbringen.	Kunde
Clusterkonfiguration	Nicht migriert Sie müssen das neue input.json für den Zielclustertyp (AKS oder EKS) generieren.	Kunde
Benutzerdefinierte Warnungen und Dashboards, die von Benutzern erstellt wurden	Nicht migriert Nach der Migration müssen Sie alle benutzerdefinierten Warnungen im Alert Manager und in den Grafana-Dashboards neu konfigurieren.	Kunde
Von Benutzern erstellte Anwendungsprotokolle / Prometheus-Streaming-Konfiguration	Nicht migriert Sie müssen das Anwendungsprotokoll und das Prometheus-Streaming neu konfigurieren.	Kunde
Dynamische Workloads	Abhängig von der Anwendung AI Center-Trainingsaufträge gehen verloren; Fähigkeiten werden beibehalten.	Fähigkeiten (Skript, das nach dem Upgrade ausgeführt werden muss): UiPath® Trainingsaufträge: Kunde
Objektspeicher	Externer Objektspeicher: Beibehalten Für den externen Objektspeicher haben Sie zwei Optionen: Verwenden Sie den vorhandenen externen Objektspeicher wieder und verbinden Sie ihn mit der neuen Umgebung. Erstellen Sie ein Replikat Ihres aktuellen Objektspeichers und verwenden Sie es für das neue Setup. Wichtig: Wenn Sie einen clusterinternen Objektspeicher verwenden, müssen Sie vor dem Upgrade eine Migration von Ceph nach extern durchführen.	Migration vom clusterinternen zum externen Objektspeicher: Kunde Externer Objektspeicher: UiPath®
Insights	Beibehalten	UiPath®
MongoDB-Daten	Beibehalten MongoDB-Daten werden in die Ziel-SQL verschoben.	UiPath®
RabbitMQ	Nicht benötigt	UiPath®
Überwachen (Daten)	Nicht benötigt Überwachungsdaten gelten nicht für den neuen Cluster.	Keine Angabe

Vorbereiten der Clustermigration

Vorbereiten des Zielclusters

Wichtig: Führen Sie uipathctl manifest apply erst aus, wenn Sie Schritt 1 im Abschnitt Ausführen der Clustermigration abgeschlossen haben. Ein zu frühes Ausführen dieses Befehls kann zu Konfigurationsinkonsistenzen im Zielcluster führen.

Hinweis:

Ändern Sie nicht den Quellcluster, nachdem Sie den Migrationsprozess gestartet haben.

Führen Sie die folgenden Schritte aus, um den Zielcluster vorzubereiten:

1. Laden Sie die Zielversion von input.json auf den Quellcluster herunter und generieren Sie die input.json -Datei, indem Sie den folgenden Befehl ausführen:

   uipathctl manifest get-revision

   Weitere Informationen finden Sie im folgenden Diagramm:

   
2. Ändern Sie basierend auf der zuvor generierten input.json-Datei die input.json-Datei des Zielclusters.

   Sie müssen die Orchestrator-spezifische Konfiguration übertragen, die den Verschlüsselungsschlüssel pro Mandant und die Einstellungen für Azure/Amazon S3-Speicher-Buckets enthält.

   Darüber hinaus müssen Sie die folgenden Komponenten aktualisieren, damit sie auf die richtige Infrastruktur im Zielcluster verweisen:

   • Externer Objektspeicher
   • SQL Server- oder PostgreSQL-Verbindungsdetails
   • Konfiguration des Redis-Clusters

   Hinweis:

   Dedizierter Microsoft SQL Server und PostgreSQL für die Process Mining Airflow-Datenbank wird für Version 2024.10.3 oder neuer empfohlen.

   Wenn Sie von einer Version vor 2024.10.3 migrieren, enthält die generierte input.json -Datei für den Zielcluster nicht die Verbindungszeichenfolge für die Airflow PostgreSQL-Datenbank. Um die neueste Version von Airflow zu verwenden, die PostgreSQL erfordert, müssen Sie die sqlalchemy -Verbindungszeichenfolgenvorlage für PostgreSQL vor der Migration manuell zur input.json -Datei für den Zielcluster hinzufügen.

   Postgresql_connection_string_template_sqlalchemy_pyodbc

   postgresql+psycopg2://<user>:<password>@<postgresql host>:<postgresql port>/DB_NAME_PLACEHOLDER

3. Überprüfen Sie die Voraussetzungen im Zielcluster, indem Sie den folgenden Befehl ausführen:

   uipathctl prereq run input-target.json --kubeconfig kubeconfig.target --versions versions.json

   Hinweis: input-target.json ist die input.json -Datei, die dem Zielcluster entspricht.

   Informationen zum Generieren der kubeconfig -Datei finden Sie unter Generieren der kubeconfig-Datei.
4. Wenn Sie von der Automation Suite unter Linux zu einer EKS/AKS-Bereitstellung migrieren, müssen Sie den Quellcluster in den Wartungsmodus versetzen. Weitere Informationen dazu finden Sie unter Versetzen des Clusters in den Wartungsmodus.
5. Klonen Sie die SQL-Datenbanken von der Quellbereitstellung auf die Zielbereitstellung.

Hydratisieren der OCI-konformen Registrierungsstelle ohne Internetzugang

Für den Migrationsprozess muss das neueste Docker-Image-Tag uipathcore sowohl für den Quell- als auch für den Zielcluster verfügbar sein. Wenn Ihr Quellcluster offline ist, stellen Sie das Image mit den folgenden Schritten zur Verfügung:

1. Führen Sie die Schritte aus, um die vom Zielcluster verwendete Registrierung mit dem Offlinepaket in Option B: Hydratisieren der Registrierung mit dem Offlinepaket zu hydratisieren.
2. Kopieren Sie die Binärdatei uipathctl und die Datei versions.json auf eine VM mit Zugriff auf den Quellcluster.
3. Führen Sie den folgenden Befehl aus:

   jq -r '.[][] | select(.name=="uipath/uipathcore") | .ref + ":" + .version' "/path/to/versions.json" > images.txt

4. Legen Sie das Image uipathcore aus der Registrierung des Zielclusters in der Registrierung des Quellclusters an:

   ./uipathctl registry seed --tag-file ./images.txt \
               --source-registry "target.registry.fqdn.com" \
               --source-password "target-registry-username" \
               --source-username "target-registry-password" \
               --dest-registry "source.registry.fqdn.com" \
               --dest-username "source-registry-username" \
               --dest-password "source-registry-password"

   Hinweis: Stellen Sie sicher, dass Sie den Befehl wie folgt aktualisieren:

   • Ersetzen Sie target.registry.fqdn.com, target.registry.fqdn.com und target-registry-password durch die richtigen Werte, die der Registrierung entsprechen, die dem Zielcluster zugeordnet ist;
   • Ersetzen Sie source.registry.fqdn.com, source.registry.fqdn.com und source-registry-password durch die richtigen Werte, die der Registrierung entsprechen, die dem Quellcluster zugeordnet ist.

Hydratisieren der OCI-konformen Registrierung mit Internetzugang

Bei Verwendung eines privaten Registers müssen Sie dieses seeden. Anweisungen finden Sie unter Konfigurieren der OCI-konformen Registrierung.

Ausführen der Clustermigration

Führen Sie die folgenden Schritte aus, um zum Automation Suite-Zielcluster zu migrieren:

1. Führen Sie die Migration aus, indem Sie den folgenden Befehl ausführen:

   uipathctl cluster migration run input-target.json --kubeconfig kubeconfig.source --target-kubeconfig kubeconfig.target --versions versions-target.json

2. Schließen Sie die Automation Suite-Installation auf dem Zielcluster ab, indem Sie den folgenden Befehl ausführen:

   uipathctl manifest apply input-target.json --kubeconfig kubeconfig.target --versions versions-target.json

Migrieren der AI Center-Fähigkeiten

Die Schritte in diesem Abschnitt gelten nur, wenn Sie das AI Center im Quell- sowie im Zielcluster aktiviert haben. Beachten Sie, dass die Anweisungen davon ausgehen, dass AI Center im Zielcluster auf die Datenbank verweist, welche die Fähigkeitsdaten zum Ausführen der Fähigkeiten enthält.

Nach Abschluss der Migration müssen Sie die AI Center-Fähigkeiten synchronisieren, damit Sie sie erneut verwenden können.

Überprüfen des Status der Fähigkeitsmigration

Sie können das folgende Skript verwenden, um die ML-Fähigkeit des AI Center mit dem Zielcluster zu synchronisieren. Das Skript löst die Synchronisierung im Hintergrund aus, wenn keine aktive Synchronisierung läuft.

Das Skript synchronisiert die Fähigkeiten im Hintergrund (asynchron) und gibt sie zurück. Der Auftrag stellt sicher, dass die Fähigkeiten bereitgestellt werden und aktualisiert den DB-Eintrag, um den aktuellen Status widerzuspiegeln.

uipathctl service aicenter sync-skills [skill_ids]

Parameter	Beschreibung
[skill_ids]	Das optionale Array der Fähigkeits-IDs, getrennt durch Leerzeichen. Wenn Sie die Fähigkeits-ID angeben, werden nur diese Fähigkeiten aktualisiert; Andernfalls werden alle bereitgestellten Fähigkeiten erneut synchronisiert.

uipathctl service aicenter sync-skills 783273-3232-3232-323 32-32-323-3232

//this will only sync the skills with ID 783273-3232-3232-323 and 32-32-323-3232

Um den Status der ML-Fähigkeit des AI Centers anzuzeigen, führen Sie den folgenden Befehl aus:

uipathctl service aicenter sync-skill-status [skill_ids]

Der Befehl kann einen der folgenden Status zurückgeben:

• InProgess – Die Bereitstellung der Fähigkeit wird ausgeführt.
• Failed – Die Bereitstellung der Fähigkeit ist fehlgeschlagen.
• OutOfSync – Die Fähigkeit ist in der Datenbank verfügbar; sie muss jedoch noch bereitgestellt werden.
• Available – Wenn die Fähigkeiten bereitgestellt und verfügbar sind.