- Visão geral
- UiPath CLI
- Sobre o UiPath CLI
- Baixando o UiPath CLI
- Matriz de compatibilidade
- Executando o UiPath CLI
- Gerenciando feeds do NuGet
- Empacotando projetos em um pacote
- 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
Implantação de um pacote no Orchestrator
Prerequisites:
- Crie um pacote.
- Execute o arquivo CLI
exe(para Windows) oudll(para Linux). - Adicione os escopos de aplicativos de acesso à API do Orchestrator necessários.
Para implantar um pacote no Orchestrator, execute as seguintes etapas:
- Execute a tarefa
package, usandouipcli package. Você pode ver uma lista das subtarefas disponíveis. - Especifique os parâmetros necessários e execute a subtarefa
deploy. A tabela a seguir descreve os parâmetros necessários.
| Parâmetro | Description | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|
-c, or --createProcess | O valor padrão é Quando definido como Quando definido como | |||||||||
--processNames | Opcionalmente, forneça um arquivo .csv com nomes personalizados para os processos a serem criados/atualizados. O seguinte é um exemplo de como o arquivo .csv deve parecer. Os nomes das colunas/cabeçalhos NomeDoPacote, NomeDoPontoDeEntrada e NomeDoProcesso são obrigatórios!
| |||||||||
--processName | Opcionalmente, forneça um nome personalizado para o processo ser atualizado/criado. | |||||||||
--ignoreLibraryDeployConflict | Ignore o conflito ao implantar um pacote de biblioteca com a mesma versão que uma existente. Por padrão, a implantação falha se uma biblioteca com a mesma versão já existir na instância do Orchestrator. | |||||||||
-eou --environments (para pastas clássicas) | Uma lista de ambientes onde você deseja implantar o pacote, separados por vírgulas. Se o ambiente não pertencer à pasta padrão, prefixe o ambiente com o nome da pasta. Por exemplo: AccountingTeam\TestEnvironment. | |||||||||
-h, or --entryPointsPath | Define os pontos de entrada específicos para criar ou atualizar o processo. Esse é o caminho do arquivo do entry point, a partir da raiz do projeto. Para pastas Clássicas, apenas um ponto de entrada pode ser especificado por ambiente. | |||||||||
-u, ou --username (Necessário para autenticação básica) | O nome de usuário usado para autenticação ao Orchestrator. Deve estar emparelhada com a senha correspondente. | |||||||||
-p, ou --password (Necessário para autenticação básica) | A senha usada para autenticação ao Orchestrator. Deve estar emparelhado com o nome de usuário correspondente. | |||||||||
-tou --token (necessário para autenticação baseada em token) | O token de atualização do OAuth2 usado para autenticação ao Orchestrator. Deve estar emparelhado com Nome da conta e ID do cliente. | |||||||||
-aou --accountName (necessário para autenticação baseada em token ) | O nome da conta CloudRPA do Orchestrator. Deve estar emparelhado com o token de atualização do OAuth2 e o ID do cliente. | |||||||||
-A, or --accountForApp | O nome da conta CloudRPA do Orchestrator (nome da organização). Deve estar emparelhado com ID do aplicativo, Segredo do aplicativo e Escopo do aplicativo para a autenticação do aplicativo externo. | |||||||||
-I, ou --applicationId (Necessário para autenticação de aplicativo externo) | A ID do aplicativo externo. Deve estar emparelhado com Conta do aplicativo, Segredo do aplicativo e Escopo do aplicativo. | |||||||||
-S, ou --applicationSecret (Necessário para autenticação de aplicativo externo) | O Segredo do aplicativo externo. Deve estar emparelhado com Conta do aplicativo, ID do aplicativo e Escopo do aplicativo. | |||||||||
--applicationScope (Necessário para autenticação de aplicativos externos) | A lista de escopos do aplicativo, separada por espaços únicos. Deve estar emparelhada com Conta do aplicativo, ID do aplicativo e Segredo do aplicativo. | |||||||||
-oou --organizationUnit (obrigatório) | O nome da pasta do Orchestrator (unidade organizacional). Para inserir subpastas, inclua o nome da subpasta pai e do nome da subpasta. Por exemplo: | |||||||||
-l, or --language | O idioma usado na interface do usuário do Orchestrator. | |||||||||
-y, or --disableTelemetry | Desabilitar dados de telemetria. | |||||||||
--traceLevel | Exibir o rastreamento dos eventos. | |||||||||
--identityUrl (Necessário para implantações PaaS ou MSI) | A URL do seu servidor de identidade. | |||||||||
Package(s) Path (pos. 0) (Necessário) | O caminho para um arquivo de pacote ou o caminho para uma pasta contendo vários pacotes. | |||||||||
Orchestrator URL (pos. 1) (Necessário) | O URL da instância do Orchestrator. | |||||||||
Tenant do Orchestrator (pos. 2)
| O locatário da instância do Orchestrator em que você deseja excluir uma máquina. |
O uipclicria um processo com um ponto de defaultentrada se você não especificar um. Se o ponto de entrada for especificado, um processo com esse ponto de entrada será criado e _{entryPoint}será anexado ao nome do processo. Além disso, todos os processos associados a ele package.Idsão atualizados para a versão mais recente, independentemente de o processo ter sido criado manualmente ou a partir de um pipeline.
Uso:
uipcli package deploy <packages_path> <orchestrator_url> <orchestrator_tenant> [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-o <folder_name>] [-c <false|true>] [-e <environment_list>] [-l <language>] [--ignoreLibraryDeployConflict] [--entryPointsPath <entry_points_path_list>] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identityUrl>]uipcli package deploy <packages_path> <orchestrator_url> <orchestrator_tenant> [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-o <folder_name>] [-c <false|true>] [-e <environment_list>] [-l <language>] [--ignoreLibraryDeployConflict] [--entryPointsPath <entry_points_path_list>] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identityUrl>]Exemplos de comandos mínimos:
uipcli package deploy "C:\userprofile\AutomationPackages" "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel Information --entryPointsPath "Main.xaml"uipcli package deploy "C:\userprofile\AutomationPackage.1.0.171447983.nupkg" "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -I "76000552-3e4f-4590-9317-cdb420001f1d" -S "********" --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" --identityUrl "https://orch-23-10-paas.cloudapp.azure.com/identity" -o "FolderName" --traceLevel Information --entryPointsPath "Main.xaml"nuipcli package deploy "C:\userprofile\AutomationPackage.1.0.171447983.nupkg" "https://automation-suite.base.url.com/" "TenantName" -A "organizationName" -I "3f6239b9-e0e8-465e-a429-d9ffd1d9e57a" -S "********" --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" -o "FolderName" --traceLevel Information --entryPointsPath "Main.xaml"uipcli package deploy "C:\userprofile\AutomationPackage.1.0.171447983.nupkg" "https://cloud.uipath.com/" "TenantName" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********" --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" -o "FolderName" --traceLevel Information --processNames "C:\userprofile\processNames.csv"uipcli package deploy "C:\userprofile\AutomationPackage.1.0.171447983.nupkg" "https://cloud.uipath.com/" "TenantName" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********" --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" -o "FolderName" --traceLevel Information --entryPointsPath "Main.xaml" --processName "MyProcessName"