Schritt 3: Schritte nach der Bereitstellung

Hinweis:

Denken Sie bei der Verwendung von Azure Bastion daran, dass das Kopieren und Einfügen von Befehlen, die mit \ über mehrere Zeilen verteilt sind, möglicherweise nicht wie erwartet funktioniert. Um sicherzustellen, dass neue Zeilen korrekt interpretiert werden, verwenden Sie das Zwischenablage-Widget der Konsole.

Überprüfen der Installation

Um zu überprüfen, ob die Automation Suite erfolgreich installiert wurde, müssen Sie zum Speicherkonto im Flags -Container wechseln. Die Installation ist abgeschlossen, wenn der Inhalt der automatisch generierten Datei mit dem Namen installResult (im Container) successful ist. Der Inhalt ist failed , wenn die Installation fehlgeschlagen ist.

Aktualisieren der Zertifikate

Wichtig:

Bei der Installation werden selbstsignierte Zertifikate in Ihrem Namen erstellt. Die Azure-Bereitstellungsvorlage bietet Ihnen jedoch auch die Möglichkeit, zum Zeitpunkt der Installation ein von der Zertifizierungsstelle ausgestelltes Serverzertifikat bereitzustellen, anstatt ein automatisch generiertes, selbstsigniertes Zertifikat zu verwenden.

Selbstsignierte Zertifikate laufen in 90 Tagen ab und Sie müssen sie durch Zertifikate ersetzen, die von einer vertrauenswürdigen Zertifizierungsstelle signiert wurden, sobald die Installation abgeschlossen ist. Wenn Sie die Zertifikate nicht aktualisieren, funktioniert die Installation nach 90 Tagen nicht mehr.

For instructions, see Managing certificates.

Untersuchen von Flags und Protokollen

Wenn Sie weitere Informationen zum Installationsprozess der Automation Suite oder zu anderen Vorgängen benötigen, ist ein guter Ausgangspunkt das Speicherkonto, das zum Speichern verschiedener Flags und Protokolle während der Clusterbereitstellung und -wartung verwendet wird.

Führen Sie die folgenden Schritte aus, um das Speicherkonto zu finden:

1. Navigieren Sie zu der Ressourcengruppe, in der die Bereitstellung durchgeführt wurde.

2. Filtern nach Ressourcentyp Speicherkonto .

3. Suchen Sie das Speicherkonto, dessen Name mit st endet. Zum Beispiel:

   

4. Wählen Sie das Speicherkonto und dann Container aus. Ihre Optionen sind Flags und Protokolle.

   

Flags-Container

Der Flags- Container speichert verschiedene Flags oder Dateien, die für die Orchestrierung oder nur zum Melden des Status verschiedener Vorgänge erforderlich sind. In einem neuen Cluster sieht der Inhalt des Flags -Containers normalerweise wie im folgenden Beispiel aus:

Dateien in den Flags -Containern werden verwendet, um verschiedene Vorgänge zu orchestrieren, z. B. den Installationsprozess der Automation Suite im Cluster oder bestimmte Clustervorgänge, z. B. die Instanzaktualisierung. Zum Beispiel:

• uipath-server-000000.success gibt an, dass die Infrastrukturinstallation auf diesem bestimmten Knoten des Clusters erfolgreich abgeschlossen wurde;
• installResult liest success , wenn die Gesamtinstallation erfolgreich ist.

Protokoll-Container

Beim Ausführen eines Vorgangs wird normalerweise eine Protokolldatei im Protokollcontainer erstellt. In einem neuen Cluster sieht der Inhalt des Protokollcontainers normalerweise wie im folgenden Beispiel gezeigt aus:

Jede Datei im Protokollcontainer stellt die Protokolle für einen bestimmten Schritt des Installationsprozesses dar. Zum Beispiel:

• infra-uipath-server-000000.log speichert die Infrastrukturinstallationsprotokolle;
• fabric.log speichert die Protokolle für die Fabric-Installation;
• services.log speichert die Protokolle für die Installation der Anwendung und Dienste.

Zugreifen auf Bereitstellungsausgaben

Sobald die Installation abgeschlossen ist, müssen Sie auf der Registerkarte Ausgaben auf die Bereitstellungsausgaben zugreifen.

Gehen Sie dazu zu Ihrer Ressourcengruppe und dann zu Bereitstellungen → mainTemplate (oder z. B. Microsoft.Template-DateTime) → Ausgaben.

Bereitstellungsausgaben

Ausgabe	Beschreibung
Dokumentation	Ein Link zur Dokumentation.
URL	Die URL des Lastausgleichs. Kann für den direkten Zugriff verwendet werden. Wenn benutzerdefinierte Domänen aktiviert wären, ist dies die Domäne, die Sie für die CNAME-Bindung verwenden würden.
KeyVaultURL	Die Azure Portal-URL für den Key Vault, der durch die Bereitstellung erstellt wurde. Er enthält alle in der Bereitstellung verwendeten Geheimnisse (Anmeldeinformationen).
ArgoCDURL	The URL for accessing ArgoCD. This is available within the VNet. External access to this URL must be set up as described in: Step 4: Configuring the DNS.
ArgoCDPassword	Das Kennwort, mit dem Sie sich beim ArgoCD-Portal anmelden.
HostAdminUsername und HostAdminPassword	Die für die Hostverwaltung verwendeten Anmeldeinformationen.

Alle in der Bereitstellung verwendeten Anmeldeinformationen werden als Geheimnisse in einem Key Vault gespeichert, der während der Bereitstellung zur Verfügung gestellt wurde. Um auf die Geheimnisse zuzugreifen, filtern Sie die Ressourcen innerhalb der Ressourcengruppe, suchen Sie nach Vault und klicken Sie dann auf Geheimnisse.

Hinweis:

Wenn die Warnung The operation “List” is not enabled in the key vault’s access policy auf der Registerkarte Geheimnisse angezeigt wird, führen Sie die folgenden Schritte aus:

1. Gehen Sie zu Zugriffsrichtlinien → Zugriffsrichtlinie hinzufügen → Vorlage konfigurieren → Verwaltung von Geheimnissen → Prinzipal auswählen.
2. Wählen Sie Ihren Benutzer aus und klicken Sie dann auf Speichern.
3. Navigieren Sie zurück zu Geheimnisse. Die Warnung sollte weg und die Geheimnisse sichtbar sein.

Zugreifen auf Cluster-VMs

Die VMs werden innerhalb eines privaten VNet bereitgestellt. Sie können über Azure Bastion auf sie zugreifen, indem Sie die folgenden Schritte ausführen:

1. Navigieren Sie zur Ressourcengruppe, in der Sie die Automation Suite bereitgestellt haben.

2. Da sich Agenten, GPU-Agenten und Server-VMs in Skalierungsgruppen befinden, müssen Sie zu der Skalierungsgruppe wechseln, die die gewünschte Instanz enthält.

   

3. Wechseln Sie zum Abschnitt Instanzen auf der Registerkarte Einstellungen.

   

4. Wählen Sie den Namen der VM aus, die Sie verbinden möchten.

   

5. Wählen Sie die Schaltfläche Connect und dann Bastion aus dem Dropdownmenü aus.

   

6. Geben Sie die in der Bereitstellung bereitgestellten Anmeldeinformationen ein ( Parameter Administratorbenutzername und Administratorkennwort , die Sie im Keyvault der Anmeldeinformationen unter Geheimnisse finden ) und wählen Sie Verbinden aus.

   

DNS-Anforderungen

As mentioned in Step 1: Preparing your Azure Deployment, the Automation Suite Azure deployment creates a Load Balancer with a public IP and a DNS label associated. This DNS label is Microsoft-owned.

Die Bereitstellung stellt auch eine private DNS-Zone innerhalb des VNet-Clusters bereit und fügt mehrere Datensätze hinzu, die während der Installation und Konfiguration verwendet werden.

Wenn Sie eine Verbindung von einer externen Maschine aus herstellen möchten, können Sie die private DNS-Zone nicht für die Auflösung des DNS für verschiedene Dienste verwenden. Daher müssen Sie diese Datensätze zu Ihrer Hostdatei hinzufügen.

See Step 4: Configuring the DNS for more details.

Sie sollten nun in der Lage sein, eine Verbindung zu verschiedenen Diensten herzustellen, die in Ihrem Cluster ausgeführt werden.

Zugriff auf die allgemeine Benutzeroberfläche der Automation Suite

Die allgemeine Benutzeroberfläche der Automation Suite dient als Portal für sowohl Organisationsadministratoren als auch für Organisationsbenutzer. Dies ist eine allgemeine Ressource auf Organisationsebene, von der aus jeder auf alle Bereiche der Automation Suite zugreifen kann: Verwaltungsseiten, Seiten auf Plattformebene, dienstspezifische Seiten und benutzerspezifische Seiten.

Führen Sie die folgenden Schritte aus, um auf die Automation Suite zuzugreifen:

1. Gehen Sie zur folgenden URL: https://${Loadbalancer_dns}, wobei <loadbalancer_dns> die DNS-Bezeichnung für den Lastausgleich ist und unter den Ausgaben zu finden ist.
2. Wechseln Sie zur Standardorganisation.
3. Der Benutzername ist orgadmin.
4. Rufen Sie das Kennwort ab, indem Sie zu Keyvault und dann zu Geheimnisse wechseln; es befindet sich unter Hostadministratorkennwort.

Zugriff auf die Hostverwaltung

Im Hostportal konfigurieren Systemadministratoren die Automation Suite-Instanz. Die in diesem Portal konfigurierten Einstellungen werden von allen Ihren Organisationen übernommen; einige davon können auf Organisationsebene überschrieben werden.

See Managing system administrators for more on host administrators.

See Interface tour for more on the host portal.

Führen Sie die folgenden Schritte aus, um auf die Hostverwaltung zuzugreifen:

1. Gehen Sie zur folgenden URL: https://${Loadbalancer_dns}, wobei <loadbalancer_dns> die DNS-Bezeichnung für den Lastausgleich ist und unter den Ausgaben zu finden ist.
2. Wechseln Sie zur Host-Organisation.
3. Geben Sie den Benutzernamen ein, den Sie zuvor als Wert für den Parameter UiPath Admin Username angegeben haben.
4. Geben Sie das Kennwort ein, das sie zuvor als Wert für den Parameter UiPath Administratorkennwort angegeben haben. Rufen Sie das Kennwort ab, indem Sie zu Keyvault und dann zu Geheimnisse wechseln; es befindet sich unter Hostadministratorkennwort.

Zugreifen auf ArgoCD

Sie können die ArgoCD-Konsole verwenden, um installierte Produkte zu verwalten.

Führen Sie die folgenden Schritte aus, um auf ArgoCD zuzugreifen:

1. Go to the following URL: https://alm.${Loadbalancer_dns}, where <loadbalancer_dns> is the DNS label for the load balancer and is found under Outputs. Note that you must configure external access to this URL as described in Step 4: Configuring the DNS.
2. Der Benutzername ist admin.
3. Um auf das Kennwort zuzugreifen, wechseln Sie zur Registerkarte Ausgaben oder zum Keyvault der Anmeldeinformationen.

Zugreifen auf Rancher

Die Automation Suite verwendet Rancher, um Tools für die Clusterverwaltung standardmäßig bereitzustellen. Dies hilft Ihnen, den Cluster zu verwalten und auf die Überwachung und Fehlerbehebung zuzugreifen.

See Rancher documentation for more details.

See Using the monitoring stack for more on how to use Rancher monitoring in Automation Suite.

Um auf die Rancher-Konsole zuzugreifen, führen Sie die folgenden Schritte aus:

1. Wechseln Sie zur folgenden URL: https://monitoring.${Loadbalancer_dns}, wobei <loadbalancerdns> die DNS-Bezeichnung des Lastausgleichs ist und unter den Ausgaben Ihrer Bereitstellung zu finden ist.

2. Der Benutzername ist admin.

3. Führen Sie die folgenden Schritte aus, um auf das Kennwort zuzugreifen.

   kubectl get secrets/rancher-admin-password -n cattle-system \
   -o "jsonpath={.data['password']}" | echo $(base64 -d)
   

Skalieren Ihres Clusters

Die von der Bereitstellung zur Verfügung gestellten Ressourcen werden aus Azure-Skalierungsgruppen berechnet, was eine einfache Skalierung ermöglicht.

Sie können einer bestimmten Skalierungsgruppe manuell zusätzliche Ressourcen hinzufügen, einschließlich das Hinzufügen von Serverknoten, Agent-Knoten oder spezialisierten Agent-Knoten (z. B. GPU-Knoten).

Sie können eine manuelle Skalierung durchführen, indem Sie die spezifische Skalierungsgruppe identifizieren und Ressourcen direkt hinzufügen.

Führen Sie dazu die folgenden Schritte aus:

1. Wechseln Sie zum Azure-Portal und filtern Sie nach der spezifischen Skalierungsgruppe:

   

2. Wählen Sie die entsprechende Skalierungsgruppe und dann Skalierung aus.

   

3. Ändern Sie das Feld Instanzenanzahl entweder mit dem Schieberegler oder dem Eingabefeld daneben und wählen Sie dann Speichern.

   Hinweis:

   Bei Serverskalierungsgruppen muss die Instanzenanzahl eine ungerade Zahl sein.

4. Der Skalierung sollte im Hintergrund beginnen; nach Abschluss werden neue Ressourcen verfügbar.

Azure VM-Lebenszyklusvorgänge

Wichtig:

Azure gewährt ein Zeitfenster von höchstens 15 Minuten zum Herunterfahren, während die ordnungsgemäße Beendigung eines Automation Suite-Knotens zwischen 20 Minuten (für Agent- und GPU-Agent-Knoten) und Stunden ( bei Serverknoten) variiert.

Um Datenverluste zu vermeiden, ist die VMSS- Upgraderichtlinie des Servers auf „manuell“ festgelegt und bei den Server-VMs ist der Schutz für die Skalierungsgruppenaktionen aktiviert. Daher empfehlen wir, den Serverlebenszyklus über die bereitgestellten Runbooks zu verwalten.

Die Runbooks InstanceRefresh , RemoveNodes , RemoveServers und CheckServerZoneResilience werden nur für HA-fähige Produktionsbereitstellungen mit mehreren Knoten unterstützt.

Die Anzahl der Server nach der Ausführung eines Runbooks muss ungerade und größer als drei sein (z. B. können Sie keine Instanzaktualisierung ausführen, wenn Sie über 4 Server verfügen; Sie können keinen Server entfernen, wenn Sie insgesamt fünf haben).

Alle VMs in VMSSes sollten sich im Status Running befinden.

Es darf jeweils nur ein Runbook ausgeführt werden.

InstanceRefresh

Beschreibung

Das Runbook InstanceRefresh hat die folgenden Anwendungsfälle:

• Aktualisieren Sie die VMSS-Betriebssystem-SKU auf den Server-, Agent- und GPU-Skalierungsgruppen.
• Führen Sie einen Knotenrotationsvorgang für ein oder mehrere VMSSes aus.
• Andere VMSS-Konfigurationsänderungen, die zuvor auf das VMSS angewendet wurden.

Nutzung

1. Wechseln Sie zum Azure-Portal, und suchen Sie nach der Ressource mit dem Namen InstanceRefresh .

2. Klicken Sie auf die Schaltfläche Start, um die Parameterliste zu öffnen. Vervollständigen Sie die Parameter unter Berücksichtigung von:

   • Ein Knotenrotationsvorgang wird nur auf einem VMSS ausgeführt, wenn der Parameter REFRESH<node_type> auf True festgelegt ist. Wenn mehrere REFRESH<node_type> -Parameter auf True festgelegt sind, lautet die Rotationsreihenfolge der VMSS-Knoten Server -> Agents -> GPU-Agenten.

   • Sie müssen den Parameter NEWOSVERSION angeben, um die VMSS-Betriebssystem-SKU zu aktualisieren. Sie können die verfügbare Image-SKU der Azure Marketplace-VMs mithilfe von az vm image list-skus --location <deployment_location> --offer RHEL --publisher RedHat --output table finden. Die aktuellen VMs werden nicht automatisch auf das neueste Modell aktualisiert (dafür ist ein Knotenrotationsvorgang erforderlich).

     Klicken Sie auf die Schaltfläche OK, um das Runbook zu starten.

     

Implementierungsdetails

Das Runbook InstanceRefresh ist ein Wrapper für das Runbook RemoveNodes . Daher wird der Status während der Ausführung von RemoveNodes nachverfolgt. Es aktualisiert alle VMSS-Betriebssystemversionen (falls erforderlich) und extrahiert basierend auf den empfangenen Parametern den Hostnamen für den Knotenrotationsvorgang und leitet sie an RemoveNodes weiter. Wenn der Cluster genau drei Server hat, erstellt das InstanceRefresh -Runbook drei neue Server; Andernfalls übernimmt RemoveNodes die Hochskalierung, um immer mindestens einen Server in jeder Availability Zone zu unterhalten.

RemoveNodes

Beschreibung

Das Runbook RemoveNodes hat die folgenden Anwendungsfälle:

• Entfernen Sie die angegebenen Knoten aus dem Automation Suite-Cluster.
• Führen Sie einen Knotenrotationsvorgang für eine/zwei VMs durch.

Nutzung

1. Suchen Sie die Computernamen der Knoten, die Sie entfernen möchten. Wechseln Sie dazu zu einem VMSS und klicken Sie im Abschnitt Settings auf Instances .

   

2. Wechseln Sie zum Azure-Portal, und suchen Sie nach der Ressource mit dem Namen RemoveNodes .

3. Klicken Sie auf die Schaltfläche Start, um die Parameterliste zu öffnen. Vervollständigen Sie die Parameter unter Berücksichtigung der folgenden Punkte:

   • NODESTOBEREMOVEDCOMPUTERNAME ist eine durch Kommas getrennte Liste von Computernamen der VMs, die Sie löschen möchten (z. B. pxlqw-agent-000009,pxlqw-agent-00000A ), und es ist der einzige obligatorische Parameter. Wir empfehlen, Knoten jeweils aus einem einzelnen VMSS zu entfernen.

   • ISINSTANCEREFRESH und THREESERVERSSCENARIO sind Flags, die vom InstanceRefresh -Wrapper ausgefüllt werden.

     Klicken Sie auf die Schaltfläche OK, um das Runbook zu starten.

   

Implementierungsdetails

The RemoveNodes runbook has a recursive approach to overcome the 3-hour fair share timeout. It removes or repaves the first or the first two nodes (the number is chosen in order to fulfill the odd number of servers constraint) from the received list and reruns another instance of the runbook with the remaining list.

Der Vorgang zum Wiederherstellen des Knotens für einen Knoten erfordert die folgenden Schritte:

1. Skalieren Sie das VMSS mit einer oder zwei VMs basierend auf der Anzahl der Knoten, die entfernt werden.
2. Führen Sie die Knotenentfernung für die alten Instanzen durch.

Das Entfernen des Knotens für einen Knoten erfordert die folgenden Schritte:

1. Sperren und leeren Sie die Instanzen. Der Vorgang läuft nach 20 Minuten für einen Agenten und nach number_of_instances * 60 Minuten für Server ab.
2. Beenden Sie den rke-Dienst auf den Instanzen. Der Vorgang läuft nach 5 Minuten ab.
3. Entfernen Sie die Knoten aus dem Automation Suite-Cluster und löschen Sie die VMs. Der Vorgang läuft nach 20 Minuten für Agenten und number_of_instances * 60 Minuten für Server ab.

RemoveServers

Beschreibung

Das Runbook RemoveServers hat den folgenden Anwendungsfall:

• Entfernen Sie Server aus dem Automation Suite-Cluster.

Nutzung

1. Wechseln Sie zum Azure-Portal, und suchen Sie nach der Ressource mit dem Namen RemoveServers .
2. Klicken Sie auf die Schaltfläche Start, um die Parameterliste zu öffnen. Vervollständigen Sie die Parameter unter Berücksichtigung der folgenden Punkte:

• REMOVEDSERVERSCOUNT ist die Anzahl der Server, die entfernt werden. Es wird empfohlen, nicht mehr als zwei Server gleichzeitig zu entfernen, um das Timeout für die faire Freigabe nicht zu überschreiten.

  

Implementierungsdetails

Das Runbook RemoveServers entfernt die Anzahl der Server, die als Parameter aus den Availability Zones mit den meisten VMs empfangen wurden.

CheckServerZoneResilience

Beschreibung

Das CheckServerZoneResilience -Runbook skaliert das Server-VMSS und verwendet das RemoveServers -Runbook, um die Server über die Verfügbarkeitszonen hinweg auszugleichen. Dies ist Teil des InstanceRefresh -Flows und sollte nicht manuell ausgeführt werden.

Fehlersuche und ‑behebung

• Falls eine VM dem Automation Suite-Cluster nicht beitreten kann, wird ein Rollback versucht. Die neu erstellten VMs führen dieselben Schritte aus wie bei der üblichen Entfernung von Knoten (absperren, entleeren, den rke-Dienst anhalten, den Knoten aus dem Cluster entfernen und die VMs löschen). Sie finden die Protokolle aus der Prozedur zum Verbinden des Knotens im Speicherkonto im Protokollcontainer in Blobs wie infra-<hostname>.log .
• Wenn beim Löschen von Knoten ein Fehler auftritt, wird jedes Runbook angehalten und die Protokolle für den fehlgeschlagenen Schritt angezeigt. Beheben Sie das Problem, schließen Sie den Prozess manuell ab oder verwenden Sie das Runbook RemoveNodes . Sie finden alle Protokolle im Speicherkonto im Protokollcontainer wie folgt:
  • Absperren und Ablassen – <timestamp>-<runbook_abreviation>-drain_nodes.log
  • Stoppen Sie den rke-Dienst – <timestamp>-<runbook_abreviation>-stop_rke.log
  • Knoten aus dem Cluster entfernen – <timestamp>-<runbook_abreviation>-remove_nodes.log
• In case of a timeout, you should wait for the step to finish its execution, check the logs, and complete the process manually or using the RemoveNodes runbook. All runbooks use the Azure Run Command feature to execute code in the context of the VMs. One limitation of this method is that it does not return the status of the execution. Therefore, the steps for cordoning, draining, and stopping the rke service run asynchronous, and the status is kept with blobs in the following format: <timestamp>-<runbook_abreviation>-<step_name>.<success/fail>.