automation-ops
latest
false
Importante :
A tradução automática foi aplicada parcialmente neste conteúdo.
Guia do usuário do Automation Ops
Automation CloudAutomation Cloud Public SectorAutomation Suite
Last updated 23 de out de 2024

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.

Observação:

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:

  1. UiPath.CLI.Windows

    • Funciona apenas em dispositivos Windows.
    • Constrói projetos Windows - legados,Windowse multiplataforma .
  2. UiPath.CLI

    • É executado apenas em dispositivos Linux.
    • Constrói apenas projetos de plataforma cruzada .
Observação:
  • 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.

Pré-requisitos

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+

Para o UiPath.CLI.Windows, você também deve instalar o .NET Desktop Runtime, que também vem com o .NET SDK.

Baixando o UiPath CLI

Você pode baixar qualquer versão do UiPath CLI no Feed Público Oficial da UiPath.

  1. Acesse o feed público oficial da UiPath.
  2. Na barra de pesquisa Filtrar por palavras-chave , digite uipath.cli.
  3. Selecione uma das opções abaixo:
    • UiPath.CLI - UiPath CLI projetado para dispositivos Linux
    • UiPath.CLI.Windows - UiPath CLI projetado para dispositivos Windows
  4. Vá para a guia Versões e selecione uma versão da CLI que deseja baixar.
  5. Selecione Baixar.
  6. Abra a pasta onde o arquivo NUPKG foi baixado, clique com o botão direito do mouse e extraia o arquivo em uma pasta.
Resultados: Uma pasta com o mesmo nome do arquivo NUPKG é criada. Esta pasta contém o conteúdo do UiPath CLI. O ponto de entrada para todas as operações é uipcli.exe (para UiPath.CLI.Windows) ou uipcli.dll (para UiPath.CLI), localizado na pasta tools .

Matriz de Compatibilidade UiPath.CLI.Windows

A versão do UiPath Studio que você está usando para criar seus projetos precisa corresponder à versão do UiPath.CLI.Windows.

Legenda: available - compatível; Não disponí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

available

available

available

2023.10.x PaaS

Windows

available

available

available

2023.10.x PaaS

Multiplataforma

available

available

available

2021.10.x On-Premises

Windows - Legacy

available

available

available

2021.10.x On-Premises

Windows

available

available

available

2021.10.x On-Premises

Multiplataforma

available

available

available

2021.10.x PaaS

Windows - Legacy

available

available

available

2021.10.x PaaS

Windows

available

available

available

2021.10.x PaaS

Multiplataforma

available

available

available

2022.4.x

Windows - Legacy

available

available

available

2022.4.x

Windows

available

available

available

2022.4.x

Multiplataforma

available

available

available

2022.10.x

Windows - Legacy

available

available

available

2022.10.x

Windows

available

available

available

2022.10.x

Multiplataforma

available

available

available

2023.4.xWindows-legacy

available

available

available

2023.4.xWindows

available

available

available

2023.4.xMultiplataforma

available

available

available

Cloud

Windows - Legacy

available

available

available

Cloud

Windows

available

available

available

Cloud

Multiplataforma

available

available

available

Matriz de Compatibilidade UiPath.CLI

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: available - compatível; Não disponível - não compatível.

OrchestratorTipo de ProjetoUiPath.CLI 23.10UiPath.CLI 23.6UiPath.CLI 22.10UiPath.CLI 22.4UiPath.CLI 21.10

2023.10.x PaaS

Windows - Legacy

Não disponível

Não disponível

Não disponível

Não disponível

Não disponível

2023.10.x PaaS

Windows

Não disponível

Não disponível

Não disponível

Não disponível

Não disponível

2023.10.x PaaS

Multiplataforma

available

available

available

available

available

2021.10.x On-Premises

Windows - Legacy

Não disponível

Não disponível

Não disponível

available

available

2021.10.x On-Premises

Windows

Não disponível

Não disponível

Não disponível

Não disponível

Não disponível

2021.10.x On-Premises

Multiplataforma

available

available

available

available

available

2021.10.x PaaS

Windows - Legacy

Não disponível

Não disponível

Não disponível

available

available

2021.10.x PaaS

Windows

Não disponível

Não disponível

Não disponível

Não disponível

Não disponível

2021.10.x PaaS

Multiplataforma

available

available

available

available

available

2022.4.x

Windows - Legacy

Não disponível

Não disponível

Não disponível

available

available

2022.4.x

Windows

Não disponível

Não disponível

Não disponível

Não disponível

Não disponível

2022.4.x

Multiplataforma

available

available

available

available

available

2022.10.x

Windows - Legacy

Não disponível

Não disponível

Não disponível

available

available

2022.10.x

Windows

Não disponível

Não disponível

Não disponível

Não disponível

Não disponível

2022.10.x

Multiplataforma

available

available

available

available

available

2023.4.xWindows-legacy

Não disponível

Não disponível

Não disponível

available

available

2023.4.xWindows

Não disponível

Não disponível

Não disponível

Não disponível

Não disponível

2023.4.xMultiplataforma

available

available

available

available

available

Cloud

Windows - Legacy

Não disponível

Não disponível

Não disponível

available

available

Cloud

Windows

Não disponível

Não disponível

Não disponível

Não disponível

Não disponível

Cloud

Multiplataforma

available

available

available

available

available

Gerenciando feeds do NuGet

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.

Desabilitando os feeds integrados do NuGet

Por padrão, o uipcli pesquisa dependências nos seguintes feeds integrados: Você pode especificar 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.
docs image
docs image

Uso de feeds personalizados do NuGet

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:

  1. 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>
  2. Coloque o arquivo nuget.config personalizado na pasta em que uipcli está em cache:
    docs image

Uso do nuget.config personalizado no Azure DevOps

Você precisa atualizar a configuração e copiar 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

Você precisa atualizar a configuração e copiar 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()
                )
            }
        }
    }
}

Esta página foi útil?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Uipath Logo White
Confiança e segurança
© 2005-2024 UiPath. Todos os direitos reservados.