Ansible wird verwendet, um das Upgrade des gesamten Automation Suite-Clusters zu automatisieren, indem einige Vorgänge auf einer Maschine im Cluster ausgeführt werden.
In der folgenden Abbildung verwendet der Server 1 -Knoten (oder Ansible-Hostknoten) Ansible, um das Upgrade des gesamten Automation Suite-Clusters zu orchestrieren.

Vorbereitung
Wichtig!
Stellen Sie vor dem Upgrade sicher, dass Sie Ihre Umgebung für die Verwendung des Skripts
uipathctl.sh
vorbereitet haben. Weitere Informationen finden Sie unter Verwenden von uipathctl.sh .Stellen Sie sicher, dass Sie 10 GiB freien Speicherplatz im Ordner
/opt/UiPathAutomationSuite
auf allen Knoten haben. Wenn Sie nicht über genügend Speicherplatz verfügen, können Sie entweder die Kapazität dieses Ordners erhöhen oder alle vorherigen Installationsdateien mit Ausnahme voncluster_config.json
entfernen. Sie können das vorherige Installationsprogramm jederzeit erneut herunterladen.
Führen Sie den folgenden Befehl aus, um den verfügbaren Speicherplatz zu überprüfen:df -h /opt/UiPathAutomationSuite
.
Führen Sie die folgenden Schritte aus, um das Upgrade vorzubereiten:
-
Melden Sie sich über SSH bei dem Serverknoten an, den Sie zuvor als Ansible-Hostknoten identifiziert haben. Stellen Sie sicher, dass Sie den primären Serverknoten mit dem zusätzlichen Datenträger des UiPath-Pakets, der unter
/uipath
angefügt ist, als Ihren Ansible-Hostknoten ausgewählt haben. -
Root-Benutzer werden:
sudo su -
- Erstellen Sie einen Installationsordner im Verzeichnis
/opt/UiPathAutomationSuite
:
# Please replace {version} with installer version
mkdir -p /opt/UiPathAutomationSuite/{version}/installer
- Laden Sie
sf-installer.zip
herunter und kopieren Sie es nach/opt/UiPathAutomationSuite/{version}/installer
. Anweisungen zum Herunterladen finden Sie unter sf-installer.zip .
cp /path/to/sf-installer.zip /opt/UiPathAutomationSuite/{version}/installer
sf-installer.zip
entpacken:
cd /opt/UiPathAutomationSuite/{version}/installer
unzip sf-installer.zip -d .
- Laden Sie
sf-infra.tar.gz
herunter und kopieren Sie es nach/uipath/{version}
. Anweisungen zum Herunterladen finden Sie unter sf-infra.tar.gz .
cp /path/to/sf-infra.tar.gz /uipath/{version}
- Laden Sie
sf.tar.gz
herunter und kopieren Sie es nach/uipath/{version}
. Anweisungen zum Herunterladen finden Sie unter sf.tar.gz .
cp /path/to/sf.tar.gz /uipath/{version}
- Erteilen Sie dem Installationsprogramm die erforderlichen Berechtigungen:
chmod 755 -R /opt/UiPathAutomationSuite/{version}/installer
- Generieren Sie die neueste
cluster_config.json
-Datei auf dem Ansible-Hostknoten.
Hinweis:
Ausführliche Informationen zum Konfigurieren der
cluster_config.json
-Parameter finden Sie unter Erweiterte Installationsumgebung .
- Wenn Sie das alte
cluster_config.json
haben, generieren Sie die Konfigurationsdatei aus dem Cluster:
cd /opt/UiPathAutomationSuite/{version}/installer
./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o ./cluster_config.json
- Wenn Sie nicht über die alte
cluster_config.json
-Datei verfügen, generieren Sie eine Überschreibung aller Standardwerte, was Sie möglicherweise zum Zeitpunkt der Installation der vorherigen Version getan haben:
cd /opt/UiPathAutomationSuite/{version}/installer
./configureUiPathAS.sh config get -o ./cluster_config.json
- Wenn Sie die Automation Suite von einer früheren Version aktualisieren und jetzt auch Process Mining aktivieren, müssen Sie die
sql_connection_string_template_sqlalchemy_pyodbc
aktualisieren. Nachfolgend finden Sie ein Beispiel.
"sql_connection_string_template_sqlalchemy_pyodbc": "mssql+pyodbc://testadmin@sfmfup20211043125452-8926d153-sql.database.windows.net:sgTQrg%40R%40dvoYddYBoKn045ncoC9WhWU@sfmfup20211043125452-8926d153-sql.database.windows.net:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server"
See also Manual: Advanced installation experience.
Execution
Wichtig!
Wenn während oder nach dem Upgrade Fehler oder Probleme auftreten, können Sie auf die vorherige Version zurücksetzen, sofern Sie zuvor eine Sicherung konfiguriert haben.
Anweisungen finden Sie unter Rollback bei Fehlern .
Feuchtigkeitsspendend docker-registry
docker-registry
Um die erforderliche Ausfallzeit zu minimieren, hydratisieren Sie docker-registry
vor dem Upgrade mit Container-Images für die neue Produktversion, indem Sie den folgenden Schritt ausführen:
- Um
docker-registry
zu hydratisieren, führen Sie den folgenden Befehl auf dem ersten Serverknoten aus:
cd /opt/UiPathAutomationSuite/{version}/installer
./configureUiPathAS.sh registry upload --offline-bundle /uipath/{version}/sf.tar.gz --offline-tmp-folder /uipath/tmp
Konfigurieren der Sicherung
Führen Sie die folgenden Schritte aus, um die Sicherung zu konfigurieren:
-
Stellen Sie sicher, dass Sie die Sicherung im Cluster aktiviert haben. Sie müssen die Sicherung mit derselben Version des Installationsprogramms erstellen, die Sie für die aktuelle Bereitstellung verwendet haben. Anweisungen finden Sie in der Dokumentation zum Sichern und Wiederherstellen der Automation Suite-Version, von der Sie ein Upgrade planen. Wenn Sie beispielsweise ein Upgrade von der Automation Suite 2021.10 planen, Befolgen Sie die Anweisungen im Leitfaden 2021.10 .
-
Melden Sie sich über SSH bei dem Serverknoten an, den Sie zuvor als Ansible-Hostknoten identifiziert haben.
-
Stellen Sie sicher, dass alle gewünschten Volumes über Sicherungen im Cluster verfügen:
/path/to/old-installer/configureUiPathAS.sh verify-volumes-backup
Hinweis:
Die Sicherung kann einige Zeit in Anspruch nehmen. Warten Sie etwa 15–20 Minuten und überprüfen Sie die Sicherung des Volumes erneut.
Nachdem die Sicherung erstellt wurde, fahren Sie mit den folgenden Schritten fort.
Versetzen des Clusters in den Wartungsmodus
Wenn Sie den Cluster in den Wartungsmodus versetzen, werden der Ingress-Controller und alle UiPath-Dienste heruntergefahren, wodurch der gesamte eingehende Datenverkehr zum Automation Suite-Cluster blockiert wird.
Wichtig!
Dieser Vorgang führt zu Ausfallzeiten und Ihre Geschäftsautomatisierung wird während des gesamten Upgrade-Prozesses angehalten.
- Führen Sie Folgendes aus, um den Cluster in den Wartungsmodus zu versetzen:
cd /opt/UiPathAutomationSuite/{version}/installer
./configureUiPathAS.sh enable-maintenance-mode
- Führen Sie Folgendes aus, um zu überprüfen, ob sich der Cluster im Wartungsmodus befindet:
./configureUiPathAS.sh is-maintenance-enabled
Wichtig!
Erstellen Sie eine Sicherung Ihres SQL-Servers, nachdem Sie den Wartungsmodus aktiviert haben, damit keine weiteren Transaktionen in Ihrer SQL-Datenbank aufgezeichnet werden.
Aktualisieren des Clusters
Führen Sie die folgenden Schritte aus, um den Automation Suite-Cluster zu aktualisieren:
-
Stellen Sie über SSH eine Verbindung mit dem Ansible-Hostknoten her und werden Sie Root-Benutzer.
-
Um die Upgrade-Schritte auf allen Knoten auszuführen, führen Sie den folgenden Befehl mit den grundlegenden Parametern aus. Eine detailliertere Steuerung finden Sie im Abschnitt Parameter.
Hinweis:
Stellen Sie sicher, dass Sie
cluster_config.json
aktualisiert haben, wie in den Vorbereitungsschritten beschrieben.
# Please replace {version} with installer version, in all the below commands
cd /opt/UiPathAutomationSuite/{version}/installer
./uipathctl.sh upgrade --cluster-config ./cluster_config.json --install-type offline --steps all --offline-infra-bundle /uipath/{version}/sf-infra.tar.gz --accept-license-agreement
Wichtig!
Der Upgrade-Prozess erfordert die Migration von Canal CNI zu Cilium CNI. Das automatisierte Upgrade führt diesen Schritt automatisch aus und startet dann alle Knoten im Cluster neu, um die Migration abzuschließen.
Warten Sie nach dem Neustart der Knoten einige Minuten, um sicherzustellen, dass alle Dienste wieder online sind. Sie können sich bei ArgoCD anmelden, um den Status aller Anwendungen zu überwachen.
Warnung!
Wenn Sie die folgende Fehlermeldung erhalten, befolgen Sie die Anweisungen unter Herabstufen von Ceph von 16.2.6 auf 15.2.9 .
Ceph cluster is running on version: 16.2.6 with known bug(https://docs.ceph.com/en/quincy/releases/pacific/#v16-2-6-pacific). Please provide temporary backup directory (via environment variable 'TMP_CEPH_BACKUP_PATH') to downgrade ceph
Grundlegende Parameter
Parameter | Value |
---|---|
--install-type | Possible values: online and offline .Since this page provides instructions for an offline environment, choose the offline value. |
--steps | Possible values are: all , infra , fabric , and services .Denotes each stage of the installation and upgrade process. all – Recommended: A superset of all the other steps, which upgrades the entire Automation Suite.infra – Upgrades Kubernetes and other infrastructure components on Automation Suite on all the nodes.bundles – Uploads and hydrates the docker registry hosted within the Automation Suite cluster with the fabric and services container images.You must upload and hydrate the Docker registry at the same time as upgrading Kubernetes and the infrastructure components. To execute the two steps simultaneously, run --steps bundles infra .Do not run --steps bundles alone as it will damage the cluster.fabric – Upgrades all fabric and shared components of Automation Suite.services – Upgrades all UiPath product services installed on Automation Suite.If an error occurs during the upgrade, you can use these checkpoints to resume the upgrade operation instead of retrying from start. |
--offline-bundle | Path to the sf.tar.gz offline bundle, containing the fabric and services container images. It is recommended to store it in /uipath/{version}/sf.tar.gz . |
--offline-infra-bundle | Path to the sf-infra.tar.gz offline bundle, containing Kubernetes and infrastructure bundles. |
--cluster-config | cluster_config.json file, which defines the parameters, settings, and preferences applied to the UiPath services deployed via Automation Suite. |
Erweiterte Parameter
Parameter | Value |
---|---|
--ansible-username | Specify the username to be used for SSH connections to all the nodes. Defaults to the current user. If you use a different username for all the nodes, then instead of using this parameter, set the username for all the nodes in inventory.ini and pass it to the script.Example: While running the script, you are logged in as the myadminuser username. However, if you want to use the testadmin username to connect via SSH, you must provide testadmin to this parameter. |
--inventory | Specify an existing Ansible inventory file. If not specified, one will be generated automatically from the existing cluster with the basic configuration. In certain scenarios where you want to have more granular control, you may want to provide your own inventory file. One such example would be if you want to use a different SSH username or SSH key for all the nodes in cluster. For details, see Generating the Ansible inventory.ini file. |
Hinweis:
Wenn das Upgrade aus irgendeinem Grund fehlgeschlagen ist, der Upload in die Docker-Registrierung jedoch erfolgreich ist, ist kein erneuter Upload erforderlich. Sie können das Upgrade fortsetzen, indem Sie die Fabric- oder Dienstinstallation direkt ausführen:
./uipathctl.sh upgrade --install-type offline --steps {fabric | services}
.Sobald das Upgrade abgeschlossen ist, wird der Wartungsmodus automatisch deaktiviert.
Um zu überprüfen, ob die Automation Suite fehlerfrei ist, führen Sie Folgendes aus:
kubectl get applications -n argocd
Aktivieren der Sicherung nach dem Upgrade
Hinweis:
Stellen Sie sicher, dass die Automation Suite ausgeführt wird und Ihre Automatisierung wie erwartet fortgesetzt wird, bevor Sie mit den nächsten Schritten fortfahren.
Bevor mit dem Upgrade des Clusters begonnen wird, erstellt das Upgrade-Skript automatisch eine Sicherung des Clusters und deaktiviert sie dann vorübergehend. Möglicherweise möchten Sie die Sicherung manuell aktivieren, sobald das Upgrade abgeschlossen ist.
Führen Sie den folgenden Befehl auf einem beliebigen Serverknoten aus, um die Sicherung zu aktivieren:
# replace {version} with the version you are upgrading to
cd /opt/UiPathAutomationSuite/{version}/installer
./configureUiPathAS.sh resume-scheduled-backups
Vor etwa einem Monat aktualisiert