Aktualisieren der Automation Suite auf EKS/AKS

Wichtig:

Wenn Sie Active Directory (AD) verwenden und ein Upgrade auf 2023.4.0 planen, empfehlen wir dringend, direkt zur Version 2023.4.3 zu springen, da 2023.4.0, 2023.4.1 und 2023.4.2 von einem AD-Problem betroffen sind.

Die Automation Suite auf AKS/EKS besteht aus mehreren Komponenten. Sowohl Sie als Kunde als auch UiPath sind für diese Komponenten gemeinsam verantwortlich. Weitere Informationen finden Sie unter Kompatibilitätsmatrix.

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 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 einzuschließen, 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 zum Ausführen 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. Weitere 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

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 geht.

   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 Automation Suite-Upgradeprozess 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

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.