Migrieren zwischen Automation Suite-Clustern

Migrieren von Daten und Konfigurationen zwischen Automation Suite-Clustern auf EKS/AKS.

Ü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 Sie von der Automation Suite unter Linux zu einer neuen Installation der Automation Suite unter OpenShift.

Ein nicht oben aufgeführtes Migrationsszenario wird nicht unterstützt.

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 Automation Suite unter Linux zu einer vorhandenen Installation der Automation Suite unter EKS/AKS oder Automation Suite unter OpenShift;
• Migrieren einer Automation Suite unter einem OpenShift-Cluster zur Automation Suite unter einem Linux-Cluster;
• Migrieren von Automation Suite auf EKS/AKS zu einer neuen Installation der Automation Suite auf OpenShift;
• Migrieren von Automation Suite auf OpenShift zu einer neuen Installation der Automation Suite auf EKS/AKS;
• Migrieren von Automation Suite auf EKS zur Automation Suite auf AKS oder von der Automation Suite auf AKS zur Automation Suite auf EKS;
• Migrieren von Automation Suite auf EKS zu einer neuen Installation der Automation Suite auf EKS;
• Migrieren von Automation Suite in AKS zu einer neuen Installation der Automation Suite in AKS;
• Migrieren von Automation Suite auf OpenShift zu einer neuen Installation der Automation Suite auf OpenShift.

Prozessübersicht

In folgender Tabelle finden Sie einen Überblick über den Migrationsprozess von Clustern.

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 Bilder 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 für den Quell- als auch für den Zielcluster aktiviert ist, migrieren Sie die Fähigkeiten. Migrieren der AI Center-Fähigkeiten

For detailed migration instructions, refer to the Automation Suite on EKS/AKS Installation Guide.

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.
• You must have an external objectstore configured in your source cluster. If you use in-cluster storage, refer to Migrating in-cluster objectstore to external objectstore.
• Sie müssen dem Quellcluster Lese-/Schreibberechtigungen für den Zielobjektspeicher gewähren. Wenn persistente Volumes (PVs) kopiert werden, schreibt der Quellcluster seine Daten in den Zielobjektspeicher, während der Zielcluster die Daten aus dem Objektspeicher abruft und die entsprechenden PVs erstellt.
• 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

In der folgenden Tabelle werden die Mechanismen und Verantwortlichkeiten zur Datenmigration für jede Komponente beschrieben.

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® Schulungsaufträ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.	Migrieren vom clusterinternen zum externen Objectstore: 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. Wenn Sie die integrierten Überwachungskomponenten nicht verwenden, müssen Sie nach dem Migrationsupgrade externe Überwachungskomponenten einrichten.	Keine Angabe

Vorbereiten der Clustermigration

Vorbereiten des Zielclusters

Wichtig:

Do not run uipathctl manifest apply until you have completed Step 1 in the Running the cluster migration section. Running this command too early can result in configuration inconsistencies in the target cluster.

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 Azure/Amazon S3 Bucket-Einstellungen 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:

   Ein dedizierter Microsoft SQL-Server und PostgreSQL für die Process Mining Airflow-Datenbank ist für Process Mining in der Automation Suite 2.2510 erforderlich.

   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.

   To generate the kubeconfig file, refer to Generating the kubeconfig file.

4. If you are migrating from Automation Suite on Linux to a EKS/AKS deployment, you must put the source cluster in maintenance mode. For details, refer to Putting the cluster in maintenance mode.

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. Follow the steps to hydrate the registry used by the target cluster with the offline bundle in Option B: Hydrating the registry with the offline bundle.

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 ändern:

• 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

If you use a private registry, you must seed it. For instructions, refer to Configuring the OCI-compliant registry.

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]

• [skill_ids]: Optional. Array von 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.