Schritt 3: Schritte nach der Bereitstellung

Schließen Sie die Verifizierungs- und Konfigurationsschritte nach der Bereitstellung nach der Installation der Automation Suite in der Azure-Infrastruktur ab.

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

Der Installationsprozess generiert selbstsignierte Zertifikate in Ihrem Namen. Diese Zertifikate sind mit FIPS 140-2 konform. Die Azure-Bereitstellungsvorlage bietet Ihnen 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.

Wenn Sie die Automation Suite auf einem FIPS 140-2-fähigen Host installiert haben und die Zertifikate aktualisieren möchten, stellen Sie sicher, dass sie mit FIPS 140-2 kompatibel sind.

Anweisungen finden Sie unter Verwalten von Zertifikaten.

Aktivieren von FIPS 140-2

Nach Abschluss einer Automation Suite-Installation mit der Azure-Bereitstellungsvorlage können Sie FIPS 140-2 auf Ihren Maschinen aktivieren. Anweisungen finden Sie unter Sicherheit und Compliance.

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	Die URL für den Zugriff auf ArgoCD. Diese ist im VNet verfügbar. Der externe Zugriff auf diese URL muss wie hier beschrieben eingerichtet werden: Schritt 4: Konfigurieren des DNS.
ArgoCDPassword	Das Kennwort, mit dem Sie sich beim ArgoCD-Portal anmelden.
HostAdminUsername und HostAdminPassword	Die für die Hostverwaltung verwendeten Anmeldeinformationen.
ClusterAdministrationURL	Die URL für das Clusterverwaltungsportal.
DashboardMonitoringURL	Die URL zu den Dashboard-Überwachungstools (Grafana): https://monitoring.<fqdn>/dashboard. Ersetzen Sie <fqdn> durch Ihren FQDN.
MetricsMonitoringURL	Die URL zu den Metriken (Prometheus)-Überwachungstools: https://monitoring.<fqdn>/metrics. Ersetzen Sie <fqdn> durch Ihren FQDN.
AlertmanagerMonitoringURL	Die URL zu den Alertmanager-Überwachungstools: https://monitoring.<fqdn>/alertmanager. Ersetzen Sie <fqdn> durch Ihren FQDN.

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 wählen Sie dann Geheimnisse aus.

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 und dann 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

Wie in Schritt 1: Vorbereiten Ihrer Azure-Bereitstellung erwähnt, erstellt die Automation Suite Azure-Bereitstellung einen Lastausgleich mit einer öffentlichen IP und einer zugehörigen DNS-Bezeichnung. Diese DNS-Bezeichnung befindet sich im Besitz von Microsoft.

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.

Weitere Informationen finden Sie unter Schritt 4: Konfigurieren des DNS .

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

Zugriff auf das Clusterverwaltungsportal

Das Clusterverwaltungsportal ist ein zentraler Ort, an dem Sie alle Ressourcen finden, die zum Abschließen einer Automation Suite-Installation und zur Durchführung allgemeiner Vorgänge nach der Installation erforderlich sind. Weitere Informationen finden Sie unter Erste Schritte mit dem Clusterverwaltungsportal.

Um auf das Clusterverwaltungsportal zuzugreifen, führen Sie den folgenden Schritt aus:

Gehen Sie zur folgenden URL: https://${CONFIG_CLUSTER_FQDN}/uipath-management.

Hinweis:

You do not need any credentials to access the Cluster Administration portal.

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.

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. Gehen Sie zur folgenden URL: https://alm.${Loadbalancer_dns}, wobei <loadbalancer_dns> die DNS-Bezeichnung für den Lastausgleich ist und unter Ausgaben zu finden ist. Beachten Sie, dass Sie den externen Zugriff auf diese URL konfigurieren müssen, wie in Schritt 4: Konfigurieren des DNS beschrieben.
2. Der Benutzername ist admin.
3. Um auf das Kennwort zuzugreifen, wechseln Sie zur Registerkarte Ausgaben oder zum Keyvault der Anmeldeinformationen.

Zugreifen auf die Überwachungstools

Um zum ersten Mal auf die Überwachungstools zuzugreifen, melden Sie sich als Administrator mit den folgenden Standardanmeldeinformationen an:

• Benutzername: admin
• Kennwort: Um das Kennwort abzurufen, führen Sie den folgenden Befehl aus:

  kubectl get secrets/dex-static-credential -n uipath-auth -o "jsonpath={.data['password']}" | base64 -d
  

Führen Sie die folgenden Schritte aus, um das Standardkennwort zu aktualisieren, das für die Dex-Authentifizierung beim Zugriff auf die Überwachungstools verwendet wird.

1. Führen Sie den folgenden Befehl aus, indem Sie <your-password> durch Ihr neues Kennwort ersetzen:

   password="<your-password>"
   password=$(echo -n $password | base64)
   kubectl patch secret dex-static-credential -n uipath-auth --type='json' -p="[{'op': 'replace', 'path': '/data/password', 'value': '$password'}]"
   

2. Führen Sie den folgenden Befehl aus, um das Kennwort zu aktualisieren:

   ./install-uipath.sh -i /opt/UiPathAutomationSuite/cluster_config.json -o ./output.json -f --accept-license-agreement
   

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.

Abschließen eines Upgrades

Nach dem Ausführen eines Automation Suite-Cluster-Upgrades erfordern Azure-Vorlagenbereitstellungen einige Änderungen, um sicherzustellen, dass ein neuer Knoten dem Cluster ordnungsgemäß beitritt. Um die Änderungen zu automatisieren, empfehlen wir die Verwendung des dedizierten Skripts. Anweisungen finden Sie in den Dokumenten zur Azure-Bereitstellungsvorlage.

Azure-VM-Lebenszyklusvorgänge

Tipp:

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.
The InstanceRefresh, RemoveNodes, RemoveServers, and CheckServerZoneResilience runbooks are supported only for multi-node HA-ready production deployments.
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.

Wichtig:

Die Runbooks InstanceRefresh, RemoveNodes und RemoveServers sind von einem Problem betroffen, das dazu führt, dass das Entfernen von Knoten fehlschlägt, wenn Sie Azure für die US-Regierung verwenden.

Hybrid-Worker

Alle unsere Speicherkonten und SQL-Server haben private Endpunkte. Eine Hybrid-Worker-Gruppe führt die vorhandenen automatisierten Vorgänge aus, damit sie problemlos funktionieren.

Ein Hybrid Worker ist eine VM, die sich innerhalb des VNET befindet und auf der die verschiedenen Automatisierungen ausgeführt werden.

Die VM ist in der Regel eine Standard_D2s_v3 oder eine Standard_F2s_v2, je nachdem, welche Sie für Ihre Server-VMs auswählen und ob das Kontingent zulässt. Die VM wird heruntergefahren, wenn die Bereitstellung abgeschlossen ist, um die Kosten zu minimieren.

Runbooks werden in zwei Kategorien unterteilt: reguläre Runbooks und hybride Runbooks. Sie verwenden die regulären Runbooks, um einen Vorgang zu starten und alle Daten zu sammeln. Das reguläre Runbook startet dann die Hybrid Worker-VM und das Hybrid-Runbook, wobei letzteres den Vorgang abschließt.

Wenn der Vorgang abgeschlossen ist, können Sie die Hybrid-Worker-VM ausschalten, um die Kosten zu begrenzen.

In der folgenden Tabelle wird die Runbookaufschlüsselung beschrieben:

Reguläre Runbooks	Hybrid-Runbooks
AddGpuNode	HybridAddGpuNode
BackupCluster	HybridBackupCluster
GetAllBackups	HybridGetAllBackups
InstanceRefresh	HybridInstanceRefresh (+HybridCheckServerZoneRezilience)
RegisterAiCenterExternalOrchestrator	HybridRegisterAiCenterExternalOrchestrator
RemoveNodes	HybridRemoveNodes
RemoveServers	HybridRemoveServers
RestoreClusterInitialize	HybridRestoreClusterInitialize + HybridRestoreClusterSnapshot
ValidateFullInstall	Wird am Ende der Bereitstellung ausgeführt, um die vollständige Installation zu validieren.

InstanceRefresh

Beschreibung

The InstanceRefresh runbook has the following use cases:

• 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. Go to the Azure Portal and search for the resource called InstanceRefresh.
2. Wählen Sie die Startschaltfläche aus, 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).

Wählen Sie die Schaltfläche OK aus, 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 Runbook InstanceRefresh drei neue Server. Andernfalls übernimmt RemoveNodes die Hochskalierung, um immer mindestens einen Server in jeder Verfügbarkeitszone beizubehalten.

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 wählen Sie Instances im Abschnitt Settings aus.

   

2. Go to the Azure Portal and search for the resource called RemoveNodes.

3. Wählen Sie die Startschaltfläche aus, um die Parameterliste zu öffnen. Vervollständigen Sie die Parameter unter Berücksichtigung von Folgendem:

• 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 and THREESERVERSSCENARIO are flags populated by the InstanceRefresh wrapper.

Wählen Sie die Schaltfläche OK aus, um das Runbook zu starten.

Implementierungsdetails

Das Runbook RemoveNodes hat einen rekursiven Ansatz, um das 3-Stunden-Zeitlimit für faire Freigabe zu überwinden. Es entfernt den ersten oder die ersten beiden Knoten (die Anzahl wird gewählt, um die ungerade Anzahl von Servern zu erfüllen) aus der empfangenen Liste und führt eine weitere Instanz des Runbooks mit der verbleibenden Liste aus.

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

The RemoveServers runbook has the following use case:

• Entfernen Sie Server aus dem Automation Suite-Cluster.

Nutzung

1. Go to the Azure Portal and search for the resource called RemoveServers.
2. Wählen Sie die Startschaltfläche aus, um die Parameterliste zu öffnen. Vervollständigen Sie die Parameter unter Berücksichtigung von Folgendem:

• 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

The RemoveServers runbook removes the number of servers received as a parameter from the Availability Zones with the most VMs.

CheckServerZoneResilience

Beschreibung

The CheckServerZoneResilience runbook scales out the server VMSS and uses the RemoveServers runbook to balance the servers across Availability Zones. This is part of the InstanceRefresh flow and should not be run manually.

AddGpuNode

Beschreibung

In dem Szenario, in dem die ursprüngliche Bereitstellung ohne GPU-Knoten erstellt wurde, erstellen wir die VM-Skalierungsgruppe, haben aber eine andere SKU, um Probleme mit der Zonen-/SKU-Verfügbarkeit zu vermeiden. Dieses Runbook ändert die SKU in eine GPU-SKU und fügt einen Knoten hinzu.

Wichtig:

Skalieren Sie das ursprüngliche GPU-VMSS, das vor der Ausführung dieses Runbooks erstellt wurde, nicht, wenn die ursprüngliche Bereitstellung ohne GPU-Knoten erstellt wurde.

Nutzung

Führen Sie die folgenden Schritte aus, um dieses Runbook zu verwenden:

1. Navigieren Sie zu der Ressourcengruppe, in der Sie die Automation Suite bereitgestellt haben, identifizieren und wählen Sie dann das Automatisierungskonto aus .
2. Wählen Sie Runbooks und dann das Runbook AddGPUNode aus.
3. Geben Sie einen Namen für die gewünschte SKU an und wählen Sie Starten aus.

Parameter:

skuName – Die SKU für das GPU Knoten-VMSS.

Zulässige Werte

• Standard_NC8as_T4_v3
• Standard_NC12s_v3
• Standard_NC24s_v3

RegisterAiCenterExternalOrchestrator

Beschreibung

Das Runbook registriert AI Center beim externen Orchestrator, das zum Zeitpunkt der Bereitstellung bereitgestellt wird.

Nutzung

Das Dokument macht einen einzelnen obligatorischen Parameter verfügbar, IdentityToken, bei dem es sich um ein Installationszugriffstoken handelt, das vom externen Identitätsdienst generiert wird. Da das Token nur eine kurze Verfügbarkeit hat (z. B. 1–2 Stunden), empfehlen wir, es kurz vor der Ausführung des Runbooks zu generieren. Anweisungen finden Sie unter Installationsschlüssel.

BackupCluster

Beschreibung

Das Runbook BackupCluster hilft Ihnen bei der Sicherung Ihres Clusters.

Nutzung

1. Navigieren Sie zu der Ressourcengruppe, in der Sie die Automation Suite bereitgestellt haben, identifizieren und wählen Sie dann das Automatisierungskonto aus .

   

2. Wählen Sie Runbooks und dann das Runbook BackupCluster aus.

   

3. Geben Sie einen Namen für die Sicherung an, die Sie erstellen möchten.

   

4. Um eine Sicherung für den Automation Suite-Cluster zu starten, wählen Sie oben auf der Seite die Taste Start .

   

5. Sobald der Status des Runbookauftrags Completed ist, ist der Sicherungsvorgang abgeschlossen. Wenn der Status des Runbookauftrags Failed ist, können Sie die Protokolle im Speicherkonto auf weitere Informationen überprüfen.

   

GetAllBackups

Beschreibung

The GetAllBackups runbook helps you view a list of all available backups, both scheduled and manual.

RestoreClusterInitialize, RestoreSnapshot

Beschreibung

Diese Runbooks helfen Ihnen, eine Wiederherstellung des Clusters durchzuführen.

Nutzung

Hinweis:

Beim Starten des Wiederherstellungsprozesses versetzen wir den Cluster in den Wartungsmodus. Sobald der Wiederherstellungsprozess erfolgreich ist, beenden wir den Wartungsmodus des Clusters.

Führen Sie die folgenden Schritte aus, um einen Wiederherstellungsvorgang durchzuführen:

1. Identify the restore files you want to use. To do this, navigate to your Automation Suite deployment Automation Account, and run the GetAllBackups runbook.

   

   

2. Wenn der Runbookauftrag abgeschlossen ist, suchen Sie unten auf der Registerkarte Ausgabe nach einer Liste der verfügbaren Sicherungen. Wählen Sie diejenige aus, die Sie im Wiederherstellungsvorgang verwenden möchten, und kopieren Sie sie.

3. Navigate back to the Automation Account and run the RestoreClusterInitialize runbook. For the parameter, paste the name of the previously copied backup file. At this point, the restore process is started.

   

4. The RestoreSnapshot job is started automatically. When the job is done, the restore process is complete.

   Hinweis:

   Protokolle sind im Speicherkonto (mit st endend) im Sicherungscontainer im Ordner restores/<backup-name>/ vorhanden, wobei backup-name der Name der Sicherung ist, die zum Durchführen der Wiederherstellung verwendet wird.

5. Nach einer Wiederherstellung sollten Sie sich vergewissern, dass sich der Cluster in einem guten Status befindet (weitere Informationen finden Sie unter Validieren der Installation oder einen beliebigen Link zur ArgoCD-Fehlerbehebung). Danach haben Sie die Möglichkeit, die Sicherung auf dem Cluster zu aktivieren, indem Sie das Runbook RestoreClusterFinalize mit demselben Parameter wie im vorherigen Schritt ausführen. Dadurch werden Sicherungen für den Cluster aktiviert.

Fehlersuche und ‑behebung

• Falls eine VM nicht dem Automation Suite-Cluster beitreten kann, wird ein Rollback versucht. Die neu erstellten VMs führen die gleichen Schritte wie beim Entfernen eines üblichen Knotens aus (cordon, per Drain, rke-Dienst beenden, Knoten aus dem Cluster entfernen und die VMs löschen). Sie finden die Protokolle aus dem Verfahren zum Verbinden von Knoten im Speicherkonto innerhalb des Protokollcontainers in Blobs wie infra-<hostname>.log.
• In case of a failure while deleting nodes, any runbook will stop and display the logs for the step that failed. Fix the issue, complete the process manually or using the RemoveNodes runbook. You can find all the logs in the storage account, inside the logs container, as follows:
  • Absperrung und Entleerung – <timestamp>-<runbook_abreviation>-drain_nodes.log
  • Beenden Sie den rke-Dienst – <timestamp>-<runbook_abreviation>-stop_rke.log
  • Entfernen Sie den Knoten aus dem Cluster – <timestamp>-<runbook_abreviation>-remove_nodes.log
• Bei einer Zeitüberschreitung sollten Sie warten, bis der Schritt seine Ausführung abgeschlossen hat, die Protokolle überprüfen und den Prozess manuell oder mithilfe des Runbooks RemoveNodes abschließen. Alle Runbooks verwenden die Funktion Azure Run Command , um Code im Kontext der VMs auszuführen. Eine Einschränkung dieser Methode besteht darin, dass sie den Status der Ausführung nicht zurückgibt. Daher werden die Schritte zum Sperren, Entleeren und Beenden des rke-Diensts asynchron ausgeführt und der Status wird mit Blobs im folgenden Format beibehalten: <timestamp>-<runbook_abreviation>-<step_name>.<success/fail>.