Installieren der Automation Suite

Auf dieser Seite werden Sie durch die allgemeinen Installationsanweisungen für die Automation Suite in AKS und EKS geführt.

Bevor Sie beginnen, sollten Sie Folgendes beachten:

• Zum Bereitstellen und Verwalten der Automation Suite in AKS/EKS sind Kenntnisse im Management von Kubernetes-, AWS- und Azure-Cloud-Ressourcen erforderlich. Wenn beim Installieren und Konfigurieren der Automation Suite in AKS/EKS Probleme auftreten, wenden Sie sich an die UiPath® Professional Services.

• Bevor Sie Ihr Bereitstellungsprofil auswählen, siehe Bereitstellungsszenarien.

• Bei der Installation werden selbstsignierte Zertifikate in Ihrem Namen generiert. Sie sollten sie durch Zertifikate ersetzen, die von einer vertrauenswürdigen Zertifizierungsstelle signiert wurden, sobald die Installation abgeschlossen ist. Anweisungen finden Sie unter Verwalten der Zertifikate.

• Die Automation Suite unterstützt die Aktivierung des Federal Information Processing Standard 140-2 (FIPS 140-2) auf AKS-Knoten. Weitere Informationen finden Sie unter Sicherheit und Compliance. Sie können FIPS 140-2 nicht auf EKS-Knoten aktivieren.

Schritt 1: Bereitstellen der Infrastrukturvoraussetzungen

Bevor Sie die Automation Suite installieren, müssen Sie die Cloud-Ressourcen in Ihrer Umgebung konfigurieren. Dies umfasst Folgendes:

• AKS- oder EKS-Cluster
• Obligatorisch für Offline-Installationen: externe OCI-konforme Registrierung
• Objektspeicher – Azure Blob oder Amazon S3
• Blockspeicher
• Dateispeicher
• Datenbanken
• Zwischenspeichern
• Netzwerke (z. B. VNETs/VPC, DNS, Subnetze, NSGs/Sicherheitsgruppen, NAT-Gateway, elastische IP- und Internetgateways)
• Netzwerkrichtlinien
• Zertifikat

Anweisungen zu den Voraussetzungen finden Sie unter Voraussetzungen im Überblick.

Optional: Konfigurieren des Proxys

Wenn Sie einen Proxyserver für den Datenverkehr mit dem Internet verwenden, müssen Sie eine Liste von URLs zulassen und die no_proxy -Einstellungen beim Konfigurieren des Proxys verwenden. Anweisungen zum Konfigurieren Ihres Proxys finden Sie unter Proxy.

Schritt 2: Konfigurieren der externen OCI-konformen Registrierung

Bei Offline-Installationen benötigen Sie eine Registrierung, die mit der OCI (Open Container Initiative) kompatibel ist, um die Container-Images und die Helm-Charts zu speichern.

Es gibt zwei Möglichkeiten, die Automation Suite-Artefakte in die externe OCI-konforme Registrierung hochzuladen:

• Option A: Durch Spiegeln Ihrer OCI-konformen Registrierung mit der UiPath®-Registrierung;
• Option B: Durch Hydratisieren Ihrer OCI-konformen Registrierung mit dem Offlinepaket.

Schritt 3: Herunterladen der Software auf Ihre Clientmaschine

Sie müssen die folgende Software auf Ihrer Verwaltungsmaschine installieren. Verwaltungsmaschine bezieht sich auf die Maschine, die Sie zum Betreiben Ihres Clusters verwenden und die über die Datei kubeconfig auf Ihren Cluster zugreifen kann. Auf Ihrer Verwaltungsmaschine kann Linux, Windows oder MacOS ausgeführt werden.

Die folgenden Tools sind erforderlich, um die Voraussetzungsprüfungen sowie die Installation und die Schritte nach der Installation in Ihrem Cluster erfolgreich über die Clientmaschine auszuführen.

Tool	Beschreibung	Herunterladen (Download)
uipathctl	Erforderlich. uipathctl ist ein UiPath®-Befehlszeilentool, mit dem Sie Befehle für Automation Suite Kubernetes ausführen können, das in Azure Kubernetes Service (AKS) und Amazon Elastic Kubernetes Service (EKS) gehostet wird. Sie können uipathctl verwenden, um die Voraussetzungen in Ihrer Umgebung zu überprüfen, Automation Suite zu installieren und sie über eine einzige einheitliche CLI zu konfigurieren und zu verwalten. Weitere Informationen, einschließlich einer vollständigen Liste der uipathctl -Vorgänge, finden Sie auf der Registerkarte.	uipathctl herunterladen uipathctl ausführen
versions.json	Erforderlich. Erforderlich zur Durchführung von Voraussetzungsprüfungen und Installationsschritten.	versions.json herunterladen
kubectl	Optional. Stellen Sie sicher, dass kubectl mit der Version Ihres Clusters übereinstimmt	kubectl herunterladen

Schritt 4: Konfigurieren von input.json

Sie müssen die Datei input.json bearbeiten, um die erforderlichen Eingaben für das uipathctl-Installationsprogramm bereitzustellen und Vorgänge wie das Konfigurieren der SQL-Verbindungszeichenfolgen und der UiPath®-Dienste auszuführen, die Sie aktivieren möchten.

Wir bieten verschiedene input.json -Vorlagendateien für AKS und EKS. Anweisungen zum Konfigurieren von input.jsonfinden Sie unter Konfigurieren von input.json.

Optional können Sie eigene Komponenten mitbringen, die Teil des Automation Suite -Stacks sind. Weitere Informationen zu den Komponenten finden Sie unter Automation Suite im EKS/AKS-Stack. Weitere Informationen zum Konfigurieren der von Ihnen mitgebrachten Komponente finden Sie unter Mitbringen eigener Komponenten.

Wenn Sie eine Offlineinstallation durchführen, stellen Sie sicher, dass Sie Ihre externe OCI-konforme Registrierung konfigurieren.

Um die Automation Suite auf EKS/AKS im Offlinemodus zu installieren, müssen Sie die folgenden zusätzlichen Schritte ausführen:

• Legen Sie den Wert des Parameters install_type in der Datei input.json explizit auf offlinefest;

• Konfigurieren Sie eine externe OCI-konforme Registrierung.

Schritt 5: Zugreifen auf Ihren Cluster mit uipathctl

uipathctl erfordert Zugriff auf den KubeAPI-Server, um Vorgänge auf Clusterebene wie Bereitstellung, Ressourcenerstellung usw. auszuführen. Um auf den KubeAPI-Server zuzugreifen, verwendet uipathctl die Datei kubeconfig , die die Anmeldeinformationen auf Administratorebene enthält, die für den Zugriff auf den Cluster erforderlich sind. Diese Datei muss sich im Ordner ~/.kube/config (Standardspeicherort) Ihrer lokalen (Verwaltungs-)Maschine befinden.

Wenn Sie Bedenken haben, dass die kubeconfig -Datei am Standardspeicherort gespeichert werden soll, können Sie sie alternativ mit Hilfe des --kubeconfig -Flags bei jeder Ausführung von uipathctlbereitstellen.

Sie können beispielsweise Ihre bevorzugte Methode verwenden, um Ihre ~/.kube/config-Datei mithilfe der AWS CLI oder Azure CLI zu aktualisieren.

Schritt 6: Überprüfen der Infrastrukturvoraussetzungen

Voraussetzungsprüfungen stellen sicher, dass die erforderliche Cloud-Infrastruktur entsprechend bereitgestellt wird und für den Client-Computer vor dem Start der Installation der Automation Suite zugänglich ist.

Das Installationsprogramm kann die folgenden Konfigurationen automatisch in Ihrem Namen generieren:

• Die SQL-Datenbanken, die für die Installation auf dem SQL-Server erforderlich sind, basieren darauf, ob der sql.create_db -Schlüssel in Ihrer input.json -Datei festgelegt ist.
• Die in Ihrem Cloud -Anbieter erforderlichen Objektspeicher-Buckets, wenn der external_object_storage.create_bucket -Schlüssel in der Konfigurationsdatei festgelegt ist.

Damit das Installationsprogramm diese Konfigurationen generieren kann, führen Sie den folgenden Befehl aus:

uipathctl prereq create input.json --versions versions.json

Wichtig:

Der Befehl uipathctl prereq create erstellt nicht die erforderlichen SQL-Datenbanken für Process Mining. Sie müssen sie manuell erstellen, indem Sie den Anweisungen unter Mitbringen Ihrer eigenen Datenbank folgen.

Um die Voraussetzungen basierend auf den Eingaben zu überprüfen, die Sie in input.jsonkonfiguriert haben, führen Sie den folgenden Befehl aus:

uipathctl prereq run input.json --versions versions.json

Um die Voraussetzungen für die Installation zu überprüfen, führen Sie aus. Standardmäßig überprüft der Befehl alle Voraussetzungen. Allerdings ermöglicht er Ihnen auch, nur die für Sie relevanten Prüfungen durchzuführen:

• Wenn Sie Komponenten von der Ausführung ausschließen möchten, verwenden Sie das Flag --excluded. Wenn Sie beispielsweise die Datenbankverbindungszeichenfolgen nicht überprüfen möchten, führen Sie uipathctl prereq --excluded SQL aus. Der Befehl führt alle Prüfungen der Voraussetzungen durch, außer der SQL-Prüfung.
• Wenn Sie nur bestimme Komponenten in die Ausführung einschließen möchten, verwenden Sie das Flag --included. Wenn Sie beispielsweise nur das DNS und den Objektspeicher überprüfen möchten, führen Sie uipathctl prereq --included DNS,OBJECTSTORAGE aus.

Hinweis:

Die Namen der Komponenten, die Sie bei den Voraussetzungsprüfungen ein- oder ausschließen können, finden Sie hier. In diesem Beispiel stellt das erste Wort auf jeder eingerückten Zeile den Komponentennamen dar. Beispiel: SQL, OBJECTSTORE, DNS usw.

Wichtig: Möglicherweise erhalten Sie eine Drosselungsmeldung von AKS, z. B. 1,0447523s gewartet aufgrund der clientseitigen Drosselung, nicht der Priorität und der Billigkeit. Warten Sie in diesem Fall einige Minuten, bis der Befehl vollständig abgeschlossen ist, oder versuchen Sie, ihn erneut auszuführen.

Ein Beispiel für ein Ausgabeergebnis finden Sie unter Ausgabebeispiel : Überprüfung der Voraussetzungen.

Voraussetzungsprüfungen

Es wird empfohlen, Voraussetzungsprüfungen durchzuführen, um sicherzustellen, dass Sie die Cloud-Infrastruktur ordnungsgemäß konfiguriert haben, und um input.json zu validieren, bevor Sie die Automation Suite installieren.

Sie können eine Voraussetzungsprüfung mit dem Befehl durchführen. Standardmäßig überprüft dieser Befehl alle Voraussetzungen. Sie können die folgenden Flags verwenden:

• --excluded, wenn Sie Komponenten von der Ausführung ausschließen möchten.
• --verbose, wenn Sie auf die detaillierte Ausgabe der Voraussetzungen zugreifen möchten. Sie können dieses Flag überspringen, um eine präzisere und vereinfachte Ausgabe zu erhalten.

Die Voraussetzungs- und Zustandsprüfungen/-tests werden im Namespace uipath-check ausgeführt. Sie müssen entweder die Erstellung des Namespace uipath-check zulassen oder ihn selbst erstellen, bevor Sie die Prüfungen/Tests ausführen. Zudem erfordern einige Prüfungen/Tests, dass Sie die Kommunikation zwischen den Namespaces uipath-check und uipath zulassen oder dass Sie die Verwendung von hostNetwork aktivieren.

Die Überprüfungen in der folgenden Tabelle werden auf jedem Knoten ausgeführt:

Prüfen (Check)	Beschreibung
SQL-Verbindung	Überprüft, ob die Automation Suite erfolgreich eine Verbindung mit dem SQL-Server für UiPath®-Produkte und gemeinsame Dienste (z. B. Identität, Portal, Organisationsverwaltung usw.) mithilfe der in input.json bereitgestellten SQL-Verbindungszeichenfolgen herstellen kann. Das ist für eine erfolgreiche Installation obligatorisch.
SQL DB-Rollen	Überprüft die erforderlichen Rollen und Berechtigungen für UiPath®-Produkte. Das ist für eine erfolgreiche Installation obligatorisch.
SQL DB-Kompatibilität	Validiert die SQL-DB-Kompatibilitätsanforderungen.
Auflösung des FQDN	Überprüft, ob der FQDN und die Unterdomänen erfolgreich aufgelöst werden können.
Object Storage-API	Überprüft, ob Objektspeicher-APIs basierend auf den in input.json bereitgestellten Zugriffsinformationen zugänglich sind. Das ist für eine erfolgreiche Installation der UiPath®-Dienste obligatorisch.
Cache/Redis	Validiert die Verbindung mit Cloud Redis oder ElastiCache. Dies ist für eine erfolgreiche Installation obligatorisch.
Kapazität	Überprüft die Mindest-CPU- und RAM-Kapazität Ihrer Worker-Knoten basierend auf den in input.jsonaktivierten Produkten.
Speicherklasse	Überprüft, ob die Speicherklassen für den Dateispeicher für Automation Suite Robotnach Bedarf konfiguriert sind.
Optionale Komponenten	Überprüft, ob Ihr Cluster über Komponenten verfügt, die Sie von der Automation Suite -Installation ausgeschlossen haben.
Ingress	Überprüft, ob der Cluster-Ingress korrekt konfiguriert ist und die FQDN-URL-Anforderungen UiPath®-Produkte erreichen können.
Netzwerkrichtlinien	Überprüft, ob die in der Automation Suite konfigurierten Netzwerkrichtlinien mit dem Cluster kompatibel sind.
Registrierung	Überprüft, ob die Automation Suite auf die UiPath®-Docker-Registrierung zugreifen kann. Das ist für eine erfolgreiche Installation obligatorisch.
Cluster-Konnektivität	Überprüft, ob die Clusterkommunikation richtig konfiguriert ist: Zwischen zwei zufälligen Pods abgeschlossen Zwischen Pod zu einem ClusterIP mit mehreren Knoten Zwischen einem Pod zu einer ClusterIP mit mehreren Knoten ohne clusterIP Zwischen einem Pod zu einem ClusterIP mit mehreren Knoten unter Verwendung von HostNetwork Zwischen einem Pod zu einem ClusterIP mit mehreren Knoten, ohne dass ein clusterIP mit HostNetwork festgelegt wurde Zwischen zwei Pods, die sich auf demselben Knoten über ClusterIP . befinden

Schritt 7: Installieren der Automation Suite

Hinweis:

Um zu sehen, welche Bereitstellungsszenarien für die Automation Suite auf AKS/EKS verfügbar sind, siehe Bereitstellungsszenarien.

1. Nachdem Sie die Voraussetzungen erfolgreich validiert haben, können Sie mit der Installation der Automation Suite fortfahren, indem Sie den folgenden Befehl ausführen:

   uipathctl manifest apply input.json --versions versions.json

   Ein Ausgabebeispiel finden Sie unter Ausgabebeispiel : Installation der Automation Suite .
   Hinweis:

   Wenn bei der Ausführung der Installation Probleme auftreten, führen Sie den Befehl der Installationsbefehle mit allen Argumenten und Flags erneut aus. Weitere Informationen zu den Problemen, die auftreten können, finden Sie unter Fehlerbehebung.

2. Um zu überprüfen, ob Ihre Installation erfolgreich ist und die Dienste fehlerfrei sind, führen Sie den folgenden Befehl aus:

   uipathctl health check