Utilisation de uipathctl.sh

Le script uipathctl.sh fournit un moyen automatisé de mettre à niveau un cluster vers une version plus récente, de configurer une sauvegarde, de restaurer un cluster, etc., en l'exécutant sur un nœud. L'automatisation de ces tâches se fait via l'outil d'automatisation informatique Ansible.

Prérequis

Ansible utilise le mécanisme SSH pour se connecter à l'un des nœuds hôtes ou des machines afin d'effectuer des tâches.

Avant d'exécuter le script uipathctl.sh , vous devez suivre les étapes suivantes :

1. Identifiez le nœud hôte Ansible.
2. Ajoutez la signature SSH de vos nœuds aux hôtes connus.
3. Configurez la méthode d'authentification SSH.
4. Installez Ansible et les autres outils prérequis.

Pour obtenir des instructions, consultez les sections suivantes.

Identifier le nœud hôte Ansible

Le nœud hôte Ansible est la machine sur laquelle vous installez Ansible. Cette machine doit être un nœud de serveur afin qu'elle dispose des autorisations requises pour effectuer toutes les automatisations du cluster.

Dans les installations en ligne, le nœud hôte Ansible peut être l'un des nœuds du serveur.

Dans les installations hors ligne, le nœud hôte Ansible doit être le nœud de serveur principal sur lequel vous avez monté le disque de bundle UiPath à l'emplacement /uipath . S'il n'y a pas de nœud de serveur auquel le disque de bundle UiPath est connecté, vous pouvez simplement monter un disque supplémentaire sur l'un des nœuds de serveur existants et le considérer comme le nœud hôte Ansible.

Ajouter la signature SSH de vos nœuds aux hôtes connus

Pour ajouter la signature SSH de votre nœud aux hôtes connus, ajoutez l'adresse IP privée de chaque nœud du cluster au fichier known_hosts dans le nœud hôte Ansible.

Exécutez la commande suivante sur le nœud hôte Ansible en remplaçant <node-private-ip> par l'adresse IP privée de chaque nœud du cluster, un à la fois.

ssh-keyscan -H <node-private-ip> >> ~/.ssh/known_hosts

Configuration de la méthode d'authentification SSH

Ansible prend en charge deux mécanismes SSH :

• Option 1 : Authentification SSH par clé – Recommandée. Il utilise des clés privées et publiques.
• Option 2 : Authentification SSH basée sur un mot de passe

Option 1 : Authentification SSH par clé (recommandée)

Étape 1 : configuration de la clé SSH

Le mécanisme d'authentification par clé SSH utilise une combinaison de clés privées et publiques.

Assurez-vous d'accorder l'accès à la clé publique du nœud hôte Ansible sur tous les autres nœuds en la copiant.

Si vous ne possédez pas de clé SSH, vous pouvez en générer une en exécutant la commande ssh-keygen .

Génération de clés SSH

Vous pouvez générer une nouvelle clé SSH à l'aide de la commande ssh-keygen . Pour générer la nouvelle clé SSH, exécutez simplement la commande ssh-keygen et suivez les instructions.

Pour générer une nouvelle clé SSH, procédez comme suit :

1. Générez une nouvelle clé SSH à l'aide de la commande ssh-keygen .

2. Notez l’emplacement de votre clé. Les valeurs par défaut sont :

   • Clé publique : ~/.ssh/id_rsa.pub
   • Clé privée : ~/.ssh/id_rsa
3. Accordez l'accès à la clé publique du nœud hôte Ansible sur tous les autres nœuds en la copiant.

Accorder l'accès à la clé publique sur chaque nœud

Pour accorder l'accès à la clé publique, copiez-la sur tous les nœuds du cluster (y compris le nœud actuel) à l'aide de la commande ssh-copy-id . Si le chemin de la clé publique SSH n'est pas ~/.ssh/id_rsa.pub , assurez-vous de le remplacer en conséquence.

ssh-copy-id -i ~/.ssh/id_rsa.pub username@node-private-ip

Étape 2 : Fournir un accès par clé SSH à Ansible

Ansible utilise le mécanisme SSH pour se connecter aux machines hôtes et effectuer l'installation requise. Pour cette raison, vous devez fournir l'accès de clé SSH à Ansible.

Choisissez parmi les méthodes suivantes :

• Option 1 : utilisation de ssh-agent (recommandé)
• Option 2 : utiliser une clé privée non protégée

Option 1 : utilisation de ssh-agent (recommandé)

Par défaut, Ansible utilise ssh-agent pour obtenir l'accès aux nœuds. Pour plus d'informations sur ssh-agent, consultez le manuel de ssh-agent.

Pour ajouter une nouvelle clé à ssh-agent , exécutez la commande suivante :

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_rsa

Option 2 : utiliser une clé privée non protégée

Remarque : cette option n'est prise en charge que si votre clé privée n'est pas protégée par une phrase secrète.

Cette méthode consiste à utiliser la clé privée de manière interactive, en ajoutant le paramètre --ansible-private-key à votre script uipathctl.sh . Le paramètre prend le chemin absolu de la clé privée et l'utilise pour l'authentification.

Option 2 : Authentification SSH basée sur un mot de passe

Si vous optez pour l'authentification SSH par mot de passe, vous devez fournir le paramètre --ansible-ask-password au script uipathctl.sh . Ce paramètre vous invite à fournir le mot de passe pour l'authentification.

Installation d'Ansible et d'autres outils prérequis

Vérifier si Ansible et les autres outils prérequis sont installés

Vous devez vous assurer qu'Ansible et les autres outils de prise en charge suivants sont installés sur le nœud hôte Ansible précédemment sélectionné.

• ansible (v2.8+)
  Pour vérifier si ansible a été installé, exécutez :

  ansible --version &>/dev/null || echo "Error: Ansible is not installed"

• ansible-playbook

  Pour vérifier si ansible-playbook a été installé, exécutez :

  ansible-playbook --version &>/dev/null || echo "Error: Ansible Playbook is not installed"

• sshpass – Obligatoire uniquement lors de l'utilisation du mot de passe pour l'authentification avec le paramètre --ansible-ask-password .
  Pour vérifier si sshpass a été installé, exécutez :

  sshpass -V &>/dev/null || echo "Error: sshpass is not installed"

• zip – Pour vérifier si zip a été installé, exécutez :

  zip --version &>/dev/null || echo "Error: zip is not installed"

  Important : si l'une des commandes précédentes génère une erreur, le package ciblé n'est pas installé sur votre machine. Pour installer tous les outils souhaités, suivez les étapes décrites dans la section suivante. Si tous les outils sont déjà installés, vous pouvez ignorer ces étapes.

Installation d'Ansible et d'autres outils prérequis

Pour installer Ansible et d'autres packages associés, procédez comme suit :

1. Accédez au dossier du programme d'installation sur le nœud hôte Ansible. Le programme d'installation se trouve généralement dans le dossier /opt/UiPathAutomationSuite/{version} .
2. Exécutez les commandes suivantes :

• Pour en ligne :

  ./uipathctl.sh install-prerequisites --install-type online --accept-license-agreement

  • Pour le mode hors connexion :

Vous avez besoin d'une archive tar Ansible supplémentaire, qui contient des packages Ansible et d'autres packages dépendants. Téléchargez ansible.tar.gz et stockez-le n'importe où en dehors du dossier du programme d'installation. Pour obtenir des instructions de téléchargement, consultez ansible.tar.gz.

Si ansible.tar.gz se trouve à un emplacement différent, mettez à jour l'emplacement absolu du paramètre --offline-prerequisites-bundle .

./uipathctl.sh install-prerequisites --install-type offline --offline-prerequisites-bundle ../ansible.tar.gz --accept-license-agreement

Configuration Ansible avancée

Génération du fichier Ansible Inventory.ini

Dans certains scénarios, comme lors de la configuration de la sauvegarde ou de la mise à niveau, Automation Suite génère automatiquement le fichier inventory.ini pour Ansible. Cependant, il existe quelques situations dans lesquelles vous devez générer et fournir le fichier inventory.ini à Ansible. Par exemple :

• Lors de la restauration du cluster à partir des données de sauvegarde. En effet, au moment de la restauration, il n'existe aucun cluster sain pour dériver inventory.ini .
• Lorsque vous souhaitez fournir une configuration avancée telle que le nom d'utilisateur et la clé SSH, qui est très spécifique à chaque nœud.

Pour plus de détails, consultez Comment créer votre propre inventaire.

Le bloc de code suivant affiche le modèle d'inventaire que le script uipathctl.sh comprend.

[FIRST_SERVER]
'10.0.1.1'
[SECONDARY_SERVERS]
'10.0.1.2'
'10.0.1.3'
[AGENTS]
'10.0.1.4'
'10.0.1.5'
[TASKMINING]
'10.0.1.6'
[GPU]
'10.0.1.7'
[all:vars]
ansible_connection=ssh
ansible_timeout=10
ansible_user=admin

Groupe	Valeur (Value)
[FIRST_SERVER]	Le point de départ où vous exécutez le script uipathctl.sh . C’est aussi ce qu’on appelle le nœud hôte Ansible. Vous devez fournir l'adresse IP privée de ce nœud.
[SECONDARY_SERVER]	Le groupe d'autres nœuds de serveur dans le cluster. Vous devez fournir l'adresse IP privée de tous les autres nœuds de serveur.
[AGENTS]	Le groupe de nœuds d'agent dans le cluster. Vous devez fournir l'adresse IP privée de tous les nœuds GPU.
[TASKMINING]	Le groupe de nœuds Task Mining dans le cluster. Vous devez fournir l'adresse IP privée de tous les nœuds GPU.
[GPU]	Le groupe de nœuds GPU dans le cluster. Vous devez fournir l'adresse IP privée de tous les nœuds GPU.
[all:vars]	Groupe de variables appliqué à tous les groupes d'hôtes précédemment définis. ansible_connection : la méthode d'authentification. Deux mécanismes SSH sont pris en charge : l'authentification SSH par clé et l'authentification SSH par mot de passe. ansible_timeout : la durée par défaut pendant laquelle une connexion SSH peut être établie avant que l'opération n'expire. Il contrôle également le temps nécessaire pour accéder à la connexion, une fois établie. ansible_user : le nom de l'utilisateur qui se connecte au serveur distant. Vous pouvez fournir les variables par groupe ou par nœud d'hôte. Pour plus de détails, consultez Affectation d'une variable à plusieurs machines : variables de groupe.

Génération du fichier de variable Ansible

Pour l'orchestration Ansible sur d'autres nœuds, vous devez définir certains paramètres qu'Ansible utilise pour déterminer l'emplacement du programme d'installation et des fichiers correspondants sur d'autres nœuds. Ces paramètres sont définis dans le fichier Yaml et fournis à Ansible.

Si vous souhaitez modifier la configuration par défaut, créez un fichier au format suivant et fournissez-le à uipathctl.sh à l'aide de --ansible-variables-file .

#Path where installer zip is available. By default, uipathctl.sh takes the current folder and compress it to zip before copying it to other nodes.
installer_path: /path/to/installer.zip
# Path where installer will be copied on nodes
target_installer_base_path: /opt/UiPathAutomationSuite/<version>/installer
# Install type - online or offline
install_type: online
# Path on nodes where offline bundles will be copied
target_bundle_base_path: /opt/UiPathAutomationSuite/{version}
# Path on nodes where offline bundles will be extracted
target_tmp_path: /opt/UiPathAutomationSuite/tmp
# Basepath and filname for the various config files and bundles on the local machine
cluster_config_filename: cluster_config.json
cluster_config_basepath: /var/tmp/uipathctl_{version}
backup_config_filename: backup_config.json
backup_config_basepath: /var/tmp/uipathctl_{version}
restore_config_filename: restore.json
restore_config_basepath: /var/tmp/uipathctl_{version}
infra_bundle_filename: sf-infra.tar.gz
infra_bundle_basepath: /var/tmp/uipath_upgrade_<version>

Variable	Valeur (Value)
installer_path	Le chemin de sf-installer.zip . Si vous ne fournissez pas cette valeur, uipathctl.sh compressera le répertoire actuel et le copiera sur d'autres nœuds, en tant que zip d'installation.
target_installer_base_path	Le chemin où le programme d'installation sera copié sur les nœuds. La valeur par défaut est `/opt/UiPathAutomationSuite/{version
install_type	La méthode d'installation. Les valeurs possibles sont : online et offline .
target_bundle_base_path	Chemin d'accès aux nœuds où les bundles hors ligne seront copiés. L'emplacement par défaut est /var/tmp/uipathctl_{version} .
target_tmp_path	Chemin d'accès aux nœuds où le bundle est extrait. L'emplacement par défaut est /opt/UiPathAutomationSuite/tmp .
cluster_config_filename	Le nom du fichier de configuration du cluster. La valeur par défaut est cluster_config.json .
cluster_config_basepath	L'emplacement où cluster_config.json sera stocké temporairement sur les nœuds pendant l'orchestration. La valeur par défaut est /var/tmp/uipathctl_{version} .
backup_config_filename	Le nom du fichier de configuration de sauvegarde. La valeur par défaut est backup.json .
backup_config_basepath	L'emplacement où backup.json sera stocké temporairement sur les nœuds pendant l'orchestration. La valeur par défaut est /var/tmp/uipathctl_{version} .
restore_config_filename	Le nom du fichier de configuration de restauration. La valeur par défaut est restore.json .
restore_config_basepath	L'emplacement où restore.json sera stocké temporairement sur les nœuds pendant l'orchestration. La valeur par défaut est `/var/tmp/uipathctl_{version
infra_bundle_filename	Le nom du bundle contenant les couches d'infrastructure. C'est le même que celui que vous avez fourni au script uipathctl.sh .
infra_bundle_basepath	L'emplacement où sf-infra.tar.gz sera stocké temporairement sur les nœuds pendant l'orchestration. C'est le même que celui que vous avez fourni au script uipathctl.sh .