UiPath Documentation
automation-suite
2.2510
true
Automation Suite in der EKS/AKS-Installationsanleitung
Wichtig :
Bitte beachten Sie, dass dieser Inhalt teilweise mithilfe von maschineller Übersetzung lokalisiert wurde. Es kann 1–2 Wochen dauern, bis die Lokalisierung neu veröffentlichter Inhalte verfügbar ist.

Configuring input.json

Referenz für die input.json-Konfigurationsoptionen und die Struktur für die Automation Suite-Installation auf EKS/AKS.

Mit der Datei input.json konfigurieren Sie die UiPath®-Produkte, die Sie bereitstellen möchten, sowie die Parameter, Einstellungen und Präferenzen, die auf die ausgewählten Produkte angewendet werden, und die Einstellungen Ihrer Cloud-Infrastruktur. Sie müssen diese Datei aktualisieren, wenn Sie Standardeinstellungen ändern und eine erweiterte Konfiguration für Ihren Cluster verwenden möchten.

Hinweis:

Some products might have dependencies. For details, refer to Automation Suite products.

Zum Bearbeiten von input.jsonkönnen Sie Ihren bevorzugten Texteditor auf Ihrem Client-Computer verwenden.

In der folgenden Tabelle werden die wichtigsten input.json -Parameter beschrieben, die Sie aktualisieren müssen, um die Automation Suite ordnungsgemäß zu konfigurieren.

Allgemeine ParameterBeschreibung
kubernetes_distributionGeben Sie an, welche Kubernetes-Distribution Sie verwenden. Es kann sich um aks oder eks handeln.
install_typeBestimmt, ob der Cluster im Online- oder Offlinemodus bereitgestellt wird. Wenn nicht anders angegeben, wird der Cluster im Onlinemodus bereitgestellt. Um den Cluster im Offlinemodus bereitzustellen, müssen Sie den Wert des Parameters install_type explizit auf offline festlegen.

Mögliche Werte: online oder offline.

Standardwert: online
registriesURLs zum Abrufen der Docker-Images und Helm-Charts für UiPath®-Produkte und die Automation Suite.

registry.uipath.com
istioMinProtocolVersionDie von Istio für sichere Kommunikation akzeptierte Mindestversion des TLS-Protokolls. Kann entweder auf TLSV1_2 oder TLSV1_3 festgelegt werden.
fqdnDer Endpunkt des Lastausgleichs für die Automation Suite.
admin_usernameDer Benutzername, den Sie als Administrator für die Hostorganisation festlegen möchten.
admin_passwordDas festzulegende Hostadministratorkennwort.
profileLegt das Profil der Installation fest. Die verfügbaren Profile sind:
– lite: Lite-Modus-Profil.
– ha: HA-fähiges Produktionsprofil mit mehreren Knoten.

For details about managing profiles, refer to Profile configuration.
networkEnables IPv4/IPv6 operation for the cluster networking stack used by Automation Suite. For details, refer to Networking.
telemetry_optouttrue oder false – Wird verwendet, um das Senden der Telemetrie an UiPath® zu deaktivieren. Ist standardmäßig auf false festgelegt. Wenn Sie die Option deaktivieren möchten, wählen Sie true aus.
fips_enabled_nodesGeben Sie an, ob Sie FIPS 140-2 auf den Knoten aktivieren möchten, auf denen Sie die Automation Suite installieren möchten. Mögliche Werte sind true und false.
storage_classGeben Sie die Speicherklasse an, die für die PV-Bereitstellung verwendet werden soll. Diese Speicherklasse muss mehrere Replikate für eine optimale Hochverfügbarkeit unterstützen und über Sicherungsfunktionen verfügen.

For details, refer to the Block storage section.
storage_class_single_replicaGeben Sie die Speicherklasse an, die für die PV-Bereitstellung verwendet werden soll. Diese Speicherklasse kann ein einzelnes Replikat für die Komponenten haben, die keine Hochverfügbarkeit erfordern. Die Speicherklasse kann keine Sicherungsfunktionen haben.

For details, refer to the File storage section.

Der Wert storage_class_single_replica kann mit dem Wert storage_class identisch sein.
storage_class_name_with_rwx_supportGibt die Speicherklasse an, die den Zugriffsmodus ReadWriteMany (RWX) unterstützt. Dieses Feld stellt sicher, dass Komponenten, die gemeinsam genutzte persistente Volumes erfordern, den richtigen RWX-fähigen Speicher verwenden.

Dieses Feld darf nicht leer sein, wenn Studio Web oder ECS aktiviert ist. Wenn das Feld leer gelassen wird, wird bei der Validierung ein Fehler ausgelöst.

Geben Sie für Neuinstallationen einen Speicherklassennamen mit RWX-Support (ReadWriteMany) an.

Verwenden Sie für Upgrades von Versionen vor 2.2510.0 mit Studio Web denselben Speicherklassennamen wie in storage_class_single_replica angegeben und stellen Sie sicher, dass er den RWX-Zugriffsmodus unterstützt.
exclude_componentsVerwenden Sie diesen Parameter, um zu verhindern, dass nicht wesentliche Komponenten installiert werden.

For details, refer to Bring your own components.
namespaceGeben Sie den Namespace an, in dem Sie die Automation Suite installieren möchten.

For details, refer to Custom namespace configuration.
argocd.application_namespaceDer Namespace der Anwendung, die Sie installieren möchten. Dieser sollte idealerweise mit dem Namespace identisch sein, in dem Sie die Automation Suite installieren möchten.
argocd.projectDas ArgoCD-Projekt, das zum Bereitstellen der Automation Suite erforderlich ist. Dies ist nur erforderlich, wenn Sie die freigegebene oder die globale ArgoCD-Instanz anstelle einer dedizierten ArgoCD-Instanz verwenden möchten.
workload_resourcesConfigures CPU and memory requests and limits for workloads created by uipathctl. For details, refer to Configuring resource requests and limits for uipathctl-created workloads.

Ein Konfigurationsbeispiel finden Sie unter:

Profilkonfiguration​

Sie können bei der Installation der Automation Suite aus den folgenden Profilmodi wählen:

  • Konfigurierbares Hochverfügbarkeitsprofil (Lite-Modus)
  • Standardprofil mit hoher Verfügbarkeit (HA-Modus)

Nur im Lite-Modus können Sie bestimmte Produkte auf Hochverfügbarkeit (HA) umstellen. Diese Flexibilität ermöglicht es Ihnen, mit einer nicht-kritischen Workload zu beginnen und beim Onboarding kritischer Workloads einfach zum HA-Modus zu wechseln.

Um eine Hochverfügbarkeit (HA) für ein Produkt zu aktivieren, müssen Sie die input.json -Datei ändern. Insbesondere müssen Sie für die Produkte, die Sie hoch verfügbar machen möchten, den Parameter profile in ha ändern:

  ....
  "automation_ops": {
    "enabled": true,
    "profile": "ha" // flag for turning on high availability
  },
  "action_center": {
    "enabled": true,
    "profile": "lite"
  },
  ...
  ....
  "automation_ops": {
    "enabled": true,
    "profile": "ha" // flag for turning on high availability
  },
  "action_center": {
    "enabled": true,
    "profile": "lite"
  },
  ...

Führen Sie die folgenden Schritte aus, um vom Lite-Modus in den HA-Modus zu wechseln:

  1. Stellen Sie sicher, dass Sie über genügend Infrastrukturfunktionen verfügen, um auf Plattformebene auf Standard-HA umzuschalten. Standardmäßig wird im Lite-Modus jedes Produkt so eingestellt, dass es ein Replikat mit aktivierter horizontaler Pod-Skalierung hat.
  2. Bearbeiten Sie die Konfigurationsdatei input.json und ändern Sie den Parameter profile für die Zielprodukte.
  3. Führen Sie den folgenden Befehl aus, um die Änderungen zu übernehmen:
     uipathctl manifest apply
     uipathctl manifest apply
    

UiPath®-Produkte​

You can enable and disable products in Automation Suite at the time of installation and at any point post-installation. For details on each product configuration, refer to Managing products.

Hinweis:

Je nach Produktauswahl sind einige Konfigurationen möglicherweise nicht verfügbar. Beispielsweise unterstützt Insights derzeit nicht die Authentifizierungskonfiguration mit der Microsoft Entra ID (eforms Azure Active Directory) für den Zugriff auf SQL, Speicher und andere Ressourcen, die Microsoft Entra unterstützen.

Orchestrator-Beispiel:

"orchestrator": {
  "enabled": true,
  "external_object_storage": {
    "bucket_name": "uipath-as-orchestrator"
  },
  "testautomation": {
    "enabled": true
  },
  "updateserver": {
    "enabled": true
  }
"orchestrator": {
  "enabled": true,
  "external_object_storage": {
    "bucket_name": "uipath-as-orchestrator"
  },
  "testautomation": {
    "enabled": true
  },
  "updateserver": {
    "enabled": true
  }

Bringen Sie Ihre eigenen Komponenten mit​

Mit der Automation Suite können Sie Ihre eigenen Gatekeeper- und OPA-Richtlinien, Cert Manager, Istio, Überwachungs- und Protokollierungskomponenten und vieles mehr einbringen. Sollten Sie diese Komponenten ausschließen wollen, stellen Sie sicher, dass sie in Ihrem Cluster verfügbar sind, bevor Sie die Automation Suite installieren.

Das folgende Beispiel zeigt eine Liste der ausgeschlossenen Komponenten. Sie können die Komponenten entfernen, die von der Automation Suite bereitgestellt werden sollen.

   "exclude_components": [
        "alerts",
        "auth",
        "istio",
        "cert-manager",
        "logging",
        "monitoring",
        "gatekeeper",
        "network-policies",
        "velero",
    "external-secrets"
  ]
   "exclude_components": [
        "alerts",
        "auth",
        "istio",
        "cert-manager",
        "logging",
        "monitoring",
        "gatekeeper",
        "network-policies",
        "velero",
    "external-secrets"
  ]

Ausgenommen Istio​

If you bring your own Istio component, make sure to include the gateway_selector labels from your Istio gateway in the input.json file. Starting from Automation Suite 2.2510.2, you can also set the istio_gateway_service_name parameter in the ingress section of input.json to configure the Istio ingress gateway service name. For more details, refer to AKS input.json example or EKS input.json example.

Um die Beschriftung Ihres Gateway-Selektors zu finden, führen Sie die folgenden Schritte aus:

  1. Listen Sie alle Pods im Namespace <istio-system> auf, indem Sie den Befehl kubectl get pods -n <istio-system> ausführen.
  2. Finden Sie den passenden für Ihre Istio Gateway-Bereitstellung.
Hinweis:

Wenn Sie das WASM-Plugin selbst installieren möchten und vermeiden möchten, dass das Automation Suite-Installationsprogramm Schreibzugriff auf den <istio-system> -Namespace erhält, müssen Sie die Komponente istio-configure zur exclude_components -Liste hinzufügen.

Ohne Zertifikatsmanager​

Wenn Sie Ihren eigenen Zertifikatsmanager verwenden möchten und Ihr TLS-Zertifikat von einer privaten oder nicht öffentlichen Zertifizierungsstelle ausgestellt wird, müssen Sie das Blattzertifikat sowie die Zwischenzertifikate der Zertifizierungsstelle manuell in die TLS-Zertifikatsdatei aufnehmen. Öffentlichen Zertifizierungsstellen wird von Clientsystemen automatisch vertraut, und es sind keine weiteren Aktionen Ihrerseits erforderlich.

Zertifikatkonfiguration​

Wenn zum Zeitpunkt der Installation kein Zertifikat bereitgestellt wird, erstellt das Installationsprogramm selbst ausgestellte Zertifikate und konfiguriert sie im Cluster.

Hinweis:

Die Zertifikate können zum Zeitpunkt der Installation nur erstellt werden, wenn Sie dem Automation Suite-Installationsprogramm während der Installation Administratorrechte erteilen. Wenn Sie dem Installationsprogramm keine Administratorberechtigungen erteilen können, müssen Sie die Zertifikate selbst erstellen und verwalten.

For details on how to obtain a certificate, refer to Managing the certificates.

Hinweis:

Stellen Sie sicher, dass Sie den absoluten Pfad für die Zertifikatsdateien angeben. Führen Sie pwd aus, um den Pfad des Verzeichnisses abzurufen, in dem die Dateien gespeichert sind, und hängen Sie den Namen der Zertifikatsdatei an input.json an.

ParameterBeschreibung
server_certificate.ca_cert_fileDer absolute Pfad zum Zertifikat der Zertifizierungsstelle. Diese Zertifizierungsstelle ist die Stelle, die das TLS-Zertifikat signiert. Ein Zertifizierungsstellenpaket darf nur die Kettenzertifikate enthalten, die zum Signieren des TLS-Zertifikats verwendet werden. Das Kettenlimit liegt bei neun Zertifikaten.

Wenn Sie ein selbstsigniertes Zertifikat verwenden, müssen Sie den Pfad zum zuvor erstellen rootCA.crt angeben. Lassen Sie das Feld leer, wenn Sie möchten, dass das Installationsprogramm das Zertifikat generiert.
server_certificate.tls_cert_fileDer absolute Pfad zum TLS-Zertifikat (server.crt ist das selbstsignierte Zertifikat). Lassen Sie das Feld leer, wenn Sie möchten, dass das Installationsprogramm das Zertifikat generiert.

Wenn Sie das Zertifikat selbst bereitstellen, muss die server.crt -Datei die gesamte Kette enthalten, wie im folgenden Beispiel gezeigt:
-----server cert-----
-----root ca chain-----
server_certificate.tls_key_fileDer absolute Pfad zum Zertifikatsschlüssel (server.key ist das selbstsignierte Zertifikat). Lassen Sie das Feld leer, wenn Sie möchten, dass das Installationsprogramm das Zertifikat generiert.
identity_certificate.token_signing_cert_fileDer absolute Pfad zum Identitätstoken-Signaturzertifikat, das zum Signieren von Token verwendet wird (identity.pfx ist das selbstsignierte Zertifikat). Lassen Sie das Feld leer, wenn das Installationsprogramm das Identitätszertifikat mithilfe des Serverzertifikats generieren soll.
identity_certificate.token_signing_cert_passKlartextkennwort, das beim Exportieren des Identitätstoken-Signaturzertifikats festgelegt wurde.
additional_ca_certsDer absolute Pfad zu der Datei, die zusätzliche Zertifikate der Zertifizierungsstelle enthält, die von allen Diensten, die als Teil von Automation Suite ausgeführt werden, als vertrauenswürdig angesehen werden sollen. Alle Zertifikate in der Datei müssen im gültigen PEM-Format vorliegen.

Sie müssen die Datei beispielsweise mit dem Zertifizierungsstellenzertifikat des SQL-Servers angeben, wenn das Zertifikat nicht von einer öffentlichen Zertifizierungsstelle ausgestellt wurde.

Voraussetzungen für die Infrastruktur​

Sie müssen Konfigurationsdetails der Voraussetzungen angeben, die Sie bei Azure oder AWS konfiguriert haben. input.json -Parameteranforderungen finden Sie in den folgenden Voraussetzungsabschnitten:

Konfiguration des externen Objektspeichers​

Allgemeine Konfiguration​

Mit der Automation Suite können Sie Ihren eigenen externen Speicheranbieter mitbringen. Sie können aus den folgenden Speicheranbietern wählen:

  • Azure
  • AWS
  • S3-kompatibel

Sie können den externen Objektspeicher auf eine der folgenden Arten konfigurieren:

  • Während der Installation;
  • Nach der Installation mithilfe der Datei input.json.
Hinweis:
  • Damit die Automation Suite ordnungsgemäß funktioniert, wenn vorsignierte URLs verwendet werden, müssen Sie sicherstellen, dass der Automation Suite-Cluster, Browser und alle Ihre Maschinen, einschließlich Workstations und Robotermaschinen, auf Ihren externen Objektspeicher zugreifen können.
  • Die serverseitige Verschlüsselung mit dem Schlüsselverwaltungsdienst (SSE-KMS) kann nur für die Automation Suite-Buckets aktiviert werden, die in einer Region bereitgestellt werden, die nach dem 30. Januar 2014 erstellt wurde.

    Die SSE-KMS-Funktionalität erfordert unveränderte SignV4-APIs. Regionen, die vor dem 30. Januar 2014 erstellt wurden, verwenden aufgrund der Abwärtskompatibilität mit SignV2 keine unveränderten SignV4-APIs. Daher funktioniert SSE-KMS nur in Regionen, die SignV4 für die Kommunikation verwenden. Informationen zur Bereitstellung der verschiedenen Regionen finden Sie in der AWS-Dokumentation.

Wenn Sie einen privaten Endpunkt für den Zugriff auf den Container verwenden, müssen Sie den Parameter fqdn in der Datei input.json hinzufügen und den privaten Endpunkt als Wert angeben.

In der folgenden Tabelle sind die input.json-Parameter aufgeführt, die Sie zum Konfigurieren der einzelnen Anbieter von externem Objektspeicher verwenden können:

ParameterAzureAWSS3-kompatibelBeschreibung
external_object_storage.enabled✅✅✅Geben Sie an, ob Sie Ihren eigenen Objektspeicher mitbringen möchten.
Mögliche Werte: true und false .
external_object_storage.create_bucket✅✅✅Geben Sie an, ob Sie den Bucket bereitstellen möchten.
Mögliche Werte: true und false .
external_object_storage.storage_type✅✅✅Geben Sie den Speicheranbieter an, den Sie konfigurieren möchten. Beim Wert wird die Groß-/Kleinschreibung beachtet.
Mögliche Werte: azure und s3 .

Viele S3-Objectstores erfordern, dass der CORS auf den gesamten Datenverkehr aus dem Automation Suite-Cluster festgelegt ist. Sie müssen die CORS-Richtlinie auf Objectstore-Ebene konfigurieren, um den FQDN des Clusters zuzulassen.
external_object_storage.fqdn❌✅✅Geben Sie den FQDN des S3-Servers an.
Erforderlich bei AWS-Instanz- und Nicht-Instanzprofilen.
external_object_storage.port❌✅✅Geben Sie den S3-Port an.
Erforderlich bei AWS-Instanz- und Nicht-Instanzprofilen.
external_object_storage.region❌✅✅Geben Sie die AWS-Region an, in der Buckets gehostet werden.
Erforderlich bei AWS-Instanz- und Nicht-Instanzprofilen.
external_object_storage.access_key❌✅✅Geben Sie den Zugriffsschlüssel für das S3-Konto an.
Erforderlich im Falle des AWS Nicht-Instanzprofils.
external_object_storage.secret_key❌✅✅Geben Sie den geheimen Schlüssel für das S3-Konto an.
Erforderlich im Falle des AWS Nicht-Instanzprofils.
external_object_storage.use_instance_profile❌✅✅Geben Sie an, ob Sie ein Instanzprofil verwenden möchten. Ein AWS Identity and Access Management(IAM)-Instanzprofil gewährt sicheren Zugriff auf AWS-Ressourcen für Anwendungen oder Dienste, die auf Amazon Elastic Compute Cloud(EC2)-Instanzen ausgeführt werden. Wenn Sie sich für AWS S3 entscheiden, ermöglicht ein Instanzprofil einer EC2-Instanz die Interaktion mit S3-Buckets, ohne dass explizite AWS-Anmeldeinformationen (z. B. Zugriffsschlüssel) auf der Instanz gespeichert werden müssen.
external_object_storage.bucket_name_prefix1❌✅✅Geben Sie das Präfix für die Bucket-Namen an.
Im Falle des AWS Nicht-Instanzprofils optional.
external_object_storage.bucket_name_suffix1❌✅✅Geben Sie das Suffix für die Bucket-Namen an.
Im Falle des AWS Nicht-Instanzprofils optional.
external_object_storage.account_key✅❌❌Geben Sie den Azure-Kontoschlüssel an.
external_object_storage.account_name✅❌❌Geben Sie den Namen des Azure-Kontos an.
external_object_storage.azure_fqdn_suffix✅❌❌Geben Sie das Azure-FQDN-Suffix an.
Optionaler Parameter.

1 Beim Konfigurieren des externen Objektspeichers müssen Sie die Benennungsregeln und Konventionen Ihres Anbieters sowohl für bucket_name_prefix als auch für bucket_name_suffix befolgen. Darüber hinaus dürfen Suffix und Präfix eine kombinierte Länge von nicht mehr als 25 Zeichen haben und Sie dürfen das Präfix nicht beenden oder das Suffix mit einem Bindestrich beginnen (-), da wir das Zeichen bereits automatisch für Sie hinzufügen.

Um eine sichere und kompatible Kommunikation mit der Automation Suite sicherzustellen, muss Ihr S3-kompatibler Objektspeicher eine oder mehrere der folgenden sicheren TLS-Verschlüsselungssuites unterstützen:

  • TLS 1.3:
    • TLS_AES_128_GCM_SHA256
    • TLS_AES_256_GCM_SHA384
    • TLS_CHACHA20_POLY1305_SHA256
  • TLS 1.2:
    • TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA
    • TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA
    • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
    • TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
    • TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
    • TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
    • TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
    • TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
    • TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
    • TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256
Hinweis:

Die Liste der unterstützten Verschlüsselungssammlungen kann sich im Laufe der Zeit weiterentwickeln, um sie an bewährte Sicherheitsmethoden und Aktualisierungen in der Go-Kryptografischen Bibliothek anzupassen. Die aktuelle Liste finden Sie in der Go-Dokumentation.

Produktspezifische Konfiguration​

You can use the parameters described in the General configuration section to update the general Automation Suite configuration. This means that all installed products would share the same configuration.

Wenn Sie ein oder mehrere Produkte anders konfigurieren möchten, können Sie die allgemeine Konfiguration überschreiben. Sie müssen lediglich die Produkte angeben, für die Sie einen externen Objektspeicher einrichten möchten, und dieselben Parameter für Ihre Konfiguration verwenden. Beachten Sie, dass die anderen installierten Produkte weiterhin die allgemeine Konfiguration übernehmen werden.

Das folgende Beispiel zeigt, wie Sie die allgemeine Konfiguration für den Orchestrator überschreiben können:

"external_object_storage": {
  "enabled": false, // <true/false>
  "create_bucket": true, // <true/false>
  "storage_type": "s3", // <s3,azure,aws>
  "fqdn": "",  // <needed in the case of aws instance and non-instance profile>
  "port": 443, // <needed in the case of aws instance and non-instance profile>
  "region": "", 
  "access_key": "", // <needed in the case of aws non instance profile>
  "secret_key": "", // <needed in the case of aws non instance profile>
  "bucket_name_prefix": "",
  "bucket_name_suffix": "",
  "account_key": "",
  "account_name": "",
  "azure_fqdn_suffix": "core.windows.net",
},

"orchestrator": {
  "external_object_storage": {
    "enabled": false, // <true/false>
    "create_bucket": true, // <true/false>
    "storage_type": "s3", // <s3,azure>
    "fqdn": "",  // <needed in the case of aws instance and non-instance profile>
    "port": 443, // <needed in the case of aws instance and non-instance profile>
    "region": "", 
    "access_key": "", // <needed in case of aws non instance profile>
    "secret_key": "", // <needed in case of aws non instance profile>
    "bucket_name_prefix": "",
    "bucket_name_suffix": "",
    "account_key": "",
    "account_name": "",
    "azure_fqdn_suffix": "core.windows.net",
  }
}
"external_object_storage": {
  "enabled": false, // <true/false>
  "create_bucket": true, // <true/false>
  "storage_type": "s3", // <s3,azure,aws>
  "fqdn": "",  // <needed in the case of aws instance and non-instance profile>
  "port": 443, // <needed in the case of aws instance and non-instance profile>
  "region": "", 
  "access_key": "", // <needed in the case of aws non instance profile>
  "secret_key": "", // <needed in the case of aws non instance profile>
  "bucket_name_prefix": "",
  "bucket_name_suffix": "",
  "account_key": "",
  "account_name": "",
  "azure_fqdn_suffix": "core.windows.net",
},

"orchestrator": {
  "external_object_storage": {
    "enabled": false, // <true/false>
    "create_bucket": true, // <true/false>
    "storage_type": "s3", // <s3,azure>
    "fqdn": "",  // <needed in the case of aws instance and non-instance profile>
    "port": 443, // <needed in the case of aws instance and non-instance profile>
    "region": "", 
    "access_key": "", // <needed in case of aws non instance profile>
    "secret_key": "", // <needed in case of aws non instance profile>
    "bucket_name_prefix": "",
    "bucket_name_suffix": "",
    "account_key": "",
    "account_name": "",
    "azure_fqdn_suffix": "core.windows.net",
  }
}

Rotieren der Anmeldeinformationen im Blob-Speicher für Process Mining​

To rotate the blob storage credentials for Process Mining in Automation Suite the stored secrets must be updated with the new credentials. Refer to Rotating blob storage credentials.

Vorsignierte URL-Konfiguration​

Sie können das Flag disable_presigned_url verwenden, um anzugeben, ob Sie den vorsignierten URL-Zugriff auf globaler Ebene deaktivieren möchten. Standardmäßig sind vorsignierte URLs für die gesamte Plattform aktiviert. Mögliche Werte sind: true und false.

{
  "disable_presigned_url" : true
}
{
  "disable_presigned_url" : true
}
Hinweis:
  • Sie können den Standardwert dieses Parameters nur für Neuinstallationen ändern. Der Vorgang kann nicht rückgängig gemacht werden und gilt nicht für einen vorhandenen Cluster.
  • Sie können diese Konfiguration nur auf die gesamte Plattform anwenden. Sie können die globale Konfiguration auf Produktebene nicht überschreiben.

Externe OCI-konforme Registrierungskonfiguration​

Um eine externe OCI-konforme Registrierung zu konfigurieren, aktualisieren Sie die folgenden Parameter in der Datei input.json:

TastenWert
registries.docker.urlStandardwert: registry.uipath.com
Die URL oder der FQDN der Registrierung, die von der Automation Suite zum Hosten der Container-Images verwendet werden soll.
registries.docker.username registries.docker.passwordAuthentifizierungsinformationen, die zum Abrufen der Docker-Images aus der Registrierung verwendet werden sollen.
Wenn einer der Werte in der Eingabedatei gefunden wird, müssen Sie beide beim Konfigurieren der externen Registrierung angeben.
registries.docker.pull_secret_valueDas Pull-Geheimnis der Registrierung. Dieses Feld ist optional.
registries.helm.urlStandardwert: registry.uipath.com
Die URL oder der FQDN der Registrierung, die von der Automation Suite zum Hosten des Helm-Charts des Dienstes verwendet werden soll.
registries.helm.username registries.helm.passwordAuthentifizierungsinformationen, die zum Abrufen von Helm-Charts aus der Registrierung verwendet werden sollen.
Wenn einer der Werte in der Eingabedatei gefunden wird, müssen Sie beide beim Konfigurieren der externen Registrierung angeben.
registry_ca_certDer Speicherort der Zertifizierungsstellendatei, die dem für die Registrierung konfigurierten Zertifikat entspricht. Wenn die Registrierung von einer privaten Zertifizierungsstelle signiert wird, die bei Ihnen gehostet wird, müssen Sie sie angeben, um die Vertrauensstellung herzustellen.
registries.docker.pull_secret_nameDer Name des Kubernetes-Geheimnisses, in dem die Registrierungsanmeldeinformationen gespeichert werden. Verwenden Sie diesen Parameter, um auf ein vorhandenes Geheimnis zu verweisen, das die Authentifizierungsinformationen für die Registrierung enthält.
Hinweis:

Sie können verschiedene Methoden verwenden, um die codierte Version der pull_secret_value zu generieren, einschließlich der mit Docker.

Das folgende Konfigurationsbeispiel zeigt eine Kubernetes-Geheimnisdefinition, die zum Speichern von Registrierungsanmeldeinformationen verwendet wird:

apiVersion: v1
kind: Secret
metadata:
  name: registry-credentials
data:
  url: base64Encode(sfbrdevhelmweacr.azurecr.io)
  username: base64Encode(registry-username)
  password: base64Encode(registry-password)
apiVersion: v1
kind: Secret
metadata:
  name: registry-credentials
data:
  url: base64Encode(sfbrdevhelmweacr.azurecr.io)
  username: base64Encode(registry-username)
  password: base64Encode(registry-password)

Das folgende Konfigurationsbeispiel zeigt ein typisches OCI-konformes Registrierungssetup:

{
    "registries": {
        "docker": {
            "url": "registry.domain.io",
            "username": "username",
            "password": "password", 
            "pull_secret_value": "pull-secret-value"
        },
        "helm": {
            "url": "registry.domain.io",
            "username": "username",
            "password": "password"
        },
        "trust": {
            "enabled": true,
            "public_key": "LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFNE4vSzNzK2VXUTJHU3NnTTJNcUhsdEplVHlqRQp1UC9sd0dNTnNNUjhUZTI2Ui9TTlVqSVpIdnJKcEx3YmpDc0ZlZUI3L0xZaFFsQzlRdUU1WFhITDZ3PT0KLS0tLS1FTkQgUFVCTElDIEtFWS0tLS0tCg==",
            "detection_mode": false
        }
    },
    "registry_ca_cert": "/etc/pki/ca-trust/extracted/ca-bundle.trust.crt"
}
{
    "registries": {
        "docker": {
            "url": "registry.domain.io",
            "username": "username",
            "password": "password", 
            "pull_secret_value": "pull-secret-value"
        },
        "helm": {
            "url": "registry.domain.io",
            "username": "username",
            "password": "password"
        },
        "trust": {
            "enabled": true,
            "public_key": "LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFNE4vSzNzK2VXUTJHU3NnTTJNcUhsdEplVHlqRQp1UC9sd0dNTnNNUjhUZTI2Ui9TTlVqSVpIdnJKcEx3YmpDc0ZlZUI3L0xZaFFsQzlRdUU1WFhITDZ3PT0KLS0tLS1FTkQgUFVCTElDIEtFWS0tLS0tCg==",
            "detection_mode": false
        }
    },
    "registry_ca_cert": "/etc/pki/ca-trust/extracted/ca-bundle.trust.crt"
}
Hinweis:

Bei Registrierungen wie Harbor, die die Verwendung eines Projekts erfordern, müssen Sie den Projektnamen an die Registrierungs-URL anfügen. Die Anforderung gilt für die Parameter registries.docker.url und registries.helm.url in der Datei input.json , wie im folgenden Beispiel gezeigt:

{
"registries": {
"docker": {
"url": "registry.domain.io/myproject",
"username": "username",
"password": "password"
"pull_secret_value": "pull-secret-value"
},
"helm": {
"url": "registry.domain.io/myproject",
"username": "username",
"password": "password"
}
"trust": {
"enabled": true,
"public_key": "LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFNE4vSzNzK2VXUTJHU3NnTTJNcUhsdEplVHlqRQp1UC9sd0dNTnNNUjhUZTI2Ui9TTlVqSVpIdnJKcEx3YmpDc0ZlZUI3L0xZaFFsQzlRdUU1WFhITDZ3PT0KLS0tLS1FTkQgUFVCTElDIEtFWS0tLS0tCg==",
"detection_mode": false
}
},
"registry_ca_cert": "/etc/pki/ca-trust/extracted/ca-bundle.trust.crt"
}
{
"registries": {
"docker": {
"url": "registry.domain.io/myproject",
"username": "username",
"password": "password"
"pull_secret_value": "pull-secret-value"
},
"helm": {
"url": "registry.domain.io/myproject",
"username": "username",
"password": "password"
}
"trust": {
"enabled": true,
"public_key": "LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFNE4vSzNzK2VXUTJHU3NnTTJNcUhsdEplVHlqRQp1UC9sd0dNTnNNUjhUZTI2Ui9TTlVqSVpIdnJKcEx3YmpDc0ZlZUI3L0xZaFFsQzlRdUU1WFhITDZ3PT0KLS0tLS1FTkQgUFVCTElDIEtFWS0tLS0tCg==",
"detection_mode": false
}
},
"registry_ca_cert": "/etc/pki/ca-trust/extracted/ca-bundle.trust.crt"
}

Benutzerdefinierte Namespace-Konfiguration​

Sie können einen einzelnen benutzerdefinierten Namespace angeben, der die standardmäßigen Namespaces uipath, uipath-check und uipath-installer ersetzt. Um einen benutzerdefinierten Namespace zu definieren, geben Sie einen Wert für den optionalen Parameter namespace an. Wenn Sie keinen Wert für den Parameter namespace angeben, werden stattdessen die Standard-Namespaces verwendet.

Benutzerdefinierte Namespace-Bezeichnungskonfiguration​

Wenn die UiPath-Namespaces benutzerdefinierte Namespace-Beschriftungen enthalten sollen, fügen Sie den folgenden Abschnitt zur Datei input.json hinzu. Stellen Sie sicher, dass Sie Ihre eigenen Beschriftungen hinzufügen.

 "namespace_labels": {
        "install-type": "aksoffline",
        "uipathctlversion": "rc-10_0.1",
        "updatedLabel": "rerun"
    },
 "namespace_labels": {
        "install-type": "aksoffline",
        "uipathctlversion": "rc-10_0.1",
        "updatedLabel": "rerun"
    },

Benutzerdefinierte Konfiguration der Knotentoleranz​

Wenn Sie benutzerdefinierte Markierungen und Toleranzen auf den Knoten benötigen, auf denen Sie die Automation Suite installieren möchten, aktualisieren Sie input.json mit den folgenden Flags. Stellen Sie sicher, dass Sie die entsprechenden Werte für das spec-Feld angeben.

"tolerations": [
  {
    "spec": {
      "key": "example-key", 
      "operator": "Exists",
      "value": "optional-value",
      "effect": "NoSchedule"
    }
  },
  {
    "spec": {
      "key": "example-key2", 
      "operator": "Exists",
      "value": "optional-value2",
      "effect": "NoSchedule"
    }
  }
]
"tolerations": [
  {
    "spec": {
      "key": "example-key", 
      "operator": "Exists",
      "value": "optional-value",
      "effect": "NoSchedule"
    }
  },
  {
    "spec": {
      "key": "example-key2", 
      "operator": "Exists",
      "value": "optional-value2",
      "effect": "NoSchedule"
    }
  }
]

Konfiguration des internen Lastausgleichs​

Sie können einen internen Lastausgleich für Ihre Bereitstellung im AKS- sowie im EKS-Installationstyp verwenden. Dazu müssen Sie dies im Abschnitt ingress der Datei input.json angeben.

Mit der folgenden Anmerkung wird der interne AKS-Lastausgleich konfiguriert:

  • azure-load-balancer-internal: Gibt an, ob der Lastausgleich intern ist.

In der folgenden Tabelle werden die Konfigurationsfelder des internen EKS-Lastenausgleichs beschrieben:

ParameterBeschreibung
aws-load-balancer-backend-protocolGibt das Backend-Protokoll an.
aws-load-balancer-nlb-target-typeGibt den Zieltyp zur Konfiguration für den NLB an.
Sie können zwischen instance und ip wählen.
aws-load-balancer-schemeGibt an, ob der NLB mit dem Internet verbunden oder intern ist.
Gültige Werte sind internal oder internet-facing.
Wenn nicht angegeben, gilt der Standardwert internal.
aws-load-balancer-typeGibt den Typ des Lastausgleichs an.
Dieses Steuerelement gleicht die Dienstressourcen ab, bei denen diese Option entweder auf nlb oder external festgelegt ist.
aws-load-balancer-internalGibt an, ob der NLB mit dem Internet verbunden oder intern ist.

AKS-Beispiel

 "ingress": {
    "service_annotations": {
      "service.beta.kubernetes.io/azure-load-balancer-internal": "true"
    }
  },
 "ingress": {
    "service_annotations": {
      "service.beta.kubernetes.io/azure-load-balancer-internal": "true"
    }
  },

EKS-Beispiel

  "ingress": {
    "service_annotations": {
      "service.beta.kubernetes.io/aws-load-balancer-backend-protocol": "ssl",
      "service.beta.kubernetes.io/aws-load-balancer-nlb-target-type": "ip",
      "service.beta.kubernetes.io/aws-load-balancer-scheme": "internal",
      "service.beta.kubernetes.io/aws-load-balancer-type": "nlb",
      "service.beta.kubernetes.io/aws-load-balancer-internal": "true"
    }
  },
  "ingress": {
    "service_annotations": {
      "service.beta.kubernetes.io/aws-load-balancer-backend-protocol": "ssl",
      "service.beta.kubernetes.io/aws-load-balancer-nlb-target-type": "ip",
      "service.beta.kubernetes.io/aws-load-balancer-scheme": "internal",
      "service.beta.kubernetes.io/aws-load-balancer-type": "nlb",
      "service.beta.kubernetes.io/aws-load-balancer-internal": "true"
    }
  },

Weitere Informationen zum Erstellen interner Lastausgleiche in AKS und EKS finden Sie unter den folgenden Links:

Konfiguration der Workload-Identität​

Workload Identity ist eine Variante der verwalteten Identität, die verfügbar ist, wenn Sie die Automation Suite in AKS verwenden. Workload Identity hilft Ihnen, die Verwaltung von Anmeldeinformationen zu vermeiden, indem Sie Pods in die Lage versetzen, eine Kubernetes-Identität zu verwenden, z. B. ein Dienstkonto. Workload Identity ermöglicht Kubernetes-Anwendungen auch den sicheren Zugriff auf Azure-Ressourcen mit Microsoft Entra ID, basierend auf Dienstkonten mit Anmerkungen.

Weitere Informationen zur Workload-Identität finden Sie unter Verwenden einer Microsoft Entra Workload-ID in AKS – Azure Kubernetes Service.

Hinweis:

Insights unterstützt derzeit keine Workload-Identität.

Führen Sie die folgenden Schritte aus, um Workload Identity zu verwenden:

  1. Aktivieren Sie die Workload-Identität und den OIDC-Aussteller für den Cluster, rufen Sie die URL des OIDC-Ausstellers ab und erstellen Sie eine vom Benutzer zugewiesene verwaltete Identität, die in der Workload-Identität verwendet wird. Um diese Vorgänge auszuführen, folgen Sie den Anweisungen unter Bereitstellen und Konfigurieren eines AKS-Clusters mit Workload-Identität – Azure Kubernetes Service.

  2. Speichern Sie die Client-ID der vom Benutzer zugewiesenen verwalteten Identität und stellen Sie sie in Ihrer input.json -Datei bereit.

    {
      ...
      "pod_identity" : {
        "enabled": true,
        "aks_managed_identity_client_id":<client-id>,
      }
      ...
    }
    {
      ...
      "pod_identity" : {
        "enabled": true,
        "aks_managed_identity_client_id":<client-id>,
      }
      ...
    }
    
  3. Führen Sie das folgende Skript aus, das die Verbundanmeldeinformationen für alle Dienstkonten erstellt, die wir für die Automation Suite erstellen:

    #!/bin/bash
    
    # Variables
    RESOURCE_GROUP="<resource-group-name>"
    USER_ASSIGNED_IDENTITY_NAME="<user-assigned-identity-name>"
    AKS_OIDC_ISSUER="<aks-oidc-issuer>"
    AUDIENCE="api://AzureADTokenExchange"
    
    # Helper function to create federated credentials
    create_federated_credentials() {
      local NAMESPACE=$1
      shift
      local SERVICE_ACCOUNTS=("$@")
    
      for SERVICE_ACCOUNT_NAME in "${SERVICE_ACCOUNTS[@]}"; do
        # Generate a unique federated identity credential name
        FEDERATED_IDENTITY_CREDENTIAL_NAME="${NAMESPACE}-${SERVICE_ACCOUNT_NAME}"
    
        echo "Creating federated credential for namespace: ${NAMESPACE}, service account: ${SERVICE_ACCOUNT_NAME}"
    
        # Run the Azure CLI command
        az identity federated-credential create \
          --name "${FEDERATED_IDENTITY_CREDENTIAL_NAME}" \
          --identity-name "${USER_ASSIGNED_IDENTITY_NAME}" \
          --resource-group "${RESOURCE_GROUP}" \
          --issuer "${AKS_OIDC_ISSUER}" \
          --subject "system:serviceaccount:${NAMESPACE}:${SERVICE_ACCOUNT_NAME}" \
          --audience "${AUDIENCE}"
    
        if [ $? -eq 0 ]; then
          echo "Federated credential created successfully for ${NAMESPACE}:${SERVICE_ACCOUNT_NAME}"
        else
          echo "Failed to create federated credential for ${NAMESPACE}:${SERVICE_ACCOUNT_NAME}"
        fi
      done
    }
    
    
    # Call the function for each namespace and its service accounts
    create_federated_credentials "uipath" "default" "asrobots-sa" "dataservice-be-service-account" "dataservice-fe-service-account" "insights-adf" "du-documentmanager-service-account" "services-configure-uipath-ba" "aicenter-jobs" "aicenter-deploy" "ailoadbalancer-service-account" "airflow"
    create_federated_credentials "uipath-check" "default"
    create_federated_credentials "velero" "velero-server"
    #!/bin/bash
    
    # Variables
    RESOURCE_GROUP="<resource-group-name>"
    USER_ASSIGNED_IDENTITY_NAME="<user-assigned-identity-name>"
    AKS_OIDC_ISSUER="<aks-oidc-issuer>"
    AUDIENCE="api://AzureADTokenExchange"
    
    # Helper function to create federated credentials
    create_federated_credentials() {
      local NAMESPACE=$1
      shift
      local SERVICE_ACCOUNTS=("$@")
    
      for SERVICE_ACCOUNT_NAME in "${SERVICE_ACCOUNTS[@]}"; do
        # Generate a unique federated identity credential name
        FEDERATED_IDENTITY_CREDENTIAL_NAME="${NAMESPACE}-${SERVICE_ACCOUNT_NAME}"
    
        echo "Creating federated credential for namespace: ${NAMESPACE}, service account: ${SERVICE_ACCOUNT_NAME}"
    
        # Run the Azure CLI command
        az identity federated-credential create \
          --name "${FEDERATED_IDENTITY_CREDENTIAL_NAME}" \
          --identity-name "${USER_ASSIGNED_IDENTITY_NAME}" \
          --resource-group "${RESOURCE_GROUP}" \
          --issuer "${AKS_OIDC_ISSUER}" \
          --subject "system:serviceaccount:${NAMESPACE}:${SERVICE_ACCOUNT_NAME}" \
          --audience "${AUDIENCE}"
    
        if [ $? -eq 0 ]; then
          echo "Federated credential created successfully for ${NAMESPACE}:${SERVICE_ACCOUNT_NAME}"
        else
          echo "Failed to create federated credential for ${NAMESPACE}:${SERVICE_ACCOUNT_NAME}"
        fi
      done
    }
    
    
    # Call the function for each namespace and its service accounts
    create_federated_credentials "uipath" "default" "asrobots-sa" "dataservice-be-service-account" "dataservice-fe-service-account" "insights-adf" "du-documentmanager-service-account" "services-configure-uipath-ba" "aicenter-jobs" "aicenter-deploy" "ailoadbalancer-service-account" "airflow"
    create_federated_credentials "uipath-check" "default"
    create_federated_credentials "velero" "velero-server"
    

To use workload identity with SQL, refer toWorkload identity-based access to SQL from AKS.

To use workload identity with your storage account, refer to Workload identity-based access to your storage account from AKS.

To use workload identity with Azure Key Vault, refer to Using Workload Identity authentication.

Hinweis:

Wenn SQL Server nicht zur Unterstützung der Workload-Identitäts-basierten Authentifizierung konfiguriert ist, legen Sie enable_sql_wi für jede Komponente, die eine Verbindung mit SQL herstellt, auf false fest. Das folgende Beispiel zeigt die Konfiguration für Document Understanding:

"documentunderstanding": {
  "enabled": true,
  "enable_sql_wi": false
}
"documentunderstanding": {
  "enabled": true,
  "enable_sql_wi": false
}

Spezifische Orchestrator-Konfiguration​

Der Orchestrator kann Roboterprotokolle auf einem Elasticsearch-Server speichern. Sie können diese Funktion im Abschnitt orchestrator.orchestrator_robot_logs_elastic konfigurieren. Wenn nicht angegeben, werden Roboterprotokolle in der Orchestrator-Datenbank gespeichert.

In der folgenden Tabelle sind die orchestrator.orchestrator_robot_logs_elastic-Parameter aufgeführt:

ParameterBeschreibung
orchestrator_robot_logs_elasticElasticsearch-Konfiguration.
elastic_uriDie Adresse der Elasticsearch-Instanz, die verwendet werden soll. Sie muss in Form eines URI bereitgestellt werden. Wenn angegeben, sind auch Benutzername und Kennwort erforderlich.
elastic_auth_usernameDer Elasticsearch-Benutzername, der für die Authentifizierung verwendet wird.
elastic_auth_passwordDas Elasticsearch-Kennwort, das für die Authentifizierung verwendet wird.

Insights-spezifische Konfiguration​

Wenn sie Insights aktivieren, können Benutzer die SMTP-Serverkonfiguration einschließen, die zum Senden geplanter E-Mails/Warnungs-E-Mails verwendet wird. Wenn sie fehlt, funktionieren die geplanten E-Mails und die Warnungs-E-Mails nicht.

You can use the uipathctl command-line tool to apply configuration changes. For details, refer to the uipathctl reference guide.

In der folgenden Tabelle werden die insights.smtp_configuration -Felder beschrieben:

ParameterBeschreibung
tls_versionGültige Namen: TLSv1_2, TLSv1_1, SSLv23. Lassen Sie den Schlüssel ganz weg, wenn Sie TLS nicht verwenden.
from_emailAdresse, von der Warnungs-/Termin-E-Mails gesendet werden.
hostHostname des SMTP-Servers.
portDer Port des SMTP-Servers.
usernameBenutzername für die SMTP-Serverauthentifizierung.
passwordKennwort für die SMTP-Serverauthentifizierung.
enable_realtime_monitoringFlag, um die Insights-Echtzeitüberwachung zu aktivieren. Gültige Werte sind true und false. Der Standardwert ist false.

Beispiel

"insights": {
    "enabled": true,
    "enable_realtime_monitoring": true,
    "smtp_configuration": {
      "tls_version": "TLSv1_2",
      "from_email": "test@test.com",
      "host": "smtp.sendgrid.com",
      "port": 587,
      "username": "login",
      "password": "password123"
    }
  }
"insights": {
    "enabled": true,
    "enable_realtime_monitoring": true,
    "smtp_configuration": {
      "tls_version": "TLSv1_2",
      "from_email": "test@test.com",
      "host": "smtp.sendgrid.com",
      "port": 587,
      "username": "login",
      "password": "password123"
    }
  }

Process Mining-spezifische Konfiguration​

Wenn Sie Process Mining aktivieren, empfehlen wir Benutzern, einen ZWEITEN SQL-Server anzugeben, der als Data Warehouse fungiert, das vom primären Automation Suite-SQL-Server getrennt ist.Der Data Warehouse SQL-Server wird stark belastet und kann im Abschnitt processmining konfiguriert werden:

ParameterBeschreibung
sql_connection_strDotNet-formatierte Verbindungszeichenfolge mit Datenbank als Platzhalter: Initial Catalog=DB_NAME_PLACEHOLDER .
airflow.metadata_db_connection_str1Dies gilt für die PostgreSQL-Datenbank AutomationSuite Airflow . Sqlalchemy PSYCOPG2-formatierte Verbindungszeichenfolge für die benutzerdefinierte Airflow-Metadaten-Datenbank: PostgreSQL:5432/DB_NAME_PLACEHOLDER.

Beispiel: postgresql+psycopg2://testadmin:<password>@postgres.company.com:5432/DB_NAME_PLACEHOLDER

Sie können auch metadata_db_connection_str im Process Mining- Abschnitt auf globaler Ebene in der input.json -Datei verwenden, um den Wert für die Airflow-Metadatenbank bereitzustellen. In diesem Fall ist airflow.metadata_db_connection_str optional.
warehouse.sql_connection_strdotNet-formatierte SQL-Verbindungszeichenfolge zum Process Mining Data Warehouse SQL-Server mit Platzhalter für dbname: Initial Catalog=DB_NAME_PLACEHOLDER.
warehouse.sqlalchemy_pyodbc_sql_connection_strSqlalchemy PYODBC-formatierte SQL-Verbindungszeichenfolge zum Process Mining Data Warehouse SQL-Server mit Platzhalter für dbname: sqlServer:1433/DB_NAME_PLACEHOLDER.
warehouse.master_sql_connection_strWenn das Installationsprogramm Datenbanken über die Einstellung sql.create_db: true erstellt, muss eine DotNet-formatierte Master-SQL-Verbindungszeichenfolge für den Processmining-Data-Warehouse-SQL-Server bereitgestellt werden. Datenbank in der Verbindungszeichenfolge muss als master festgelegt werden.

1 Beispielkonfiguration:

"processmining": {
  "enabled": true,
  "app_security_mode": "system_managed",
  "airflow": {
    "metadata_db_connection_str": "postgresql+psycopg2://testadmin:<password>@sfdev8454496-postgresql.postgres.database.azure.com:5432/AutomationSuite_Airflow"
  }
}
"processmining": {
  "enabled": true,
  "app_security_mode": "system_managed",
  "airflow": {
    "metadata_db_connection_str": "postgresql+psycopg2://testadmin:<password>@sfdev8454496-postgresql.postgres.database.azure.com:5432/AutomationSuite_Airflow"
  }
}

Beispiel einer Process Mining-Verbindungszeichenfolge mit PostgreSQL für AutomationSuite_Airflow

"processmining": {
    "enabled": true,
    "app_security_mode": "system_managed",
    "airflow": {
      "metadata_db_connection_str": "postgresql+psycopg2://testadmin:<password>@sfdev8454496-postgresql.postgres.database.azure.com:5432/AutomationSuite_Airflow"
    },
    "warehouse": {
      "sql_connection_str": "Server=tcp:kerberossql.autosuitead.local,1433;Initial Catalog=AutomationSuite_Warehouse;Persist Security Info=False;User Id=testadmin;Password='<password>';MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;",
      "sqlalchemy_pyodbc_sql_connection_str": "mssql+pyodbc://testadmin:<password>@kerberossql.autosuitead.local:1433/AutomationSuite_Warehouse?driver=ODBC+Driver+17+for+SQL+Server&TrustServerCertificate=YES&Encrypt=YES",
      "master_sql_connection_str": "Server=tcp:kerberossql.autosuitead.local,1433;Initial Catalog=master;Persist Security Info=False;User Id=testadmin;Password='<password>';MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;"
"processmining": {
    "enabled": true,
    "app_security_mode": "system_managed",
    "airflow": {
      "metadata_db_connection_str": "postgresql+psycopg2://testadmin:<password>@sfdev8454496-postgresql.postgres.database.azure.com:5432/AutomationSuite_Airflow"
    },
    "warehouse": {
      "sql_connection_str": "Server=tcp:kerberossql.autosuitead.local,1433;Initial Catalog=AutomationSuite_Warehouse;Persist Security Info=False;User Id=testadmin;Password='<password>';MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;",
      "sqlalchemy_pyodbc_sql_connection_str": "mssql+pyodbc://testadmin:<password>@kerberossql.autosuitead.local:1433/AutomationSuite_Warehouse?driver=ODBC+Driver+17+for+SQL+Server&TrustServerCertificate=YES&Encrypt=YES",
      "master_sql_connection_str": "Server=tcp:kerberossql.autosuitead.local,1433;Initial Catalog=master;Persist Security Info=False;User Id=testadmin;Password='<password>';MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;"

Verwenden Sie bei Verwendung der Kerberos-Authentifizierung die Parameter Integrated Security und Trusted_Connection . Wenn Sie Integrated Security auf true und Trusted_Connection auf yes setzen, werden die Anmeldeinformationen des aktuell angemeldeten Benutzers für die Verbindung verwendet. In diesem Fall müssen Sie keinen separaten Benutzernamen und kein Kennwort angeben.

Hinweis:

Beim Konfigurieren der Verbindungszeichenfolgen für den Process Mining Data Warehouse SQL-Server sollte die benannte Instanz des SQL-Servers weggelassen werden.

Benannte Instanzen von SQL Server können nicht auf demselben TCP-Port ausgeführt werden. Daher reicht die Portnummer allein aus, um zwischen Instanzen zu unterscheiden.

Verwenden Sie beispielsweise tcp:server,1445 anstelle von tcp:server\namedinstance,1445.

Die Namen für die PYODBC-Verbindungszeichenfolge postgresql_connection_string_template_sqlalchemy_pyodbc der Vorlage (für PostgreSQL) und die PYODBC-Verbindungszeichenfolge sqlalchemy_pyodbc_sql_connection_str die Sie verwenden, wenn Sie Ihre eigene Datenbank mitbringen, sind unterschiedlich. Die Namen der Verbindungszeichenfolgen sind auch für die SQL-Vorlagen sql_connection_string_template und sql_connection_str unterschiedlich, die verwendet werden, wenn Sie Ihre eigene Datenbank mitbringen.

Wenn Sie Ihre eigene Datenbank mitbringen und sie mithilfe der Verbindungszeichenfolgen sql_connection_str und sqlalchemy_pyodbc_sql_connection_str oder airflow.metadata_db_connection_str im Abschnitt processmining der Datei input.json konfiguriert haben, sind die Vorlagenverbindungszeichenfolgen sql_connection_string_template und postgresql_connection_string_template_sqlalchemy_pyodbc (für PostgreSQL) werden ignoriert, wenn angegeben.

Spezifische Konfiguration für Automation Suite Robots​

Automation Suite-Roboter können Paket-Caching verwenden, um Ihre Prozessausführungen zu optimieren und ihnen eine schnellere Ausführung zu ermöglichen. NuGet-Pakete werden aus dem Dateisystem abgerufen, anstatt aus dem Internet/Netzwerk heruntergeladen zu werden. Dies erfordert einen zusätzlichen Speicherplatz von mindestens 10 GB und sollte einem Ordner im Dateisystem der Hostmaschine der dedizierten Knoten zugewiesen werden.

Um die Paketzwischenspeicherung zu aktivieren, müssen Sie die folgenden input.json-Parameter aktualisieren:

ParameterStandardwertBeschreibung
packagecachingtrueWenn auf true festgelegt, verwenden Roboter einen lokalen Cache für die Paketauflösung.
packagecachefolder/uipath_asrobots_package_cacheDer Speicherort auf dem serverlosen Agent-Knoten, auf dem die Pakete gespeichert sind.

Wenn Ihre Cluster-RBAC-Richtlinien die Berechtigungen get und list auf Knoten einschränken, können Automation Suite Robots die maximale Anzahl gleichzeitiger Aufträge nicht automatisch bestimmen. Konfigurieren Sie in diesem Fall den folgenden Parameter input.json, um den Grenzwert explizit zu definieren:

ParameterStandardwertBeschreibung
concurrency_limitNicht festgelegtDie maximale Anzahl der Aufträge, die gleichzeitig ausgeführt werden können. Wenn diese Option nicht festgelegt ist, verwenden Automation Suite Robots die Berechtigungen get und list für Knoten, um den Grenzwert automatisch basierend auf der verfügbaren Knotenkapazität zu bestimmen.

AI Center-spezifische Konfiguration​

Dieser Abschnitt gilt nur für S3-Endpunkte (nicht für Azure Storage erforderlich).

Damit das AI Center ordnungsgemäß funktioniert, müssen Sie die Parameter aicenter.external_object_storage.port und aicenter.external_object_storage.fqdn in der Datei input.json konfigurieren.

Hinweis:

Sie müssen die Parameter im Abschnitt aicenter der input.json -Datei konfigurieren, auch wenn Sie den external_object_storage -Abschnitt der Datei konfiguriert haben.

Das folgende Beispiel zeigt eine gültige input.json -Konfiguration für das AI Center:

"aicenter": {
  "external_object_storage" {
    "port": 443,
    "fqdn": "s3.us-west-2.amazonaws.com"
  }
},
"external_object_storage": {
  "enabled": true,
  "create_bucket": false,
  "storage_type": "s3", 
  "region": "us-west-2", 
  "use_instance_profile": true
}
...
"aicenter": {
  "external_object_storage" {
    "port": 443,
    "fqdn": "s3.us-west-2.amazonaws.com"
  }
},
"external_object_storage": {
  "enabled": true,
  "create_bucket": false,
  "storage_type": "s3", 
  "region": "us-west-2", 
  "use_instance_profile": true
}
...

Integration Service-spezifische Konfiguration​

Konfiguration der so genannten Cloud-Warteschlange​

In sohoheitlichen oder nationalen Cloud-Umgebungen, in denen Warteschlangenendpunkte ein nicht standardmäßiges FQDN-Suffix verwenden, können Sie die Standardeinstellung mithilfe des optionalen Felds queue_config.fqdn_suffix unter integrationservices in input.json überschreiben.

Standardmäßig verwendet Integration Service amazonaws.com für AWS und core.windows.net für Azure.

Beispiele für Anwendungsfälle: China AWS (amazonaws.com.cn), China Azure (core.chinacloudapi.cn), Azure USGovernment (core.usgovcloudapi.net).

"integrationservices": {
  "queue_config": {
    "fqdn_suffix": ""
  }
}
"integrationservices": {
  "queue_config": {
    "fqdn_suffix": ""
  }
}
  • Wenn fqdn_suffix leer gelassen wird oder das Feld weggelassen wird, gelten die Diagrammstandards: amazonaws.com für AWS oder core.windows.net für Azure.
  • Wenn ein nicht leerer Wert angegeben wird, überschreibt er das FQDN-Suffix des Warteschlangenendpunkts für AWS- sowie Azure-Warteschlangen-URLs.
  • Wenn azure_fqdn_suffix in external_object_storage festgelegt ist, verwendet Integration Service automatisch denselben Wert für das Suffix des Warteschlangenendpunkts. In diesem Fall müssen Sie queue_config.fqdn_suffix nicht separat festlegen.

Dienstprinzipalauthentifizierung für SQL​

Wenn Sie die SQL-Authentifizierung mit einem Azure Active Directory-Dienstprinzipal für die Datenbankverbindung verwenden, müssen Sie dem Block integrationservices in input.json explizit einen Abschnitt advanced_configuration hinzufügen. Ersetzen Sie your-tenant-id durch Ihre Azure-Mandanten-ID.

"integrationservices": {
  "enabled": true,
  "advanced_configuration": {
    "gallupx": {
      "extraEnv": {
        "AZURE_TENANT_ID": "your-tenant-id"
      }
    }
  }
}
"integrationservices": {
  "enabled": true,
  "advanced_configuration": {
    "gallupx": {
      "extraEnv": {
        "AZURE_TENANT_ID": "your-tenant-id"
      }
    }
  }
}

Spezifische Konfiguration für Document Understanding​

Dienstprinzipalauthentifizierung für SQL​

Wenn Sie die SQL-Authentifizierung mit einem Azure Active Directory-Dienstprinzipal für die Datenbankverbindung verwenden, müssen Sie dem Block documentunderstanding in input.json explizit einen Abschnitt advanced_configuration hinzufügen. Ersetzen Sie your-tenant-id durch Ihre Azure-Mandanten-ID.

"documentunderstanding": {
    "enabled": true,
    "enable_sql_wi": null,
    "advanced_configuration": {
      "du-annotations": {
        "additionalConfigs": {
          "AZURE_TENANT_ID": "your-tenant-id"
        }
      }
    },
},
"documentunderstanding": {
    "enabled": true,
    "enable_sql_wi": null,
    "advanced_configuration": {
      "du-annotations": {
        "additionalConfigs": {
          "AZURE_TENANT_ID": "your-tenant-id"
        }
      }
    },
},

War diese Seite hilfreich?

Verbinden

Benötigen Sie Hilfe? Support

Möchten Sie lernen? UiPath Academy

Haben Sie Fragen? UiPath-Forum

Auf dem neuesten Stand bleiben