- Überblick
- Anforderungen
- Vor der Installation
- Vorbereiten der Installation
- Herunterladen der Installationspakete
- Konfigurieren der OCI-konformen Registrierung
- Erteilen von Installationsberechtigungen
- Installieren und Konfigurieren des Dienstgeflechts
- Installieren und Konfigurieren des GitOps-Tools
- Installieren des Operators „Externe Geheimnisse“ in Kubernetes
- Anwenden verschiedener Konfigurationen
- Ausführen von uipathctl
- Installation
- Nach der Installation
- Migration und Upgrade
- Überwachung und Warnungen
- Clusterverwaltung
- Produktspezifische Konfiguration
- Erweiterte Orchestrator-Konfiguration
- Konfigurieren von Orchestrator-Parametern
- Konfigurieren von AppSettings
- Konfigurieren der maximalen Anforderungsgröße
- Überschreiben der Speicherkonfiguration auf Clusterebene
- Konfigurieren von NLog
- Speichern von Roboterprotokollen in Elasticsearch
- Konfigurieren von Anmeldeinformationsspeichern
- Konfigurieren der Verwendung von einem Verschlüsselungsschlüssel pro Mandant
- Bereinigen der Orchestrator-Datenbank
- Installation der Hostbibliothek überspringen
- AI Trust Layer
- Fehlersuche und ‑behebung
- Das Sicherungssetup funktioniert nicht, da die Verbindung mit Azure Government fehlgeschlagen ist
- Hängende Pods im uipath-Namespace bei Aktivierung von benutzerdefinierten Knoten-Markierungen
- Automation Hub und Apps können mit Proxy-Setup nicht gestartet werden
- Die Velero-Sicherung schlägt mit dem Fehler „FehlgeschlageneValidierung“ fehl
- Fehlerbehebung bei externen Geheimnissen
- Temporär als Dienst-Fehlerbehebung
- AI Center und Document Understanding Pods können bei aktivierter TLS-Zertifikatsverifizierung nicht gestartet werden
- Validierungsfehler beim TLS-Zertifikat
- Fluentd exportiert keine Protokolle in IPv6-Umgebungen
- Studio Desktop kann keine Integration Service-Connectors und -Aktivitäten laden
- Manuelle Schadensbegrenzung bei ArgoCD NetworkPolicy (GHSA-47m3-95c7-g2g8)
- Konfigurieren von Ressourcenanforderungen und Limits für von uipathctl erstellte Workloads
Konfiguration des Objektspeichers, des Blockspeichers und des Dateispeichers für die Automation Suite auf EKS/AKS.
Zusätzlich zum Microsoft SQL-Server erfordert der Automation Suite-Cluster eine Speicherkomponente zum Speichern der Dateien. Die Automation Suite erfordert den Objektspeicher und den Block-/Dateispeicher, abhängig vom gewählten Diensttyp.
Speicherschätzung für jede Automation Suite-Komponente
UiPath®-Plattformdienste
Die folgenden Dienste erfordern die Speicherkomponente. Diese sind nur erforderlich, wenn Sie sich dafür entschieden haben, sie im Rahmen der Automation Suite Installation oder später zu aktivieren.
| Dienst | Speichertyp | Zweck | Schätzung |
|---|---|---|---|
| Orchestrator | Objektspeicher |
| In der Regel ist ein Paket 5 MB groß und Buckets, falls vorhanden, kleiner als 1 MB. Ein ausgereiftes Enterprise stellt etwa 10 GB an Paketen und 12 GB an Warteschlangen bereit. |
| Action Center | Objektspeicher |
| In der Regel benötigt ein Dokument 0,15 MB und die auszufüllenden Formulare weitere 0,15 KB. In einem ausgereiften Unternehmen kann dies insgesamt 4 GB betragen. |
| Test Manager | Objektspeicher |
| In der Regel haben alle Dateien und Anhänge zusammen etwa 5 GB. |
| Insights | Blockstore |
| Für die Aktivierung sind 2 GB erforderlich, wobei der Speicherplatzbedarf mit der Anzahl wächst. Eine etablierte Enterprise-Bereitstellung erfordert weitere GB für alle Dashboards. Etwa 10 GB Speicherplatz sollten ausreichen. |
| Integration Service | Objektspeicher |
| Connectors variieren in der Größe, aber die Installation aller verfügbaren Connectors sollte weniger als 100 MB verbrauchen. Die Anzahl der Triggerereignisse hängt von der Verwendung ab, aber 5 GB sollten ausreichen. |
| Studio Web | Dateispeicher |
|
|
| Apps | Dateispeicher |
| Ungefähr 5 GB für vorhandene App-Daten; Ungefähr 15 MB pro komplexer App. Zusätzlicher Speicherplatz für von Benutzern hochgeladene Anhänge erforderlich. |
| AI Center | Objektspeicher/Dateispeicher |
| Eine typische und etablierte Installation verbraucht 8 GB für fünf Pakete und weitere 1 GB für die Datasets. Eine Pipeline kann weitere 50 GB Blockspeicher verbrauchen, aber nur, wenn sie aktiv ausgeführt wird. |
| Document Understanding | Objektspeicher |
| In einer ausgereiften Bereitstellung werden 12 GB für das ML-Modell, 17 GB für die OCR und 50 GB für alle gespeicherten Dokumente verwendet. |
| Automation Suite-Roboter | Dateispeicher |
| In der Regel stellt ein ausgereiftes Unternehmen etwa 10 GB an Paketen bereit. |
| Process Mining | Objektspeicher |
| Der minimale Platzbedarf wird nur zum Speichern der SQL-Dateien verwendet. Etwa ein GB Speicherplatz sollte am Anfang ausreichen. |
| Kontextgrundlage | Objektspeicher, Dateispeicher |
|
|
| LLM-Beobachtbarkeit | Objektspeicher |
|
|
| Solutions (Lösungen) | Objektspeicher |
|
|
| Maestro | Objektspeicher |
|
|
| Autopilot for Developers | Objektspeicher |
|
|
Freigegebene Suite-Dienste
Die folgenden Shared Suite-Dienste erfordern die Speicherkomponente. Diese sind nur erforderlich, wenn Sie sich dafür entschieden haben, sie als Teil der Automation Suite Installation zu installieren.
| Dienst | Speichertyp | Zweck | Schätzung |
|---|---|---|---|
| Überwachung | Blockspeicher | Kubernetes und infrastrukturbezogene Metrikdaten | Ungefähr etwa 100 GB zum Speichern der Überwachungsdaten der letzten zehn Tage |
| Protokollierung | Blockspeicher | Anwendung läuft Protokolle | Ungefähr 20 GB zum Aufbewahren der Protokolle der letzten Tage |
Objektspeicher
Die Automation Suite unterstützt die folgenden Objektspeicher:
| Kubernetes | Objektspeicher | Unterstützte Authentifizierung |
|---|---|---|
| EKS | Amazon S3 |
|
| AKS | Azure Storage (Blob) |
|
*Insights unterstützt derzeit keine Workload-Identität für die Authentifizierung.
Konfigurieren der CORS-Richtlinie
Darüber hinaus müssen Sie möglicherweise die folgende CORS-Richtlinie auf Speicherkonto-/Bucket-Ebene aktivieren, wenn während der Verwendung des Automation Suite -Clusters während der S3-Verbindung ein CORS-Fehler auftritt.
Stellen Sie sicher, dass Sie {{fqdn}} durch den FQDN des Automation Suite-Clusters in der folgenden CORS-Richtlinie ersetzen.
Das folgende Beispiel zeigt die CORS-Richtlinie im JSON-Format:
[
{
"AllowedHeaders": [
"*"
],
"AllowedMethods": [
"POST",
"GET",
"HEAD",
"DELETE",
"PUT"
],
"AllowedOrigins": [
"https://{{fqdn}}"
],
"ExposeHeaders": [
"etag",
"x-amz-server-side-encryption",
"x-amz-request-id",
"x-amz-id-2"
],
"MaxAgeSeconds": 3000
}
]
[
{
"AllowedHeaders": [
"*"
],
"AllowedMethods": [
"POST",
"GET",
"HEAD",
"DELETE",
"PUT"
],
"AllowedOrigins": [
"https://{{fqdn}}"
],
"ExposeHeaders": [
"etag",
"x-amz-server-side-encryption",
"x-amz-request-id",
"x-amz-id-2"
],
"MaxAgeSeconds": 3000
}
]
Das folgende Beispiel zeigt die CORS-Richtlinie im XML-Format:
<CORSConfiguration>
<CORSRule>
<AllowedOrigin>{{fqdn}}</AllowedOrigin>
<AllowedMethod>HEAD</AllowedMethod>
<AllowedMethod>GET</AllowedMethod>
<AllowedMethod>PUT</AllowedMethod>
<AllowedMethod>POST</AllowedMethod>
<AllowedMethod>DELETE</AllowedMethod>
<AllowedHeader>*</AllowedHeader>
<MaxAgeSeconds>3000</MaxAgeSeconds>
<ExposeHeader>x-amz-server-side-encryption</ExposeHeader>
<ExposeHeader>x-amz-request-id</ExposeHeader>
<ExposeHeader>x-amz-id-2</ExposeHeader>
<ExposeHeader>etag</ExposeHeader>
</CORSRule>
</CORSConfiguration>
<CORSConfiguration>
<CORSRule>
<AllowedOrigin>{{fqdn}}</AllowedOrigin>
<AllowedMethod>HEAD</AllowedMethod>
<AllowedMethod>GET</AllowedMethod>
<AllowedMethod>PUT</AllowedMethod>
<AllowedMethod>POST</AllowedMethod>
<AllowedMethod>DELETE</AllowedMethod>
<AllowedHeader>*</AllowedHeader>
<MaxAgeSeconds>3000</MaxAgeSeconds>
<ExposeHeader>x-amz-server-side-encryption</ExposeHeader>
<ExposeHeader>x-amz-request-id</ExposeHeader>
<ExposeHeader>x-amz-id-2</ExposeHeader>
<ExposeHeader>etag</ExposeHeader>
</CORSRule>
</CORSConfiguration>
Konfiguration
Informationen zum Konfigurieren des Objektspeichers finden Sie unter Konfiguration des externen Objektspeichers.
Da die Container im Scope des Azure-Speicherkontos erstellt werden, wird empfohlen, für jeden Dienst einen separaten Container zu haben.
Ebenso wird bei AWS dringend empfohlen, für jeden in der Automation Suite installierten Dienst einen eigenen Bucket zu haben. Wenn das Bucket jedoch global erstellt wird, können bei der Bereitstellung des dedizierten Buckets für jeden Dienst Einschränkungen auftreten. In diesem Fall können Sie einen einzelnen Bucket konfigurieren und für alle Zwecke verwenden.
Das Automation Suite Installationsprogramm unterstützt das Erstellen der Container/Buckets, wenn Sie make -Berechtigungen bereitstellen. Alternativ können Sie die erforderlichen Container/Buckets vor der Installation und deren Informationen für das Installationsprogramm bereitstellen.
Erforderliche Buckets für den Integration Service
Bei einer AKS-Installation müssen Sie mehrere Blob-Speicher-Buckets in Azure Storage erstellen. Dieser Schritt ist bei einer EKS-Installation, bei der einzelne Buckets verwendet werden, nicht erforderlich.
Sie müssen die folgenden Buckets vor der Installation manuell erstellen:
gallupx-poller-datagallupx-job-engine-stategallupx-notification-objectsgallupx-webhookgallupx-execution-trace
Speicheranforderungen
- Objectstore: 500 GB
Die Größe des Objektspeichers hängt von der Größe der bereitgestellten und ausgeführten Automatisierung ab. Daher kann es zunächst während der Installation schwierig sein, eine genaue Objectstore-Schätzung bereitzustellen. Sie können mit einer Objektspeichergröße von 350 GB bis 500 GB beginnen. Informationen zur Nutzung des Objektspeichers finden Sie unter Speicherschätzung für jede Automation Suite-Komponente.
- Wenn Ihre Automatisierung skaliert, müssen Sie möglicherweise die Erhöhung der Größe Ihres Objektspeichers berücksichtigen.
Blockspeicher
Blockspeicher müssen CSI-Treiber haben, die mit den Kubernetes-Speicherklassen konfiguriert sind.
Die folgende Tabelle enthält Details zum Blockspeicher, zur Speicherklasse und zum Bereitsteller:
| Cloud/Kubernetes | Speicher | Speicherklasse | Bereitsteller |
|---|---|---|---|
| AWS | EBS-Volumes | ebs-sc | ebs.csi.aws.com |
| Azure | Azure Datenträger verwalten | managed-premiumPremium-LRS-Datenträger | disk.csi.azure.com |
Konfiguration
Sie können den offiziellen Anleitungen von AWS und Azure folgen, um eine Speicherklasse in Ihren EKS- und AKS-Clustern zu erstellen.
Sie müssen den Namen der Speicherklasse, die Sie für Ihren Cluster erstellt haben, an den Parameter storage_class in der input.json -Datei übergeben.
- Manchmal installiert der EKS- oder AKS-Cluster den CSI-Treiber und stellt die Speicherklasse bereit. Wenn diese Speicherklassen nicht konfiguriert sind, müssen Sie sie vor der Installation der Automation Suite konfigurieren.
- Sie müssen die Speicherklasse für den Blockspeicher zur Standardklasse machen, wie im folgenden Beispiel gezeigt.
Beispiel
Das folgende Beispiel zeigt, wie die Speicherklasse konfiguriert wird und wie sie während der Installation für die input.json -Datei bereitgestellt wird:
| Konfiguration | input.json | StorageClass |
|---|---|---|
| Azure |
|
|
| AWS |
|
|
Speicheranforderungen
- Blockspeicher: 50 GB
Die Größe des Blockspeichers hängt von der Größe der bereitgestellten und ausgeführten Automatisierung ab. Daher kann es zunächst während der Installation schwierig sein, eine genaue Schätzung abzugeben. Sie können mit einer Blockspeichergröße von 50 GB beginnen. Informationen zur Nutzung des Blockspeichers finden Sie unter Speicherschätzung für jede Automation Suite-Komponente.
Wenn Ihre Automatisierung skaliert wird, müssen Sie möglicherweise die Erhöhung Ihrer Blockspeichergröße berücksichtigen.
Dateispeicher
Der Dateispeicher muss über CSI-Treiber verfügen, die mit den Kubernetes-Speicherklassen konfiguriert sind.
In folgender Tabelle finden Sie Einzelheiten zum Dateispeicher, zur Speicherklasse und zum Provisioner:
| Cloud/Kubernetes | Speicher | Speicherklasse | Bereitsteller |
|---|---|---|---|
| AWS | EFS | efs-sc | efs.csi.aws.com |
| Azure | Azure Files | azurefile-csi-premium | file.csi.azure.com |
- Verwenden Sie die Speicherklasse
azurefile-csi-premiumfür Studio Web in AKS. - Es wird empfohlen, ZRS (oder die Replikation) für Studio Web-Speicher zu konfigurieren, um eine hohe Verfügbarkeit sicherzustellen.
- Worker-Knotendatenträger müssen mindestens 2300 IOPS haben, und der StorageCluster sollte mit dem Leistungsprofil und dem SKU-Profil mit mindestens 5000 IOPS konfiguriert werden.
Konfiguration
Sie können den offiziellen Anleitungen von AWS und Azure folgen, um eine Speicherklasse in Ihren EKS- und AKS-Clustern zu erstellen.
Sie müssen den Namen der Speicherklasse, die Sie für Ihren Cluster erstellt haben, an den Parameter storage_class_single_replica in der input.json -Datei übergeben.
Manchmal installiert der EKS- oder AKS-Cluster den CSI-Treiber und stellt die Speicherklasse bereit. Wenn diese Speicherklasse nicht konfiguriert ist, müssen Sie sie vor der Installation der Automation Suite konfigurieren.
Beispiel
Das folgende Beispiel zeigt, wie die Speicherklasse konfiguriert und wie sie input.json während der Installation bereitgestellt wird:
| Konfiguration | input.json | StorageClass |
|---|---|---|
| Azure |
|
|
| Azure |
|
|
| AWS |
|
Ersetzen Sie |
| AWS |
|
Ersetzen Sie |
In der Speicherklasse für die Dateifreigabe müssen die erforderlichen Berechtigungen für das Verzeichnis und die Dateien auf 700 festgelegt sein. Darüber hinaus müssen UID und GID in Azure auf 1000 und gidRangeStart und gidRangeEnd in AWS auf 1000 bzw. 2000 festgelegt werden.
Speicheranforderungen
- Dateispeicher: 510 GB
Die Größe des Dateispeichers hängt von der Größe der bereitgestellten und ausgeführten Automatisierung ab. Daher kann es zunächst während der Installation schwierig sein, eine tatsächliche Schätzung abzugeben. Sie sollten jedoch mit einer Speichergröße von etwa 510 GB rechnen, die ausreicht, um zehn gleichzeitige Trainingspipelines und Automation Suite Robots auszuführen. Informationen zur Nutzung des Filestores finden Sie unter Speicherschätzung für jede Automation Suite-Komponente.
Wenn Ihre Automatisierung skaliert wird, muss möglicherweise Ihr Dateispeicher größer werden.
Warteschlangen
Sie müssen die folgenden Warteschlangen bei Ihrem Cloudanbieter vor der Installation manuell erstellen. Diese Warteschlangen sind erforderlich, um Ereignisse und Webhooks zu unterstützen.
gallupx-debug-engine-tasksgallupx-engine-tasksgallupx-cron-tasksgallupx-tick-tasksgallupx-event-tasksgallupx-notification-tasksgallupx-webhook-engine-tasksgallupx-fps-engine-tasks
Für die Automation Suite auf EKS müssen Sie den Warteschlangen manuell ein bestimmtes Präfix hinzufügen, wie in den folgenden Beispielen gezeigt:
<queuePrefix>-gallupx-debug-engine-tasks<queuePrefix>-gallupx-engine-tasks<queuePrefix>-gallupx-cron-tasks<queuePrefix>-gallupx-tick-tasks<queuePrefix>-gallupx-event-tasks<queuePrefix>-gallupx-notification-tasks<queuePrefix>-gallupx-webhook-engine-tasks<queuePrefix>-gallupx-fps-engine-tasks
Der Wert queuePrefix muss mit dem Wert des obligatorischen queue_prefix -Parameters übereinstimmen, der in EKS input.json verwendet wird.
Wenn Sie Amazon Einfache Warteschlangendienst (SQS) verwenden, müssen Sie acht zusätzliche Warteschlangen mit unbeaufsichtigten Buchstaben (DLQs) erstellen. Sie müssen jede DLQ mit der entsprechenden primären Warteschlange verknüpfen.
Sie müssen jede Warteschlange außer gallupx-engine-tasks mit den folgenden Einstellungen konfigurieren:
- Aufbewahrungszeitraum für Nachrichten: 14 Tage
- Maximale Nachrichtengröße: 256 KB
- Warteschlange mit unzustellbarem Text: Aktiviert
- Standardmäßiges Sichtbarkeits-Timeout: 30 Sekunden
Sie müssen die Warteschlange gallupx-engine-tasks mit den gleichen Einstellungen konfigurieren, mit Ausnahme von:
- Standardmäßiges Sichtbarkeits-Timeout: 15 Minuten
Sie müssen insgesamt 18 Warteschlangen, neun primäre Warteschlangen und neun zugehörige Warteschlangen mit unformatierten Buchstaben haben, wie im folgenden Beispiel gezeigt:
prefix-gallupx-core
prefix-gallupx-core-deadletter
prefix-gallupx-cron-tasks
prefix-gallupx-cron-tasks-deadletter
prefix-gallupx-debug-engine-tasks
prefix-gallupx-debug-engine-tasks-deadletter
prefix-gallupx-engine-tasks
prefix-gallupx-engine-tasks-deadletter
prefix-gallupx-event-tasks
prefix-gallupx-event-tasks-deadletter
prefix-gallupx-fps-engine-tasks
prefix-gallupx-fps-engine-tasks-deadletter
prefix-gallupx-notification-tasks
prefix-gallupx-notification-tasks-deadletter
prefix-gallupx-tick-tasks
prefix-gallupx-tick-tasks-deadletter
prefix-gallupx-webhook-engine-tasks
prefix-gallupx-webhook-engine-tasks-deadletter
prefix-gallupx-core
prefix-gallupx-core-deadletter
prefix-gallupx-cron-tasks
prefix-gallupx-cron-tasks-deadletter
prefix-gallupx-debug-engine-tasks
prefix-gallupx-debug-engine-tasks-deadletter
prefix-gallupx-engine-tasks
prefix-gallupx-engine-tasks-deadletter
prefix-gallupx-event-tasks
prefix-gallupx-event-tasks-deadletter
prefix-gallupx-fps-engine-tasks
prefix-gallupx-fps-engine-tasks-deadletter
prefix-gallupx-notification-tasks
prefix-gallupx-notification-tasks-deadletter
prefix-gallupx-tick-tasks
prefix-gallupx-tick-tasks-deadletter
prefix-gallupx-webhook-engine-tasks
prefix-gallupx-webhook-engine-tasks-deadletter
Sichern und Wiederherstellen
Um den Automation Suite -Cluster zu sichern, benötigen Sie einen zusätzlichen Objektspeicher, um die Clusterkonfiguration und die Benutzerdaten zu sichern.
Die folgende Tabelle beschreibt den unterstützten Speicher für die Sicherung:
| Kubernetes | Objektspeicher |
|---|---|
| EKS | AWS S3 |
| AKS | Azure Storage-Konto |
Zum Speichern der Sicherung wird ein separater Objektspeicher empfohlen.
Speicherauthentifizierung
Workload-identitätsbasierter Zugriff auf Ihr Speicherkonto über AKS
Allgemeine Informationen zur Workload-Identität finden Sie unter Konfiguration der Workload-Identität.
Um Ihr Speicherkonto für die Verwendung der Workload Identity einzurichten, führen Sie die folgenden Befehle aus:
az role assignment create --assignee $userAssignedManagedIdentityObjectId --role "Storage Account Contributor" --scope "/subscriptions/$($infraJson.subscription_id)/resourceGroups/$(TARGET_RG)/providers/Microsoft.Storage/storageAccounts/$(STORAGE_ACCOUNT_NAME)"
az role assignment create --assignee $userAssignedManagedIdentityObjectId --role "Storage Blob Data Owner" --scope "/subscriptions/$($infraJson.subscription_id)/resourceGroups/$(TARGET_RG)/providers/Microsoft.Storage/storageAccounts/$(STORAGE_ACCOUNT_NAME)"
az role assignment create --assignee $userAssignedManagedIdentityObjectId --role "Storage Queue Data Contributor" --scope "/subscriptions/$($infraJson.subscription_id)/resourceGroups/$(TARGET_RG)/providers/Microsoft.Storage/storageAccounts/$(STORAGE_ACCOUNT_NAME)"
az role assignment create --assignee $userAssignedManagedIdentityObjectId --role "Storage Account Contributor" --scope "/subscriptions/$($infraJson.subscription_id)/resourceGroups/$(TARGET_RG)/providers/Microsoft.Storage/storageAccounts/$(STORAGE_ACCOUNT_NAME)"
az role assignment create --assignee $userAssignedManagedIdentityObjectId --role "Storage Blob Data Owner" --scope "/subscriptions/$($infraJson.subscription_id)/resourceGroups/$(TARGET_RG)/providers/Microsoft.Storage/storageAccounts/$(STORAGE_ACCOUNT_NAME)"
az role assignment create --assignee $userAssignedManagedIdentityObjectId --role "Storage Queue Data Contributor" --scope "/subscriptions/$($infraJson.subscription_id)/resourceGroups/$(TARGET_RG)/providers/Microsoft.Storage/storageAccounts/$(STORAGE_ACCOUNT_NAME)"
Das folgende Beispiel zeigt eine gültige input.json -Konfiguration für ein Azure-Speicherkonto:
"external_object_storage": {
"enabled": true,
"storage_type": "azure",
"account_name": "storaccid5730469",
"azure_fqdn_suffix": "core.windows.net",
"use_managed_identity": false,
"use_workload_identity": true
},
"external_object_storage": {
"enabled": true,
"storage_type": "azure",
"account_name": "storaccid5730469",
"azure_fqdn_suffix": "core.windows.net",
"use_managed_identity": false,
"use_workload_identity": true
},
- Speicherschätzung für jede Automation Suite-Komponente
- UiPath®-Plattformdienste
- Freigegebene Suite-Dienste
- Objektspeicher
- Konfigurieren der CORS-Richtlinie
- Konfiguration
- Speicheranforderungen
- Blockspeicher
- Konfiguration
- Speicheranforderungen
- Dateispeicher
- Konfiguration
- Speicheranforderungen
- Warteschlangen
- Sichern und Wiederherstellen
- Speicherauthentifizierung
- Workload-identitätsbasierter Zugriff auf Ihr Speicherkonto über AKS