Exécution de uipathctl

Installez et exécutez l’outil CLI uipathctl pour gérer Automation Suite sur OpenShift.

uipathctl is a UiPath® command-line tool that allows you to perform various operations in Automation Suite on EKS/AKS, Automation Suite on OpenShift, and Automation Suite on Linux.

Vous pouvez utiliser uipathctl pour vérifier les prérequis dans votre environnement, installer Automation Suite, ainsi que le configurer et le gérer à partir d'une seule interface en ligne de commande (CLI) unifiée.

Vous pouvez installer uipathctl sur les plates-formes Linux, macOS et Windows.

Actuellement, uipathctl n'est compatible qu'avec l'architecture x86. Vous ne pouvez pas exécuter uipathctl sur des machines basées sur l'architecture ARM, telles que les Mac avec des processeurs Apple Silicon (série M).

For details, including a complete list of uipathctl operations, refer to the uipathctl Reference Guide.

Opérations courantes

Après avoir installé uipathctl, les principales commandes d'une installation Automation Suite sont:

• uipathctl prereq create input.json --versions versions.json: génère les bases de données SQL et les compartiments de stockage d'objets requis. Référez-vous à Configuration des ressources requises.
• uipathctl prereq run input.json --versions versions.json - validez l'environnement avant l'installation. Reportez-vous à la section Vérifications des prérequis.
• uipathctl manifest apply input.json --versions versions.json: installez Automation Suite. Référez-vous à la section Installation d’Automation Suite.

For the full command list, refer to the uipathctl Reference Guide.

Installer uipathctl sur Linux

Pour installer uipathctl sur Linux, procédez comme suit:

1. Download the version of the uipathctl binary that you are interested in. For instructions, refer to Downloading the installation packages.

2. Décompressez uipathctl et ajoutez-le à votre PATH :

   tar xzvf uipathctl-linux-amd64.tar.gz
   chmod +x uipathctl
   export PATH=$PATH:$(pwd)
   

3. Vérifiez si uipathctl fonctionne :

   uipathctl version
   

   La commande imprime des informations de version, comme illustré dans l'exemple suivant :

   Version:       2.2510.0
   ...
   

Installation de uipathctl sous Windows

Pour installer uipathctl sur Windows, procédez comme suit:

1. Download the version of the uipathctl binary that you are interested in. For instructions, refer to Downloading the installation packages.

2. Décompressez uipathctl et ajoutez-le à votre PATH :

   tar xzvf uipathctl-windows-amd64.tar.gz
   

   Ajoutez ou ajoutez le dossier binaire uipathctl à votre variable d'environnement PATH .

3. Vérifiez que cela fonctionne :

   uipathctl version
   

   La commande imprime des informations de version, comme illustré dans l'exemple suivant :

   Version:       2.2510.0
   ...
   

Installation de uipathctl sur macOS

Pour installer uipathctl sur macOS, procédez comme suit:

1. Download the version of the uipathctl binary that you are interested in. For instructions, refer to Downloading the installation packages.

2. Décompressez uipathctl et ajoutez-le à votre PATH :

   tar xzvf uipathctl-darwin-amd64.tar.gz
   chmod +x uipathctl
   export PATH=$PATH:$(pwd)
   

3. Vérifiez si uipathctl fonctionne :

   uipathctl version
   

   La commande imprime des informations de version, comme illustré dans l'exemple suivant :

   Version:       2.2510.0
   ...
   

Spécification du fichier kubeconfig

Par défaut, uipathctl utilise le fichier kubeconfig à l'emplacement par défaut (~/.kube/config sous Linux et macOS, ou le chemin de profil utilisateur équivalent sous Windows). Ce kubeconfig détermine le cluster et les informations d'identification utilisés par uipathctl pour exécuter chaque commande.

Si vous avez besoin que uipathctl utilise un fichier kubeconfig différent, assurez-vous qu'il est configuré en conséquence pour chaque commande que vous exécutez. Sinon, uipathctl revient à la valeur kubeconfig par défaut.

Vous pouvez spécifier le fichier kubeconfig de l'une des manières suivantes:

• Définissez la variable d'environnement KUBECONFIG sur le chemin d'accès de votre fichier kubeconfig. Toutes les commandes uipathctl ultérieures utilisent ce fichier:

  export KUBECONFIG=<kubeconfigpath>
  

• Passez l'indicateur --kubeconfig à chaque commande uipathctl:

  uipathctl <command> --kubeconfig <kubeconfigpath>
  

Pour voir tous les indicateurs disponibles pour une commande donnée, y compris --kubeconfig, exécutez:

uipathctl <command> --help

Télémétrie

La télémétrie est envoyée par défaut depuis uipathctl vers UiPath® à chaque exécution de commande. Cela nous permet d’améliorer nos produits ainsi que l’expérience utilisateur.

Pour refuser la télémétrie, définissez la variable d'environnement UIPATHCTL_TELEMETRY_OPTOUT sur 1:

export UIPATHCTL_TELEMETRY_OPTOUT=1