Installation d'Automation Suite sur EKS/AKS

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 :

• Cluster AKS ou EKS
• Hors ligne uniquement : registre externe compatible OCI
• Stockage d'objets - Azure Blob ou Amazon S3
• Bloquer le stockage
• Stockage de fichiers
• Base de donnés
• 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)
• Certificats
• Politiques de mise en réseau

Pour obtenir des instructions sur les prérequis, consultez Exigences.

Facultatif : Configuration du proxy

Si vous utilisez un serveur proxy pour le trafic 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 Configuration du 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 la documentation de référence uipathctl.	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 uipathctl prereq. 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.

É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 .
2. Pour relancer l'installation, utilisez la même commande qu'à l'étape 1, avec tous les arguments et indicateurs.
3. Pour vérifier que votre installation est réussie et que les services sont sains, exécutez la commande suivante :

   uipathctl health check

Remarque :

Si vous rencontrez des problèmes lors de l'installation, consultez la section Résolution des problèmes (Troubleshooting).