Abschließen eines Upgrades

Context

Nach dem Ausführen eines Automation Suite-Cluster-Upgrades sind einige Änderungen erforderlich, um sicherzustellen, dass ein neuer Knoten dem Cluster ordnungsgemäß beitritt. Um die Änderungen zu automatisieren, empfehlen wir die Verwendung des Skripts upgradeUiPathAS.sh.

Diese Seite enthält Anweisungen zum Ersetzen der benutzerdefinierten Skripterweiterung (Custom Script Extension, CSE) in den Rechenressourcen, damit beim Upgrade auf eine neue Automation Suite-Version neue Knoten zu Ihrem Cluster hinzugefügt werden können.

Der in den folgenden Abschnitten beschriebene Prozess lädt die Skripts herunter, die erforderlich sind, um einige kleinere Änderungen an den Azure-Ressourcen durchzuführen und einige Voraussetzungen zu validieren. Die Skripts befinden sich in den Ordnern <targetVersion> und Modules. Wenn der Prozess fehlschlägt, werden Sie gefragt, ob Sie die Dateien behalten möchten.

Nachdem sichergestellt wurde, dass die Voraussetzungen gültig sind, werden die CustomScriptExtension-Objekte auf allen unseren Rechenressourcen aktualisiert, sodass neu hinzugefügte Knoten die Automation Suite <targetVersion>verwenden. Schließlich werden die Dateien auf den anfänglichen Clusterknoten überschrieben, sodass sie auch mit den Dateien aus der <targetVersion>übereinstimmen.

Vorbereitung

Voraussetzungen

Stellen Sie sicher, dass Sie die folgenden Anforderungen erfüllen:

• Sie müssen die der Bereitstellung zugeordnete verwaltete Dienstidentität (Managed Service Identity, MSI) (mit dem Namen <basename>-MSI) als eine vom Benutzer zugewiesene Identität allen Skalierungsgruppen/virtuellen Maschinen in der Bereitstellung hinzufügen. Wechseln Sie dazu zu Skalierungsgruppe/virtuelle Maschine > Identität > Benutzer zugewiesen > Hinzufügen. Neuere Versionen von Automation Suite-Vorlagen haben diese möglicherweise bereits hinzugefügt.
• Sie müssen den vorhandenen MSI-Rechten zum Lesen/Schreiben/Verwalten von Geheimnissen im bereitgestellten Keyvault (mit dem Namen <basename>-VAULT) erteilen. Wechseln Sie dazu zum Keyvault, klicken Sie auf Zugriffsrichtlinien, dann auf Hinzufügen, wählen Sie alle geheimen Vorgänge, dann die MSI sowie Hinzufügen aus.
• Überprüfen Sie die Datei cluster_config.json und ändern Sie alle booleschen Werte, die als String ("true"/"false") markiert sind, in tatsächliche boolesche Werte (true/false). Zum Beispiel:
  • Um die Widerstandsfähigkeit von Zonen zu aktivieren, verwenden Sie "zone_resilience": true.
  • Damit das Installationsprogramm die Datenbanken erstellen kann, verwenden Sie "sql.create_db": true.
• Stellen Sie sicher, dass Ihre RHEL-Version für die Skalierungsgruppen für virtuelle Maschinen (Server, Agent usw.) aktualisiert ist und mit der Version übereinstimmt, auf die Sie aktualisieren.
• Wenn Sie ein Upgrade von der Automation Suite 2022.10 auf die Automation Suite 2023.4 oder höher durchführen und der Orchestrator sowohl auf der alten als auch auf der neuen Version aktiviert ist, müssen Sie das Flag orchestrator.block_classic_executions in der cluster_config.json-Datei auf true festlegen. Die Verwendung des Flags zeigt, dass Sie mit dem Blockieren klassischer Ordnerausführungen einverstanden sind. Wenn das Flag in diesem Szenario nicht verwendet wird, schlägt der Upgradevorgang fehl. Dieser Parameter ist bei Neuinstallationen nicht erforderlich.
• Wenn Sie auf die Automation Suite 2023.10 oder höher aktualisieren und Insights sowohl in der alten als auch in der neuen Umgebung aktiviert ist, müssen Sie das Flag insights.external_object_storage.bucket_name auf denselben Bucket festlegen, der für platform in der cluster_config.json-Datei verwendet wird. Wenn das Flag in diesem Szenario nicht verwendet wird, schlägt der Upgradevorgang fehl. Dieser Parameter ist bei Neuinstallationen nicht erforderlich.
• Wenn Sie auf die Automation Suite 2023.10 oder höher aktualisieren, stellen Sie sicher, dass Sie die folgenden Felder in cluster_config.json ausfüllen, wenn sql.create_db auf true festgelegt ist:

  sql.server_url = "<db_endpoint>"
  sql.port = "1433"
  sql.username = <SQL Username>
  sql.password = <SQL password>

• Exportieren Sie nach dem Upgradeprozess den neuen cluster_config.json-Dateiinhalt in ein geheimes Azure Key Vault-Geheimnis mit dem Namen clusterConfig im Schlüsseltresor der Bereitstellung (Details finden Sie im vorherigen Listenelement). Verwenden Sie den Wert des Felds FixedRKEAddress als IP des internen Lastausgleichs. Führen Sie dazu einen Befehl ähnlich dem folgenden aus:

  az keyvault secret set --name clusterConfig --vault-name "<vaultName>" --value "$(cat path/to/cluster_config.json)

• Auf der Maschine, auf der das Upgrade-Skript ausgeführt wird, müssen Sie bei Azure angemeldet sein und den Kontext auf das richtige Abonnement festlegen. Das Konto muss die Rolle Owner in der Ressourcengruppe haben, in der der Cluster bereitgestellt wurde.

Überlegungen und Empfehlungen

Bevor Sie mit dem Upgrade beginnen, sollten Sie die folgenden Empfehlungen berücksichtigen:

• Es wird dringend empfohlen, auf die neueste RHEL-Betriebssystemversion zu aktualisieren, die von der Automation Suite unterstützt wird. Weitere Informationen finden Sie unter Hardwareanforderungen.
• Bevor Sie das Upgrade starten, können Sie zwei Container mit den Namen logs und flags im Bereitstellungsspeicherkonto (mit dem Namen <basename>st) erstellen. Wenn Sie diese nicht erstellen, kann das Upgrade-Skript dies für Sie übernehmen.
• Wenn an die bereitgestellten Serverskalierungsgruppen kein Ceph-Datenträger angefügt ist, erstellt das Skript einen und fügt ihn an die Serverskalierungsgruppe an.
• Der Upgradeprozess ändert das VMSS-Modell, wendet es jedoch nicht auf ältere Instanzen an.
• Bei der Durchführung eines Upgrades für einen Cluster, der mit Azure-Vorlagen bereitgestellt wurde, kann ein Fehler auftreten, der ähnlich wie in der folgenden Abbildung dargestellt ist:
  
  

  

  
  
  Dies liegt an der Funktionsweise des Azure-Lastenausgleichs. Um das Problem zu beheben, ändern Sie das Feld fixed_rke_address in der Datei cluster_config.json. Sie müssen den Wert dieses Felds in die IP-Adresse der ersten Serverinstanz ändern, bevor Sie den Upgrade-Befehl ausführen. Die in den Schlüsseltresor hochgeladene cluster_config.json sollte weiterhin die IP-Adresse des ILB haben, da der Knoten nicht fehlerfrei ist und der Datenverkehr nicht darauf verteilt wird.

Ausführung

Führen Sie die folgenden Schritte aus, um erfolgreich ein Upgrade auf eine neue Version der Automation Suite vorzunehmen:

1. Laden Sie das upgradeUiPathAS.sh-Skript hier herunter.
2. Navigieren Sie zu dem Pfad, in den Sie das Skript heruntergeladen haben, und führen Sie den folgenden Befehl aus: chmod +x ./upgradeUiPathAS.sh.
3. Führen Sie den Upgradeprozess im interaktiven oder nicht interaktiven Modus in einer Linux-Umgebung aus:

   • Option A: Um den Prozess im interaktiven Modus auszuführen, verwenden Sie den folgenden Befehl:

     sh upgradeUiPathAS.sh --targetVersion {ASversion}

     Das Skript fordert Sie während der Ausführung auf, eine Reihe von Parametern anzugeben. Weitere Informationen zu den erforderlichen Parametern finden Sie unter Bereitstellen der Automation Suite in Azure.

   • Option B: Um den Prozess in einem nicht-interaktiven Modus auszuführen, gehen Sie wie folgt vor:

     1. Erstellen Sie einen <targetVersion> Ordner neben dem heruntergeladenen Skript.
     2. Erstellen Sie im Ordner <targetVersion> eine Datei mit dem Namen paramValues.json mit der folgenden Struktur:
        { "param1":"value1", "param2":"value2" }.

        Weitere Informationen zu den erforderlichen Parametern finden Sie unter Bereitstellen der Automation Suite in Azure.

     3. Führen Sie das Skript upgradeUiPathAS.sh aus:

        sh upgradeUiPathAS.sh --targetVersion {ASversion} --uninteractive true

        Hinweis: Stellen Sie sicher, dass Sie {ASversion} in den oben genannten Befehlen durch die Automation Suite-Version ersetzen. Die Version der Automation Suite kann sich von der Version der Azure-Vorlage unterscheiden.

Parameter

Beschreibungen der Parameter, die zum Aktualisieren auf eine bestimmte Automation Suite-Version erforderlich sind, finden Sie in der Datei cluster_config.json. Sie finden die cluster_config.json-Datei unter diesem Link.