Installation d'Automation Suite

Cette page vous guide à travers les instructions d'installation de haut niveau d'Automation Suite sur AKS et EKS.

Avant de commencer, tenez compte des points suivants :

• Il est nécessaire de disposer de connaissances sur la gestion des ressources cloud Kubernetes, AWS et Azure pour déployer et gérer Automation Suite sur AKS/EKS. Si vous rencontrez des problèmes pour installer et configurer Automation Suite sur AKS/EKS, contactez les services professionnels UiPath®.

• Avant de choisir votre profil de déploiement, consultez Scénarios de déploiement.

• Le processus d'installation génère des certificats auto-signés en votre nom. Vous devez les remplacer par des certificats signés par une autorité de certification (CA) approuvée dès que l'installation est terminée. Pour obtenir des instructions, consultez Gestion des certificats.

• Automation Suite prend en charge l'activation de la norme FIPS 140-2 (Federal Information Processing Standard 140-2) sur les nœuds AKS. Pour plus d’informations, consultez la section Sécurité et conformité. Vous ne pouvez pas activer la norme FIPS 140-2 sur les nœuds EKS.

Étape 1 : Configuration des prérequis de l'infrastructure

Avant d'installer Automation Suite, vous devez configurer les ressources cloud dans votre environnement. Cela comprend les éléments suivants :

• Cluster AKS ou EKS
• Obligatoire pour les installations hors ligne : registre externe compatible OCI
• Stockage d'objets - Azure Blob ou Amazon S3
• Bloquer le stockage
• Stockage de fichiers
• Bases de données
• Mise en cache
• Mise en réseau (par exemple, VNETs/VPC, DNS, sous-réseaux, NSG/groupes de sécurité, passerelle NAT, IP élastique et passerelle Internet)
• Politiques de mise en réseau
• Certificats

Pour obtenir des instructions sur les prérequis, consultez la section Les prérequis en un coup d'œil.

Facultatif : Configuration du proxy

Si vous utilisez un serveur proxy pour le trafic vers Internet, vous devez autoriser une liste d'URL et utiliser les paramètres no_proxy lors de la configuration du proxy. Pour obtenir des instructions sur la configuration de votre proxy, consultez Proxy.

Étape 2 : configuration du registre externe conforme à l'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.

Étape 3 : Téléchargement du logiciel sur votre machine cliente

Vous devez installer le logiciel suivant sur votre machine de gestion. La machine de gestion fait référence à la machine que vous utilisez pour faire fonctionner votre cluster et qui peut accéder à votre cluster via le fichier kubeconfig. Votre machine de gestion peut exécuter Linux, Windows ou MacOS.

Les outils suivants sont requis pour exécuter avec succès les vérifications des prérequis, l'installation et les étapes de post-installation sur votre cluster via la machine cliente.

Outil	Description	Télécharger
uipathctl	Requis. uipathctl est un outil de ligne de commande UiPath® qui vous permet d’exécuter des commandes sur Automation Suite Kubernetes hébergé sur Azure Kubernetes Service (AKS) et Amazon Elastic Kubernetes Service (EKS). Vous pouvez utiliser uipathctl pour vérifier les prérequis dans votre environnement, installer Automation Suite, le configurer et le gérer à partir d'une seule interface en ligne de commande (CLI) unifiée. Pour plus d'informations, y compris une liste complète des opérations uipathctl , consultez le.	Télécharger uipathctl Exécuter uipathctl
versions.json	Requis. Nécessaire pour effectuer les vérifications des prérequis et les étapes d'installation.	Télécharger versions.json
kubectl	Facultatif. Assurez-vous que kubectl correspond à la version de votre cluster	Télécharger kubectl

Étape 4 : Configuration de input.json

Vous devez modifier le fichier input.json afin de fournir les entrées requises par le programme d’installation uipathctl et effectuer des opérations telles que la configuration des chaînes de connexion SQL et des services UiPath® que vous souhaitez activer.

Nous fournissons différents modèles de fichiers input.json pour AKS et EKS. Pour obtenir des instructions sur la configuration de input.json, consultez Configuration du fichier input.json.

Vous pouvez éventuellement apporter vos propres composants qui font partie de la pile Automation Suite . Pour plus de détails sur les composants, voir Automation Suite sur la pile EKS/AKS. Pour plus de détails sur la configuration du composant que vous apportez, consultez Apportez vos propres composants.

Si vous effectuez une installation hors ligne, assurez-vous de configurer votre registre externe compatible OCI.

Pour installer Automation Suite sur EKS/AKS en mode hors ligne, vous devez suivre les étapes supplémentaires suivantes :

• Définissez explicitement la valeur du paramètre install_type sur offline dans le fichier input.json ;

• Configurez un registre externe conforme à OCI.

Étape 5 : Accès à votre cluster avec uipathctl

uipathctl nécessite l'accès au serveur KubeAPI pour effectuer des opérations au niveau du cluster telles que le déploiement, la création de ressources, etc. Pour accéder au serveur KubeAPI, uipathctl utilise le fichier kubeconfig , qui contient les informations d'identification de niveau administrateur nécessaires pour accéder au cluster. Ce fichier doit être présent dans le dossier ~/.kube/config (emplacement par défaut) de votre machine locale (de gestion).

Facultativement, si vous souhaitez stocker le fichier kubeconfig dans l'emplacement par défaut, vous pouvez également lui fournir l'aide de l'indicateur --kubeconfig lors de chaque exécution de uipathctl.

Par exemple, vous pouvez utiliser votre méthode préférée pour mettre à jour votre fichier ~/.kube/config à l'aide de la CLI AWS ou de la CLI Azure.

Étape 6 : Vérification des prérequis de l'infrastructure

Les vérifications des prérequis garantissent que l'infrastructure Cloud nécessaire est provisionnée de manière appropriée et accessible par la machine cliente avant de démarrer l'installation d' Automation Suite .

Le programme d'installation peut générer automatiquement les configurations suivantes en votre nom :

• Les bases de données SQL requises pour l'installation sur le serveur SQL, si la clé sql.create_db est définie dans votre fichier input.json .
• Les compartiments de stockage d'objets requis dans votre fournisseur de Cloud si la clé external_object_storage.create_bucket est définie dans le fichier de configuration.

Pour permettre au programme d'installation de générer ces configurations, exécutez la commande suivante :

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

Important :

La commande uipathctl prereq create ne crée pas les bases de données SQL requises pour Process Mining. Vous devez les créer manuellement en suivant les instructions de la section Fournissez votre propre base de données.

Pour vérifier les prérequis en fonction des entrées que vous avez configurées dans input.json, exécutez la commande suivante :

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

Pour vérifier les prérequis de l'installation, exécutez . Par défaut, la commande vérifie tous les prérequis. Cependant, elle vous permet également d'effectuer uniquement les vérifications qui vous intéressent :

• Si vous souhaitez exclure des composants de l'exécution, utilisez l'indicateur --excluded. Par exemple, si vous ne souhaitez pas vérifier les chaînes de connexion à la base de données, exécutez uipathctl prereq --excluded SQL. La commande exécute toutes les vérifications des prérequis, à l'exception de celle qui est relative à SQL.
• Si vous souhaitez inclure uniquement certains composants dans l'exécution, utilisez l'indicateur --included. Par exemple, si vous souhaitez uniquement vérifier le DNS et l'objectstore, exécutez uipathctl prereq --included DNS,OBJECTSTORAGE.

Remarque :

Vous pouvez trouver les noms des composants que vous pouvez inclure ou exclure des vérifications des prérequis ici. Dans l'exemple, le premier mot de chaque ligne en retrait représente le nom du composant. Par exemple : SQL, OBJECTSTORE, DNS, etc.

Attention : Vous pouvez recevoir un message de limitation d'AKS, tel que Waited for 1.0447523s en raison de la limitation côté client, et non de la priorité et de l'impartialité. Dans ce cas, attendez quelques minutes pour que la commande se termine complètement ou essayez de la réexécuter.

Pour obtenir un exemple de résultat de sortie, consultez Exemple de sortie : vérification des prérequis.

Vérifications des prérequis

Il est recommandé d'exécuter des vérifications des prérequis pour vous assurer que vous avez correctement configuré l'infrastructure Cloud et pour valider input.json avant de démarrer l'installation Automation Suite.

Vous pouvez exécuter une vérification des prérequis à l'aide de la commande . Par défaut, cette commande vérifie tous les prérequis. Vous pouvez utiliser les indicateurs suivants :

• --excluded, si vous souhaitez exclure des composants de l'exécution.
• --verbose, si vous souhaitez accéder à la sortie de vérification détaillée des prérequis. Vous pouvez ignorer cet indicateur pour une sortie plus précise et simplifiée.

Les prérequis et les vérifications/tests d'intégrité s'exécutent dans l'espace de noms uipath-check. Vous devez soit autoriser la création de l'espace de noms uipath-check, soit le créer vous-même avant d'exécuter les vérifications/tests. De plus, des vérifications/tests nécessitent que vous autorisiez la communication entre les espaces de noms uipath-check et uipath, ou que vous activiez l'utilisation de hostNetwork.

Les vérifications du tableau suivant sont exécutées sur chaque nœud :

Vérifier (Check)	Description
Connexion SQL	Confirme qu’Automation Suite peut se connecter avec succès au serveur SQL pour les produits UiPath® et les services partagés (identification, portail, gestion de l’organisation, etc.) à l’aide des chaînes de connexion SQL fournies dans input.json. Cette vérification est obligatoire pour réussir l’installation.
Rôles de la base de données SQL	Valide les rôles et autorisations requis par les produits UiPath®. Cette vérification est obligatoire pour réussir l’installation.
Compatibilité de la base de données SQL	Valide les exigences de compatibilité de la base de données SQL.
Résolution du nom de domaine complet	Vérifie que le nom de domaine complet et les sous-domaines peuvent être résolus avec succès.
API de stockage d'objets	Confirme que les API du magasin d’objets sont accessibles en se basant sur les informations d’accès fournies dans input.json. Cette vérification est obligatoire pour réussir l’installation des services UiPath®.
Cache/Redis	Valide la connexion à Cloud Redis ou ElastiCache. Ceci est obligatoire pour une installation réussie.
Capacité	Vérifie que vous disposez de la capacité minimale du processeur et de la RAM des nœuds de travail en fonction des produits activés dans input.json.
Classe de stockage	Vérifie que les classes de stockage pour le stockage de fichiers sont configurées comme requis pour Automation Suite Robot.
Composants facultatifs	Vérifie que votre cluster contient des composants que vous avez choisi d'exclure de l'installation d' Automation Suite .
Entrée	Confirme que l’entrée du cluster a été configurée correctement et que les requêtes URL des noms de domaine complets peuvent accéder aux produits UiPath®.
Stratégies réseau	Vérifie si les politiques réseau configurées dans Automation Suite sont compatibles avec le cluster.
Registre	Confirme qu’Automation Suite peut accéder au registre docker UiPath®. Cette vérification est obligatoire pour réussir l’installation.
Connectivité du cluster	Vérifie si la communication du cluster est configurée correctement : Entre deux pods aléatoires terminés Entre un pod et un ClusterIP multi-nœuds Entre le pod et une IP de cluster multi-nœuds sans IP de cluster Entre un pod et un ClusterIP multi-nœuds à l'aide de HostNetwork Entre le pod et une IP de cluster multi-nœuds sans IP de cluster définie à l'aide de HostNetwork Entre deux pods colocalisés sur le même nœud via ClusterIP

Étape 7 : installation d'Automation Suite

Remarque :

Pour voir quels scénarios de déploiement sont disponibles pour Automation Suite sur AKS/EKS, consultez la section Scénarios de déploiement.

1. Après avoir validé avec succès les prérequis, vous pouvez procéder à l'installation d'Automation Suite en exécutant la commande suivante :

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

   Pour obtenir un exemple de sortie, consultez Exemple de sortie : installation Automation Suite .
   Remarque :

   Si vous rencontrez des problèmes lors de l'exécution de l'installation, réexécutez la commande des commandes d'installation avec tous les arguments et indicateurs. Pour plus de détails sur les problèmes que vous pourriez rencontrer, consultez la section Résolution des problèmes ( Troubleshooting).

2. Pour vérifier que votre installation est réussie et que les services sont sains, exécutez la commande suivante :

   uipathctl health check