Ejecutar uipathctl

Instala y ejecuta la herramienta CLI uipathctl para gestionar Automation Suite en 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.

Puedes utilizar uipathctl para comprobar los requisitos previos en tu entorno, instalar Automation Suite, así como configurarlo y gestionarlo desde una única CLI unificada.

Puedes instalar uipathctl en las plataformas Linux, macOS y Windows.

Actualmente, uipathctl solo es compatible con la arquitectura x86. No puedes ejecutar uipathctl en máquinas basadas en la arquitectura ARM, como Mac con CPU Apple Silicon (serie M).

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

Operaciones comunes

Después de instalar uipathctl, los comandos principales para una instalación de Automation Suite son:

• uipathctl prereq create input.json --versions versions.json: genera las bases de datos SQL y los depósitos de almacenamiento de objetos necesarios. Consulta Configurar los recursos necesarios.
• uipathctl prereq run input.json --versions versions.json: valida el entorno antes de instalar. Consulta Comprobaciones de requisitos previos.
• uipathctl manifest apply input.json --versions versions.json: instala Automation Suite. Consulta Instalar Automation Suite.

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

Instalar uipathctl en Linux

Para instalar uipathctl en Linux, realiza los siguientes pasos:

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

2. Descomprime uipathctl y agrégalo a tu RUTA:

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

3. Verificar si uipathctl funciona:

   uipathctl version
   

   El comando imprime información de versión, como se muestra en el siguiente ejemplo:

   Version:       2.2510.0
   ...
   

Instalar uipathctl en Windows

Para instalar uipathctl en Windows, realiza los siguientes pasos:

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

2. Descomprime uipathctl y agrégalo a tu RUTA:

   tar xzvf uipathctl-windows-amd64.tar.gz
   

   Añade o antecede la carpeta binaria uipathctl a tu variable de entorno PATH .

3. Verificar que funciona:

   uipathctl version
   

   El comando imprime información de versión, como se muestra en el siguiente ejemplo:

   Version:       2.2510.0
   ...
   

Instalar uipathctl en macOS

Para instalar uipathctl en macOS, realiza los siguientes pasos:

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

2. Descomprime uipathctl y agrégalo a tu RUTA:

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

3. Verificar si uipathctl funciona:

   uipathctl version
   

   El comando imprime información de versión, como se muestra en el siguiente ejemplo:

   Version:       2.2510.0
   ...
   

Especificar el archivo kubeconfig

De forma predeterminada, uipathctl utiliza el archivo kubeconfig en la ubicación predeterminada (~/.kube/config en Linux y macOS, o la ruta de perfil de usuario equivalente en Windows). Este kubeconfig determina qué clúster y qué credenciales utiliza uipathctl para ejecutar cada comando.

Si necesitas uipathctl utilizar un archivo kubeconfig diferente, asegúrate de que esté configurado en consecuencia para cada comando que ejecutes. De lo contrario, uipathctl vuelve al valor predeterminado de kubeconfig.

Puedes especificar el archivo kubeconfig de cualquiera de las siguientes maneras:

• Establece la variable de entorno KUBECONFIG en la ruta de tu archivo kubeconfig. Todos los comandos uipathctl posteriores utilizan este archivo:

  export KUBECONFIG=<kubeconfigpath>
  

• Pasa el marcador --kubeconfig a cada comando uipathctl:

  uipathctl <command> --kubeconfig <kubeconfigpath>
  

Para ver todos los marcadores disponibles para un comando determinado, incluido --kubeconfig, ejecuta:

uipathctl <command> --help

Telemetría

De forma predeterminada, la telemetría se envía desde uipathctl a UiPath® en cada ejecución de comando. Esto nos ayuda a mejorar nuestros productos y la experiencia de usuario.

Para cancelar la telemetría, establece la variable de entorno UIPATHCTL_TELEMETRY_OPTOUT en 1:

export UIPATHCTL_TELEMETRY_OPTOUT=1