Executando o uipathctl

Instale e execute a ferramenta uipathctl CLI para gerenciar o Automation Suite no OpenShift.

uipathctl é uma ferramenta de linha de comando da UiPath® que permite executar várias operações no Automation Suite no EKS/AKS, Automation Suite no OpenShift e Automation Suite no Linux.

Você pode usar uipathctl para verificar pré-requisitos em seu ambiente, instalar o Automation Suite, além de configurá-lo e gerenciá-lo a partir de um único CLI unificado.

Você pode instalar uipathctl nas plataformas Linux, macOS e Windows.

No momento, o uipathctl é compatível apenas com a arquitetura x86. Você não pode executar o uipathctl em máquinas baseadas na arquitetura ARM, como Macs com CPUs Apple Silicon (série M).

Para obter detalhes, incluindo uma lista completa de operações uipathctl , consulte o Guia de Referência do uipathctl.

Operações Comuns

Após instalar uipathctl, os comandos principais para uma instalação do Automation Suite são:

• uipathctl prereq create input.json --versions versions.json - gere os bancos de dados SQL e buckets de armazenamento de objetos necessários. Consulte Configuração dos recursos necessários.
• uipathctl prereq run input.json --versions versions.json - valide o ambiente antes de instalar. Consulte Verificações de pré-requisitos.
• uipathctl manifest apply input.json --versions versions.json - instale o Automation Suite. Consulte Instalação do Automation Suite.

Para obter a lista de comandos completa, consulte o Guia de referência do uipathctl.

Instalação do uipathctl no Linux

Para instalar uipathctl no Linux, siga os seguintes passos:

1. Baixe a versão do binário uipathctl na qual você está interessado. Para obter instruções, consulte Download dos pacotes de instalação.

2. Descompacte uipathctl e adicione-o ao seu PATH:

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

3. Verifique se uipathctl funciona:

   uipathctl version
   

   O comando imprime algumas informações da versão, conforme mostrado no exemplo a seguir:

   Version:       2.2510.0
   ...
   

Instalação do uipathctl no Windows

Para instalar uipathctl no Windows, siga os seguintes passos:

1. Baixe a versão do binário uipathctl na qual você está interessado. Para obter instruções, consulte Download dos pacotes de instalação.

2. Descompacte uipathctl e adicione-o ao seu PATH:

   tar xzvf uipathctl-windows-amd64.tar.gz
   

   Anexe ou anexe a pasta binária uipathctl à sua variável de ambiente PATH .

3. Verifique se está funcionando:

   uipathctl version
   

   O comando imprime algumas informações da versão, conforme mostrado no exemplo a seguir:

   Version:       2.2510.0
   ...
   

Instalação do uipathctl no macOS

Para instalar uipathctl no macOS, siga as seguintes etapas:

1. Baixe a versão do binário uipathctl na qual você está interessado. Para obter instruções, consulte Download dos pacotes de instalação.

2. Descompacte uipathctl e adicione-o ao seu PATH:

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

3. Verifique se uipathctl funciona:

   uipathctl version
   

   O comando imprime algumas informações da versão, conforme mostrado no exemplo a seguir:

   Version:       2.2510.0
   ...
   

Especificando o arquivo kubeconfig

Por padrão, uipathctl usa o arquivo kubeconfig no local padrão (~/.kube/config no Linux e macOS ou o caminho do perfil do usuário equivalente no Windows). Esse kubeconfig determina qual cluster e quais credenciais uipathctl usa para executar cada comando.

Se você precisar uipathctl usar um arquivo kubeconfig diferente, certifique-se de que ele esteja configurado adequadamente para cada comando que você executar. Caso contrário, uipathctl retorna ao kubeconfig padrão.

Você pode especificar o arquivo kubeconfig de uma das seguintes maneiras:

• Defina a variável de ambiente KUBECONFIG como o caminho do seu arquivo kubeconfig. Todos os comandos uipathctl subsequentes usam esse arquivo:

  export KUBECONFIG=<kubeconfigpath>
  

• Passe o sinalizador --kubeconfig para cada comando uipathctl:

  uipathctl <command> --kubeconfig <kubeconfigpath>
  

Para ver todos os sinalizadores disponíveis para um determinado comando, incluindo --kubeconfig, execute:

uipathctl <command> --help

Telemetria

Por padrão, a telemetria é enviada de uipathctl para a UiPath® em cada execução de comando. Isso nos ajuda a melhorar nossos produtos e a experiência do usuário.

Para optar por desativar a telemetria, defina a variável de ambiente UIPATHCTL_TELEMETRY_OPTOUT como 1:

export UIPATHCTL_TELEMETRY_OPTOUT=1