Aktualisieren der Automation Suite auf EKS/AKS

Die Automation Suite in AKS/EKS besteht aus mehreren Komponenten. Sie als Kunde und UiPath® sind gemeinsam für diese Komponenten verantwortlich. Weitere Informationen dazu finden Sie unter Verantwortungsmatrix.

Sie sind für das Upgrade verantwortlich:

• Kubernetes-Infrastruktur, in der die Automation Suite bereitgestellt wird (AKS oder EKS)
• Komponenten, die Sie als Teil der Automation Suite einsetzen möchten (z. B. Gatekeeper, FluentD usw.)

UiPath® ist für das Upgrade dieser Komponenten verantwortlich:

• UiPath®-Dienste (z. B. Orchestrator)
• Komponenten, die als Teil der Automation Suite bereitgestellt werden (z. B. ArgoCD)

Upgraden von UiPath®-Diensten und -Komponenten

Vorbereitung

Hinweis:

Es gibt ein bekanntes Problem mit der Sicherungslogik in der Automation Suite für die AKS/EKS-Versionen 2023.10.0 bis 2023.10.7. Insbesondere schließt dieses Problem die Sicherung von Insights-Dashboards aus. Alle historischen Daten werden jedoch erfolgreich gesichert.

Um die Insights-Dashboards in die Sicherung aufzunehmen, müssen Sie die Sicherungslösung mithilfe des hier verfügbaren Skripts neu konfigurieren. Mit diesem Skript können Sie die Sicherungslösung neu konfigurieren und die Sicherung erstellen. Weitere Informationen zur Ausführung des Befehls finden Sie in diesem Abschnitt.

Führen Sie die folgenden Schritte aus, um das Upgrade vorzubereiten:

1. Überprüfen Sie die Kompatibilitätsmatrix, um die unterstützten Versionen für jedes verfügbare Upgrade-Szenario zu bestimmen. Wenn Sie eigene Komponenten mitgebracht haben, stellen Sie sicher, dass die Versionen Ihrer Komponenten mit der Version kompatibel sind, auf die Sie aktualisieren möchten. Nähere Informationen finden Sie unter Kompatibilitätsmatrix.
2. Laden Sie versions.json und uipathctl für die Version, auf die Sie aktualisieren möchten, auf Ihre Verwaltungsmaschine herunter. Anweisungen zum Herunterladen finden Sie unter Herunterladen der Installationspakete.
3. Generieren Sie die neueste input.json -Datei wie folgt:
   • Option A: Um die neueste Revision Ihrer input.json -Datei abzurufen, führen Sie den folgenden Befehl aus:

     uipathctl manifest get-revision
     

   • Option B: Um alle letzten input.json -Dateien aufzulisten und diejenige zu bestimmen, die Sie auswählen möchten, führen Sie den folgenden Befehl aus:

     uipathctl manifest list-revisions
     

4. Wenn Sie ein Offline-Setup mit einer externen OCI-konformen Registrierung verwenden, müssen Sie die Registrierung vor dem Upgrade mit Container-Images und Helm-Charts hydratisieren. Weitere Informationen finden Sie unter Hydratisieren der Registrierung mit dem Offlinepaket.
5. Wenn Process Mining installiert ist und Sie die neueste Version von Airflow verwenden möchten, die PostgreSQL benötigt, müssen Sie vor dem Upgrade die Vorlage für die sqlalchemy -Verbindungszeichenfolge für PostgreSQL in der cluster_config.json -Datei hinzufügen oder aktualisieren: postgresql_connection_string_template_sqlalchemy_pyodbc.

   postgresql+psycopg2://<user>:<password>@<postgresql host>:<postgresql port>/<airflow db name>
   

   Hinweis:

   Das gilt nur für Process Mining auf der Automation Suite 2023.10.9 oder höher.

Ausführung

Führen Sie die folgenden Schritte aus, um ein Upgrade von UiPath®-Diensten und -Komponenten durchzuführen:

1. Bestätigen Sie, dass sich Ihr Cluster in einem guten Zustand befindet:

   uipathctl health check
   

2. Versetzen Sie den Cluster in den Wartungsmodus, um eine konsistente Sicherung zu gewährleisten:

   uipathctl cluster maintenance enable
   

   Wichtig:

   Dieser Vorgang verursacht Ausfallzeiten und Ihre Geschäftsautomatisierung wird angehalten, während der Wartungsmodus aktiviert ist.

3. Überprüfen Sie, ob sich der Cluster im Wartungsmodus befindet:

   uipathctl cluster maintenance is-enabled
   

4. Sichern Sie den Cluster und die SQL-Datenbank und überprüfen Sie dann, ob die Sicherung erfolgreich abgeschlossen wurde.
   Wichtig:

   Es wird dringend empfohlen, vor dem Upgrade der Automation Suite eine Sicherung des Clusters und der SQL-Datenbank zu erstellen. Dadurch wird sichergestellt, dass Sie den Cluster wiederherstellen können, wenn während des Upgradevorgangs etwas schief läuft. Dies gilt auch vor dem Upgrade Ihrer Kubernetes-Infrastruktur.

   Make sure to copy the value of global.userInputs.identity.krb5KeytabSecret to global.kerberosAuthConfig.userKeytab, if you simultaneously meet the following requirements:

   • Sie die Active Directory-Integration mit Benutzername und Kennwort konfiguriert haben
   • Sie haben die Windows-Authentifizierung aktiviert
   • Sie verwenden keine integrierte SQL-Authentifizierung.
5. Deaktivieren des Wartungsmodus:

   uipathctl cluster maintenance disable
   

   Hinweis:

   Sie müssen den Wartungsmodus vor dem Upgrade deaktivieren. Der Upgradeprozess der Automation Suite unterstützt die Aktivierung des Wartungsmodus nicht.

6. Führen Sie das Upgrade von UiPath®-Diensten und -Komponenten durch:

   uipathctl cluster upgrade input.json --versions versions.json
   

   Wichtig:

   Dieser Vorgang führt zu Ausfallzeiten und Ihre Geschäftsautomatisierung wird während des gesamten Upgrade-Prozesses angehalten. Es ist wichtig, dass Sie das Upgrade nur während Ihres Wartungsfensters durchführen.

7. Prüfen Sie, ob sich der Cluster nach dem Upgrade in einem guten Zustand befindet:

   uipathctl health check
   

   Hinweis:

   Wenn Sie auf die Automation Suite 2024.10.3 oder höher aktualisiert haben, können Sie Dapr und den Cert Manager deinstallieren, wenn Sie Task Mining nicht aktiviert haben. Weitere Informationen finden Sie in den Abschnitten und.

Upgrade der Kubernetes-Infrastruktur

Hinweis:

Die Automation Suite unterstützt die Upstream-Versionen N-1 bis N-3 von Kubernetes unabhängig vom Cloud-Anbieter. Wenn die Upstream-Version beispielsweise 1.27 ist, unterstützen wir die Versionen 1.26, 1.25 und 1.24. Unterstützte Versionen finden Sie in der Kompatibilitätsmatrix.

Sie sind für das Upgrade der Kubernetes-Infrastruktur verantwortlich, die die Automation Suite hostet. Sie sollten die Standardpraktiken Ihres Unternehmens befolgen, um die Kubernetes-Infrastruktur zu upgraden.