- Ü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
- AI Center-Bereitstellungsfehler nach Upgrade auf 2023.10 oder höher
- Insights-Volumes, die nach der Migration in zwei verschiedenen Zonen erstellt wurden
- Upgrade schlägt aufgrund überschriebener Insights-PVC-Größen fehl
- Velero-Backup-Komponenten bleiben nach dem Upgrade auf AKS von Automation Suite 2024.10.x erhalten
- 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
Installieren und Konfigurieren des GitOps-Tools
Installieren und konfigurieren Sie das ArgoCD GitOps-Tool für die Automation Suite auf EKS/AKS.
Bevor Sie mit der ArgoCD-Installation und -Konfiguration fortfahren, müssen Sie Istio installieren und alle erforderlichen Berechtigungen für das uipathadmin -Dienstkonto bereitstellen.
Anweisungen zur Installation und Konfiguration des Service Mesh finden Sie unter Installieren und Konfigurieren des Service Meshs.
Weitere Informationen zu den Installationsberechtigungen finden Sie unter Erteilen von Installationsberechtigungen.
Wenn Sie dem Installationsprogramm der Automation Suite keine Administratorrechte gewähren können, müssen Sie Ihr eigenes ArgoCD-Installationsprogramm für die Automation Suite-Bereitstellung mitbringen. Weitere Informationen finden Sie unter Bereitstellen von ArgoCD.
ArgoCD wird bereitgestellt
Wenn Sie dem Automation Suite-Installationsprogramm keine Administratorrechte gewähren können, müssen Sie Ihre eigene ArgoCD mitbringen und die folgenden Konfigurationsschritte ausführen:
- Geben Sie den richtigen Wert für den Parameter
application_namespaceim AbschnittargocdIhrerinput.json-Datei an. Dies ist der Namespace, in dem Anwendungen erstellt werden, und sollte idealerweise der Namespace sein, in dem ArgoCD installiert ist. - Wenn Sie die Automation Suite in einem freigegebenen Cluster installieren, empfehlen wir, ein neues ArgoCD-Projekt für die Automation Suite zu erstellen, anstatt das Standardprojekt zu verwenden. Weitere Informationen zum Erstellen eines Projekts in ArgoCD finden Sie unter Erstellen eines Projekts in ArgoCD.
- Konfigurieren Sie das Helm-Repository in ArgoCD. Weitere Informationen finden Sie unter Konfigurieren des Helm-Repositorys in ArgoCD.
- Gewähren Sie die erforderlichen Berechtigungen für den ArgoCD-Namespace. Weitere Informationen finden Sie unter Erteilen der erforderlichen Berechtigungen für den ArgoCD-Namespace.
Erstellen eines Projekts in ArgoCD
Um ein neues Projekt in der ArgoCD-Benutzeroberfläche zu erstellen, führen Sie die folgenden Schritte aus:
- Melden Sie sich bei ArgoCD an.
- Navigieren Sie zu Einstellungen > Projekte > +New PROJECT.
- Geben Sie einen Namen und eine Beschreibung für das Projekt an.
- Fügen Sie die folgenden Ziele hinzu:
- Geben Sie
<uipath>als Namespace undhttps://kubernetes.default.svcals Server ein. - Geben Sie
<istio-system>als Namespace undhttps://kubernetes.default.svcals Server ein.
- Geben Sie
- Fügen Sie den Namespace
<argocd>zusourceNamespaces.Hinweis:In älteren ArgoCD-Versionen ist
sourceNamespacesauf der Benutzeroberfläche nicht sichtbar.
Sie können auch deklarativ ein ArgoCD-Projekt erstellen:
apiVersion: argoproj.io/v1alpha1
kind: AppProject
metadata:
name: <project-name>
namespace: <argocd-namespace>
spec:
description: App project to manage and deploy uipath applications
clusterResourceWhitelist:
- group: '*'
kind: '*'
destinations:
- namespace: <uipath>
server: https://kubernetes.default.svc
- namespace: <istio-system>
server: https://kubernetes.default.svc
sourceNamespaces:
- <argocd-namespace>
sourceRepos:
- '*'
apiVersion: argoproj.io/v1alpha1
kind: AppProject
metadata:
name: <project-name>
namespace: <argocd-namespace>
spec:
description: App project to manage and deploy uipath applications
clusterResourceWhitelist:
- group: '*'
kind: '*'
destinations:
- namespace: <uipath>
server: https://kubernetes.default.svc
- namespace: <istio-system>
server: https://kubernetes.default.svc
sourceNamespaces:
- <argocd-namespace>
sourceRepos:
- '*'
Konfigurieren des Helm-Repositorys in ArgoCD
Führen Sie die folgenden Schritte aus, um das Helm-Repository in ArgoCD zu konfigurieren:
- Melden Sie sich bei ArgoCD an.
- Navigieren Sie zu Einstellungen > Repositorys > +CONNECT REPO.
- Verwenden Sie VIA HTTPS als Verbindungsmethode.
- Wählen Sie Helm als Typ aus.
- Geben Sie einen Namen an.
- Wählen Sie uipath als Projekt aus. uipath ist der Name des ArgoCD-Projekts, das Sie für die UiPath®-Anwendung erstellt haben.
- Geben Sie die Repository-URL, den Benutzernamen, das Kennwort und das Zertifikat an.
- Aktivieren Sie das Kontrollkästchen OCI .
- Select Connect.
- Stellen Sie sicher, dass der Verbindungsstatus Erfolgreich ist.
Erteilen der erforderlichen Berechtigungen für den ArgoCD-Namespace
Um die erforderlichen Berechtigungen für den ArgoCD-Namespace zu erteilen, führen Sie die folgenden Schritte aus:
-
Erstellen Sie eine Rolle, um das Geheimnis im Namespace
<argocd>zu erstellen und zu bearbeiten:apiVersion: rbac.authorization.k8s.io/v1 kind: Role metadata: name: argo-secret-role namespace: <argocd> rules: - apiGroups: ["rbac.authorization.k8s.io"] resources: ["roles", "rolebindings"] verbs: ["*"] - apiGroups: ["*"] resources: ["secrets"] verbs: ["get", "watch", "list", "patch", "update", "create"]apiVersion: rbac.authorization.k8s.io/v1 kind: Role metadata: name: argo-secret-role namespace: <argocd> rules: - apiGroups: ["rbac.authorization.k8s.io"] resources: ["roles", "rolebindings"] verbs: ["*"] - apiGroups: ["*"] resources: ["secrets"] verbs: ["get", "watch", "list", "patch", "update", "create"] -
Binden Sie die Rolle
argo-secret-rolean das Dienstkontouipathadmin:kubectl -n <argocd> create rolebinding secret-binding \ --role=argo-secret-role --serviceaccount=<uipath>:uipathadminkubectl -n <argocd> create rolebinding secret-binding \ --role=argo-secret-role --serviceaccount=<uipath>:uipathadmin -
Erstellen Sie eine Rolle, um die Anwendungen im
<argocd>-Namespace zu verwalten:apiVersion: rbac.authorization.k8s.io/v1 kind: Role metadata: name: uipath-application-manager namespace: <argocd> rules: - apiGroups: - argoproj.io resources: - applications verbs: - "*"apiVersion: rbac.authorization.k8s.io/v1 kind: Role metadata: name: uipath-application-manager namespace: <argocd> rules: - apiGroups: - argoproj.io resources: - applications verbs: - "*" -
Binden Sie die Rolle
uipath-application-manageran das Dienstkontouipathadmin:kubectl create rolebinding uipath-application-manager-rolebinding --role=uipath-application-manager --serviceaccount=<uipath>:uipathadmin -n <argocd>kubectl create rolebinding uipath-application-manager-rolebinding --role=uipath-application-manager --serviceaccount=<uipath>:uipathadmin -n <argocd> -
Binden Sie die Namespace-Leserrolle im Namespace
<argocd>an das Dienstkontouipathadmin:kubectl -n <argocd> create rolebinding namespace-reader-rolebinding \ --clusterrole=namespace-reader-clusterrole --serviceaccount=<uipath>:uipathadminkubectl -n <argocd> create rolebinding namespace-reader-rolebinding \ --clusterrole=namespace-reader-clusterrole --serviceaccount=<uipath>:uipathadmin