- Visão geral
- UiPath CLI
- Sobre o UiPath CLI
- Baixando o UiPath CLI
- Matriz de compatibilidade
- Executando o UiPath CLI
- Gerenciando feeds do NuGet
- Suporte do Test Manager
- Empacotando projetos em um pacote
- Assinatura de pacotes de projetos
- Análise de um projeto
- Implantação de um pacote no Orchestrator
- Executando um trabalho dentro do Orchestrator
- Teste de um pacote ou execução de um conjunto de testes
- Teste de vários pacotes
- Implantação de ativos no Orchestrator
- Exclusão de ativos do Orchestrator
- Executando tarefas usando a configuração JSON
- Restaurando dependências de automação
- Solução de problemas do UiPath CLI
- Extensão do Azure DevOps
- Plug-in do Jenkins
Guia do usuário de integrações de CI/CD
Sobre o UiPath CLI
A UiPath® fornece uma interface de linha de comando (CLI) que permite executar tarefas de ciclo de vida de automação, como empacotamento, implantação, testes e execução de automações no Orchestrator. A CLI foi projetada para integração com ferramentas de terceiros, como GitLab, Jenkins ou Azure DevOps, permitindo que as equipes de automação adotem as melhores práticas de CI/CD em escala.
A UiPath CLI pode ser usada com o Orchestrator implantado por meio do Automation Cloud™, Automation Suite ou Independente.
Casos de uso comum
A UiPath CLI foi criada para habilitar o Gerenciamento do ciclo de vida da automação (ALM) por meio da integração perfeita com pipelines de CI/CD.
Ele permite que as equipes de automação:
- Empacote e versione projetos de RPA (multiplataforma, Windows, Windows - Legado) em artefatos Portable do NuGet.
- Implante e promova projetos em diferentes ambientes usando pipelines repetíveis e auditáveis.
- Integre-se a ferramentas externas, como o Azure DevOps, GitLab ou Jenkins para integração e implantação contínuas.
- Empacote, implante e ative soluções de vários projetos, combinando RPA, fluxos de trabalho de agentes, processos de API e configuração em uma única unidade com controle de versão.
Isso permite a entrega de automação de nível empresarial em escala, totalmente alinhada com as práticas de DevOps.
Suporte a soluções
A UiPath CLI suporta soluções — um formato de pacote que combina vários tipos de projeto e configurações em uma única unidade implantável.
As soluções podem incluir:
- Projetos multiplataforma ou Windows RPA (os projetos Windows - Legado não são compatíveis com Soluções).
- Agentes, processos com agente e fluxos de trabalho de API.
- Arquivos de configuração e associação do ambiente.
Isso simplifica como as equipes empresariais gerenciam a automação de pilha completa e aplicam a regra de DevOps em ambientes e tenants.
Saiba mais em Trabalhando com soluções.
Pacotes de CLI
O UiPath CLI é distribuído nos seguintes pacotes:
| Nome do Pacote | SO compatível | Tipos de projeto compatíveis |
|---|---|---|
UiPath.CLI.Windows | Windows | Projetos de RPA (multiplataforma/Windows), Soluções |
UiPath.CLI.Linux | Linux | Projetos de RPA (multiplataforma), Soluções |
UiPath.CLI.macOS | macOS (ARM64) | Projetos de RPA (multiplataforma), Soluções |
UiPath.CLI.Windows.Legacy | Windows | Projetos de RPA (Windows - Legado) 1 |
1 Use UiPath.CLI.Windows.Legacy apenas para projetos independentes do Windows - Legado que não fazem parte de uma Solução.
Requisitos do runtime
Todos os pacotes UiPath CLI (Windows, Linux, macOS e Legacy) exigem .NET 8.
- No Windows, instale o .NET Desktop Runtime 8 (incluído com o .NET SDK).
- No Linux, certifique-se de que o .NET Runtime 8 esteja disponível em seu ambiente.
- No macOS, instale o .NET Runtime 8 para ARM64 (apenas Apple Silicon).
- A CLI é compatível com o UiPath Robot 2025.10 ou mais recente.
O suporte ao macOS está atualmente disponível apenas para processadores ARM64 (Apple Silicon). Macs baseados em Intel não são suportados.
A não ser que seja especificado de outra forma, todas as versões da CLI 25.x são compatíveis com o UiPath Robot 2025.10 e posterior.
Integração com plug-ins de CI/CD (Azure DevOps e Jenkins)
A partir da versão 25.10, o UiPath CLI é distribuído junto com atualizações principais dos plug-ins do Azure DevOps e Jenkins.
- As versões do plug-in instalam o UiPath CLI 25.10 (e posterior) em uma das seguintes variantes:
UiPath.CLI.WindowsUiPath.CLI.LinuxUiPath.CLI.macOSUiPath.CLI.Windows.Legacy
- Versões de CLI mais antigas (23.x/24.x) não são instaladas automaticamente pelos plug-ins atualizados.
Ao atualizar os plug-ins do Azure DevOps ou Jenkins, revise suas definições de pipeline e certifique-se de que elas façam referência à versão correta da CLI. Os pipelines existentes que fazem referência a versões de CLI mais antigas devem ser atualizados para usar um dos novos nomes de pacote de CLI.
Limitações
- A UiPath CLI não é compatível com a autenticação SSO.
- Projetos usando Gatilhos locais não podem ser criados usando a CLI.
