- Notas de Versão
- Introdução
- Governança
- Controle de origem
- Pipelines de CI/CD
- Gerenciamento de feeds
- Geração de logs
Guia do usuário do Automation Ops
Sobre o UiPath CLI
O UiPath® oferece uma interface de linha de comando (CLI) que permite executar determinadas tarefas pré-definidas para gerenciamento e teste de pacotes RPA. O objetivo do UiPath CLI é integrar facilmente esses recursos com ferramentas de terceiros, como GitLab, Jenkins e muitas outras, sem um plug-in.
A CLI da UiPath pode ser usada com o Orchestrator implantado via Automation Cloud™ , Automation Suite ou independente.
Casos de uso comuns para o UiPath CLI envolvem:
- Empacotando projetos do Studio em pacotes NuGet.
- Implantando pacotes NuGet no Orchestrator.
- Executando trabalhos no Orchestrator.
- Executando conjuntos de testes no Orchestrator.
O UiPath CLI consiste em dois tipos:
-
UiPath.CLI.Windows
- Funciona apenas em dispositivos Windows.
- Constrói projetos Windows - legados,Windowse multiplataforma .
-
UiPath.CLI
- É executado apenas em dispositivos Linux.
- Constrói apenas projetos de plataforma cruzada .
-
A UiPath CLI não é compatível com conexão SSO.
-
A UiPath CLI não pode ser usada para criar projetos que usam Gatilhos locais.
-
O UiPath CLI não tem a funcionalidade para assinar um pacote, um recurso que está disponível ao publicar o pacote do Studio. Nesse caso, a única opção é assinar o pacote após ele ser criado usando o UiPath CLI. Para obter detalhes, consulte o comando assinar. Essa opção de assinatura também funciona para o Azure DevOps e Jenkins.
Aqui você pode verificar a compatibilidade entre a versão da CLI, a versão do .NET necessária e a versão do Robot de destino.
Versão da CLI |
Versão do .NET necessária |
Versão do Robot de destino para as automações criadas |
---|---|---|
24.10 |
.NET 8 |
24.10+ |
23.10 |
.NET 6 |
23.10+ |
23.4 |
.NET 6 |
23.4+ |
Você pode baixar qualquer versão do UiPath CLI no Feed Público Oficial da UiPath.
uipcli.exe
(para UiPath.CLI.Windows) ou uipcli.dll
(para UiPath.CLI), localizado na pasta tools
.
A versão do UiPath Studio que você está usando para criar seus projetos precisa corresponder à versão do UiPath.CLI.Windows.
Legenda: - compatível; - não compatível.
Orchestrator |
Tipo de Projeto |
UiPath.CLI.Windows 23.10 |
UiPath.CLI.Windows 23.6 |
UiPath.CLI.Windows 22.10 |
---|---|---|---|---|
2023.10.x PaaS | Windows - Legacy |
|
|
|
2023.10.x PaaS | Windows |
|
|
|
2023.10.x PaaS | Multiplataforma |
|
|
|
2021.10.x On-Premises |
Windows - Legacy |
|
|
|
2021.10.x On-Premises |
Windows |
|
|
|
2021.10.x On-Premises |
Multiplataforma |
|
|
|
2021.10.x PaaS |
Windows - Legacy |
|
|
|
2021.10.x PaaS |
Windows |
|
|
|
2021.10.x PaaS |
Multiplataforma |
|
|
|
2022.4.x |
Windows - Legacy |
|
|
|
2022.4.x |
Windows |
|
|
|
2022.4.x |
Multiplataforma |
|
|
|
2022.10.x |
Windows - Legacy |
|
|
|
2022.10.x |
Windows |
|
|
|
2022.10.x |
Multiplataforma |
|
|
|
2023.4.x | Windows-legacy |
|
|
|
2023.4.x | Windows |
|
|
|
2023.4.x | Multiplataforma |
|
|
|
Cloud |
Windows - Legacy |
|
|
|
Cloud |
Windows |
|
|
|
Cloud |
Multiplataforma |
|
|
|
A versão do UiPath Studio que você está usando para criar seus projetos precisa corresponder à versão do UiPath.CLI. Por exemplo, se você criar projetos usando o UiPath Studio 2021.10, você precisa usar a versão 21.10 do UiPath.CLI.
Legenda: - compatível; - não compatível.
Orchestrator | Tipo de Projeto | UiPath.CLI 23.10 | UiPath.CLI 23.6 | UiPath.CLI 22.10 | UiPath.CLI 22.4 | UiPath.CLI 21.10 |
---|---|---|---|---|---|---|
2023.10.x PaaS | Windows - Legacy |
|
|
|
|
|
2023.10.x PaaS | Windows |
|
|
|
|
|
2023.10.x PaaS | Multiplataforma |
|
|
|
|
|
2021.10.x On-Premises |
Windows - Legacy |
|
|
|
|
|
2021.10.x On-Premises |
Windows |
|
|
|
|
|
2021.10.x On-Premises |
Multiplataforma |
|
|
|
|
|
2021.10.x PaaS |
Windows - Legacy |
|
|
|
|
|
2021.10.x PaaS |
Windows |
|
|
|
|
|
2021.10.x PaaS |
Multiplataforma |
|
|
|
|
|
2022.4.x |
Windows - Legacy |
|
|
|
|
|
2022.4.x |
Windows |
|
|
|
|
|
2022.4.x |
Multiplataforma |
|
|
|
|
|
2022.10.x |
Windows - Legacy |
|
|
|
|
|
2022.10.x |
Windows |
|
|
|
|
|
2022.10.x |
Multiplataforma |
|
|
|
|
|
2023.4.x | Windows-legacy |
|
|
|
|
|
2023.4.x | Windows |
|
|
|
|
|
2023.4.x | Multiplataforma |
|
|
|
|
|
Cloud |
Windows - Legacy |
|
|
|
|
|
Cloud |
Windows |
|
|
|
|
|
Cloud |
Multiplataforma |
|
|
|
|
|
Esta seção descreve como você pode gerenciar os feeds integrados do NuGet. Além disso, ele fornece informações sobre como você pode usar feeds personalizados do NuGet de acordo com seus requisitos específicos do projeto.
uipcli
pesquisa dependências nos seguintes feeds integrados:
-
C:\Program Files\Microsoft SDKs\NuGetPackages
(se este caminho estiver no agente atual) -
C:\Program Files (x86)\Microsoft SDKs\NuGetPackages
(se este caminho estiver no agente atual)
uipcli
para não usar os feeds integrados definindo o parâmetro --disableBuiltInNugetFeeds
. Esse parâmetro pode ser usado para as seguintes tarefas: analyze
, pack
e test run
.Ao executar uipcli
com um arquivo de configuração, defina "disableBuiltInNugetFeeds": true
.
Você pode usar feeds personalizados ao empacotar uma automação.
Usando o nuget.config personalizado no UiPath CLI
Para usar o feed personalizado, siga as seguintes etapas:
-
Crie um arquivo
nuget.config
personalizado com o seguinte formato:<?xml version="1.0" encoding="utf-8"?> <configuration> <packageSources> <add key="test custom feed" value="custom_feed_url" /> </packageSources> </configuration>
<?xml version="1.0" encoding="utf-8"?> <configuration> <packageSources> <add key="test custom feed" value="custom_feed_url" /> </packageSources> </configuration> -
Coloque o arquivo
nuget.config
personalizado na pasta em queuipcli
está em cache:
Uso do nuget.config personalizado no Azure DevOps
nuget.config
para $(Agent.ToolsDirectory)/uipcli
, após a etapa InstallPlatform
, conforme mostrado no exemplo a seguir:
trigger:
- main
pool:
vmImage: ubuntu-latest
stages:
- stage: Demo
jobs:
- job: Demo
steps:
- task: UiPathInstallPlatform@4
inputs:
cliVersion: 'X_23.6.8581.19168'
- task: CopyFiles@2
inputs:
SourceFolder: '$(Build.SourcesDirectory)'
Contents: 'nuget.config'
TargetFolder: '$(Agent.ToolsDirectory)/uipcli'
- task: UiPathPack@4
inputs:
versionType: 'AutoVersion'
projectJsonPath: '$(Build.SourcesDirectory)/AutomationProjects/CrossPlatform/VB/ProjectWithCustomLibraryFromOrchestrator_CrossPlatform_VB/project.json'
outputPath: '$(Build.ArtifactStagingDirectory)/Output'
traceLevel: 'Information'
trigger:
- main
pool:
vmImage: ubuntu-latest
stages:
- stage: Demo
jobs:
- job: Demo
steps:
- task: UiPathInstallPlatform@4
inputs:
cliVersion: 'X_23.6.8581.19168'
- task: CopyFiles@2
inputs:
SourceFolder: '$(Build.SourcesDirectory)'
Contents: 'nuget.config'
TargetFolder: '$(Agent.ToolsDirectory)/uipcli'
- task: UiPathPack@4
inputs:
versionType: 'AutoVersion'
projectJsonPath: '$(Build.SourcesDirectory)/AutomationProjects/CrossPlatform/VB/ProjectWithCustomLibraryFromOrchestrator_CrossPlatform_VB/project.json'
outputPath: '$(Build.ArtifactStagingDirectory)/Output'
traceLevel: 'Information'
Usando o nuget.config personalizado no Jenkins
nuget.config
para ${WORKSPACE}/CLI
, após a etapa InstallPlatform
, conforme mostrado no exemplo a seguir:
pipeline {
agent {
label 'plugins-jenkins-lts-agent-01'
}
stages {
stage('Clone') {
steps {
git (
branch: 'main',
url: 'https://github.com/al3xandru-uipath-qa/CI-Plugins-Customer-Support.git'
)
}
}
stage('Install Platform') {
steps {
UiPathInstallPlatform (
traceLevel: 'Information'
)
}
}
stage('Copy nuget.config') {
steps {
bat 'copy nuget.config CLI\\nuget.config'
}
}
stage('Pack') {
steps {
UiPathPack (
outputPath: '${WORKSPACE}/Output',
projectJsonPath: '${WORKSPACE}/AutomationProjects/CrossPlatform/VB/ProjectWithCustomLibraryFromOrchestrator_CrossPlatform_VB/project.json',
traceLevel: 'Information',
version: AutoVersion()
)
}
}
}
}
pipeline {
agent {
label 'plugins-jenkins-lts-agent-01'
}
stages {
stage('Clone') {
steps {
git (
branch: 'main',
url: 'https://github.com/al3xandru-uipath-qa/CI-Plugins-Customer-Support.git'
)
}
}
stage('Install Platform') {
steps {
UiPathInstallPlatform (
traceLevel: 'Information'
)
}
}
stage('Copy nuget.config') {
steps {
bat 'copy nuget.config CLI\\nuget.config'
}
}
stage('Pack') {
steps {
UiPathPack (
outputPath: '${WORKSPACE}/Output',
projectJsonPath: '${WORKSPACE}/AutomationProjects/CrossPlatform/VB/ProjectWithCustomLibraryFromOrchestrator_CrossPlatform_VB/project.json',
traceLevel: 'Information',
version: AutoVersion()
)
}
}
}
}