- Vue d'ensemble (Overview)
- Prérequis
- Installation
- Vérifications des prérequis
- Configuration du registre conforme à OCI
- Exemple de sortie : vérification des prérequis
- Exemple de sortie : installation Automation Suite
- Téléchargement des packages d'installation
- cluster uipathctl
- maintenance du cluster uipathctl
- uipathctl cluster maintenance disable
- uipathctl cluster maintenance enable
- uipathctl cluster maintenance is-enabled
- uipathctl cluster migration
- uipathctl cluster migration export
- uipathctl cluster migration import
- uipathctl cluster migration run
- mise à niveau du cluster uipathctl
- Configuration uipathctl
- uipathctl config add-host-admin
- uipathctl config additional-ca-certificates
- uipathctl config additional-ca-certificates get
- uipathctl config additional-ca-certificates update
- alertes de configuration uipathctl
- uipathctl - configuration des alertes - ajouter une adresse e-mail
- uipathctl config alerts remove-email
- uipathctl config alerts update-email
- uipathctl config argocd
- uipathctl config argocd ca-certificates
- uipathctl config argocd ca-certificates get
- uipathctl config argocd ca-certificates update
- uipathctl config argocd generate-dex-config
- uipathctl config argocd generate-rbac
- uipathctl config argocd registry
- uipathctl config argocd registry get
- uipathctl config argocd registry update
- uipathctl config enable-basic-auth
- uipathctl config Orchestrator
- uipathctl config Orchestrator get-config
- uipathctl config orchestrator update-config
- uipathctl config saml-certificates get
- uipathctl config saml-certificates rotate
- uipathctl config saml-certificates update
- uipathctl config tls-certificates
- uipathctl config tls-certificates get
- uipathctl config tls-certificates update
- uipathctl config token-signing-certificates
- uipathctl config token-signing-certificates get
- uipathctl config token-signing-certificates rotate
- uipathctl config token-signing-certificates update
- uipathctl santé
- bundle d'intégrité uipathctl
- vérification de l'état uipathctl
- uipathctl health diagnose
- uipathctl health test
- manifeste uipathctl
- uipathctl manifest apply
- uipathctl manifest diff
- uipathctl manifest get
- uipathctl manifest get-revision
- uipathctl manifeste liste-applications
- uipathctl manifest list-revisions
- uipathctl manifest render
- uipathctl prérequis
- uipathctl prereq create
- uipathctl prereq run
- Ressource uipathctl
- rapport de ressource uipathctl
- instantané uipathctl
- sauvegarde d'instantané uipathctl
- uipathctl snapshot backup create
- uipathctl snapshot backup disable
- uipathctl snapshot backup enable
- uipathctl snapshot delete
- uipathctl snapshot list
- uipathctl snapshot restore
- uipathctl snapshot restore create
- uipathctl snapshot restore delete
- uipathctl snapshot restore history
- uipathctl snapshot restore logs
- uipathctl version
- Post-installation
- Migration et mise à niveau
- Mise à niveau d'Automation Suite sur EKS/AKS
- Étape 1 : Déplacement des données d'organisation Identity d'installation autonome vers Automation Suite
- Étape 2 : Restauration de la base de données du produit autonome
- Étape 3 : Sauvegarder la base de données de la plate-forme dans Automation Suite
- Étape 4 : Fusion des organisations dans Automation Suite
- Étape 5 : Mise à jour des chaînes de connexion du produit migré
- Étape 6 : migration de la version autonome d'Orchestrator
- Étape 7 : Migration d’Insights en version autonome
- Étape 8 : suppression du locataire par défaut
- B) Migration à locataire unique
- Migration d'Automation Suite sur Linux vers Automation Suite sur EKS/AKS
- Surveillance et alerte
- Administration du cluster
- Configuration spécifique au produit
- Utilisation de l'outil Orchestrator Configurator
- Configuration des paramètres d'Orchestrator
- Paramètres de l'application Orchestrator
- Configuration des paramètres d'application
- Configuration de la taille maximale de la requête
- Remplacement de la configuration du stockage au niveau du cluster
- Configuration des magasins d'informations d'identification
- Configuration de la clé de chiffrement par locataire
- Résolution des problèmes
Configuration du registre conforme à OCI
Dans les installations hors ligne, vous avez besoin d'un registre compatible OCI (Open Container Initiative) pour stocker les images de conteneur et les graphiques Helm de déploiement.
Il existe deux manières de télécharger les artefacts Automation Suite vers le registre compatible OCI externe :
- Option A : mettre en miroir votre registre compatible OCI avec le registre UiPath®.
- Option B : Hydrater votre registre compatible OCI avec le bundle hors ligne.
Le tableau suivant compare les deux options de téléchargement des artefacts dans le registre afin que vous puissiez choisir celle qui convient le mieux à vos besoins :
Option A : Mettre en miroir le registre |
Option B : hydrater le registre |
---|---|
Copie les artefacts du registre UiPath® vers n’importe quel registre cible. |
Utilise tarball hors ligne pour décompresser et télécharger les artefacts dans le registre cible. |
Nécessite les outils Docker et Helm. |
Nécessite les outils Podman et Helm. |
Nécessite un accès Internet lors de la copie des artefacts du registre UiPath® vers le registre cible. |
Nécessite un accès à Internet uniquement pour télécharger tarball hors ligne sur Jump Server. Le téléchargement de tarball ne nécessite pas d’accès à Internet. |
Nécessite un espace temporaire pour mettre les images en cache pendant la méthode de copie. Cet espace est généralement configuré lors de l'installation de Docker. Le dossier par défaut est
/var/lib/docker .
|
Nécessite un espace temporaire pour extraire tarball et un espace temporaire pour Podman afin de charger les images. L'emplacement d'extraction de tarball doit être fourni lors de l'étape d'hydratation. L'emplacement Podman peut être
/var/tmp , qui doit disposer d'un stockage adéquat.
|
La capacité de stockage requise pour
/var/lib/docker est d’environ 128 Go.
|
La capacité de stockage requise pour l'extraction est d'environ 200 Gio, et
/var/tmp doit être de 256 Gio.
|
Cette méthode nécessite un accès Internet sur la machine intermédiaire à partir de laquelle vous téléchargez les artefacts Automation Suite dans votre registre compatible OCI.
Prérequis pour mettre en miroir le registre UiPath®
Pour mettre en miroir le registre UiPath®, vous avez besoin des éléments suivants :
-
une machine virtuelle exécutant une distribution Linux (recommandé) ou un ordinateur portable (non recommandé) ;
-
un client Docker authentifié avec le registre privé ;
-
Helm 3.8 ou une version plus récente authentifié avec le registre privé ;
-
as-images.txt
; -
as-helm-charts.txt
; -
mirror-registry.sh
; -
connectivité sortante vers
registry.uipath.com
; -
128 Go d'espace disque libre pour Docker sous la partition
/var/lib/docker
, sur la machine à partir de laquelle vous téléchargez les images et les graphiques du conteneur.
Installation de Docker et Helm
Docker et Helm doivent être installés et authentifiés sur la machine à partir de laquelle vous prévoyez de télécharger les images de conteneur Automation Suite et les graphiques dans votre registre.
-
Pour télécharger les fichiers binaires Docker, consultez la documentation officielle.
-
Pour authentifier le registre Docker, consultez la documentation officielle. Vous pouvez également utiliser la commande suivante en remplaçant les exemples d'informations d'identification par vos informations d'identification de registre réelles :
docker login my.registry.io:443 --username "admin" --password "secret"
docker login my.registry.io:443 --username "admin" --password "secret" -
Pour télécharger les fichiers binaires Helm, consultez la documentation officielle.
-
Pour authentifier le registre Helm, consultez la documentation officielle. Vous pouvez également utiliser la commande suivante en remplaçant les exemples d'informations d'identification par vos informations d'identification de registre réelles :
helm registry login my.registry.io:443 --username "admin" --password "secret"
helm registry login my.registry.io:443 --username "admin" --password "secret"
Téléchargement du fichier as-images.txt
as-images.txt
, voir Téléchargement des bundles d'installation.
Téléchargement du fichier as-helm-charts.txt
as-helm-charts.txt
, voir Téléchargement des bundles d'installation.
Téléchargement des bundles Document Understanding facultatifs
Pour télécharger des bundles Document Understanding facultatifs, consultez la documentation Document Understanding.
Téléchargement de miroir-registre.sh
mirror-registry.sh
, consultez la section Téléchargement des packages d'installation.
Téléchargement des images Automation Suite dans votre registre
mirror-registry.sh
nécessite une connectivité sortante vers les registres source (registry.uipath.com
par défaut) et cible.
mirror-registry.sh
n'authentifie pas le registre. Il suppose que vous vous êtes déjà authentifié auprès du registre.
Drapeau |
Variable d'environnement |
Description |
---|---|---|
|
|
Obligatoire. Chemin d'accès au fichier manifeste de l'image. |
|
|
Obligatoire. Chemin d'accès au fichier manifeste du graphique Helm. |
|
|
Obligatoire. Transmettez l'URL du registre cible. |
|
|
Facultatif. Transmettez l'URL du registre source ; la valeur par défaut est
registry.uipath.com .
|
-
Assurez-vous que nous disposons des autorisations nécessaires pour exécuter le script Shell, en exécutant la commande suivante :
chmod +x mirror-registry.sh
chmod +x mirror-registry.sh -
Pour télécharger les images Automation Suite dans votre registre, exécutez la commande suivante :
./mirror-registry.sh --target-registry-url my.registry.io:443 --source-registry-url registry.uipath.com --images-manifest /home/myuser/as-images.txt --helm-charts-manifest /home/myuser/as-helm-charts.txt
./mirror-registry.sh --target-registry-url my.registry.io:443 --source-registry-url registry.uipath.com --images-manifest /home/myuser/as-images.txt --helm-charts-manifest /home/myuser/as-helm-charts.txt
Cette méthode nécessite uniquement un accès Internet sur la machine intermédiaire pour télécharger le bundle hors ligne. Une fois le bundle disponible, vous pouvez le télécharger vers votre registre compatible OCI sans connexion Internet.
Cette méthode peut également nécessiter un espace supplémentaire sur la machine pour le décompresser et télécharger dans votre registre. Quoi qu'il en soit, cette méthode peut prendre plus de temps que l'approche de mise en miroir.
Prérequis pour hydrater le registre
Pour hydrater le registre, vous avez besoin des éléments suivants :
- une machine virtuelle exécutant une distribution Linux est préférable à l'exécution du script sur un ordinateur portable ;
- possibilité de télécharger et de copier ou de propager d'une manière ou d'une autre manière le bundle hors ligne vers la machine virtuelle ;
- Helm 3.8 ou une version plus récente authentifié avec le registre privé ;
- Podman installé, configuré et authentifié avec le registre privé ;
- 150 Gio d'espace disque libre pour Podman sous
/var/lib/containers
pour charger les conteneurs localement avant de les transmettre au registre distant. Vous pouvez modifier le chemin par défaut en mettant à jour l'emplacement du chemin graphRoot dans la sortie de la commandepodman-info
. - Définissez la variable d'environnement
TMP_DIR
comme décrit dans la documentation officielle de Podman. as-cmk.tar.gz
Installation de Podman et Helm
Vous devez vous assurer que Podman et Helm sont installés et authentifiés sur la machine à partir de laquelle vous prévoyez de télécharger les images de conteneur Automation Suite et les graphiques dans votre registre.
- Pour télécharger les fichiers binaires Podman, consultez la documentation officielle.
- Pour vous authentifier auprès du registre Podman, consultez la documentation officielle. Vous pouvez également utiliser la commande suivante en remplaçant les exemples d'informations d'identification par vos informations d'identification de registre réelles :
podman login my.registry.io:443 --username "admin" --password "secret"
podman login my.registry.io:443 --username "admin" --password "secret" - Pour télécharger les fichiers binaires Helm, consultez la documentation officielle.
- Pour authentifier le registre Helm, consultez la documentation officielle. Vous pouvez également utiliser la commande suivante en remplaçant les exemples d'informations d'identification par vos informations d'identification de registre réelles :
helm registry login my.registry.io:443 --username "admin" --password "secret"
helm registry login my.registry.io:443 --username "admin" --password "secret"
Téléchargement de as-cmk.tar.gz
as-cmk.tar.gz
, voir Téléchargement des bundles d'installation.
Téléchargement des bundles Document Understanding facultatifs
Pour télécharger des bundles Document Understanding facultatifs, consultez la documentation Document Understanding.
Téléchargement de hydrate-registry.sh
hydrate-registry.sh
, consultez la section Téléchargement des packages d'installation.
Téléchargement des images Automation Suite dans le registre
hydrate-registry.sh
.
hydrate-registry.sh
ne nécessite pas de connectivité sortante, sauf avec les registres cibles.
hydrate-registry.sh
n'authentifie pas le registre. Il suppose que vous vous êtes déjà authentifié auprès du registre.
Drapeau |
Description |
---|---|
|
Obligatoire. Chemin d'accès au bundle hors ligne. |
|
Obligatoire. Transmettez l'URL du registre cible. |
|
Emplacement à utiliser pour décompresser le bundle hors ligne. Il peut s'agir d'un emplacement
/var/lib/containers ou d'un emplacement personnalisé. Assurez-vous d'avoir un minimum de 100 Gio de stockage. Il est recommandé d'avoir 256 Gio de stockage.
|
./hydrate-registry.sh --target-registry-url my.registry.io:443 --offline-bundle-path /path/to/as-cmk.tar.gz
./hydrate-registry.sh --target-registry-url my.registry.io:443 --offline-bundle-path /path/to/as-cmk.tar.gz
Pour configurer correctement votre registre externe compatible OCI, vous devez mettre à jour le magasin approuvé de toutes les machines sur lesquelles vous prévoyez d'installer Automation Suite. Pour obtenir des instructions sur la façon d'effectuer cette étape après l'installation, consultez Gestion des certificats.