- Visão geral
- UiPath CLI
- Sobre o UiPath CLI
- Baixando o UiPath CLI
- Matriz de compatibilidade
- Executando o UiPath CLI
- Gerenciando feeds do NuGet
- Confiança em certificados personalizados
- 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
- Formato JSON dos parâmetros de entrada
- 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
Restaurando dependências de automação
Pré-requisitos e etapas para restaurar dependências de automação usando a CLI.
Pré-requisitos
- Crie um aplicativo externo.
- Execute o arquivo CLI
exe(para Windows Legacy) oudll(para Windows/Linux/macOS). - Adicione os escopos de aplicativos de acesso à API do Orchestrator necessários.
Para restaurar as dependências, siga 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
restore.A tabela a seguir descreve os parâmetros necessários:
Parâmetro Description Project(s) Path (pos. 0)Obrigatório. O caminho para um arquivo project.jsonou uma pasta que contém arquivosproject.json.--restoreFolderObrigatório. Restaure o caminho da pasta de destino. --nugetConfigFilePathOpcional. Caminho para o arquivo NuGet.Configusado durante a restauração. A partir de 25.10.18, o arquivo é honrado de ponta a ponta —<clear />,<packageSourceCredentials>,<packageSourceMapping>e<fallbackPackageFolders>, todos entram em vigor. Consulte Gerenciando feeds do NuGet. Em compilações mais antigas, apenas as URLs<packageSources>eram aplicadas.--disableBuiltInNugetFeedsDesabilite os feeds de nuget integrados. --excludeConfiguredSourcesOpcional. Exclui os feeds integrados e as origens do NuGet configuradas no nível do usuário e da máquina no host que executa a CLI. A CLI resolve pacotes apenas dos feeds --nugetConfigFilePathem. Consulte Gerenciando feeds do NuGet.-u,--libraryOrchestratorUsernameOpcional, útil apenas quando você tem dependências de uma biblioteca no Orchestrator. O nome de usuário do Orchestrator usado para autenticação. Deve ser usado com a senha. -p,--libraryOrchestratorPasswordOpcional, útil apenas quando você tem dependências de uma biblioteca no Orchestrator. A senha do Orchestrator usada para a autenticação. Deve ser usado com o nome de usuário. -t,--libraryOrchestratorAuthTokenOpcional, útil apenas quando você tem dependências de uma biblioteca no Orchestrator. O token de atualização do Orchestrator usado para a autenticação. Deve ser usado com o nome da organização e o ID do cliente. -a,--libraryOrchestratorAccountNameOpcional, útil apenas quando você tem dependências de uma biblioteca no Orchestrator. O nome da organização do Orchestrator. Deve ser usado com o token de atualização e o ID do cliente. -A,--libraryOrchestratorAccountForAppOpcional, útil apenas quando você tem dependências de uma biblioteca no Orchestrator. O nome da organização do Orchestrator. Deve ser usado com id, segredo e escopo(s) para aplicativo externo. -I,--libraryOrchestratorApplicationIdOpcional, útil apenas quando você tem dependências de uma biblioteca no Orchestrator. O ID do aplicativo externo. Deve ser usado com o nome da organização, o segredo e o(s) escopo(s) para o aplicativo externo. -S,--libraryOrchestratorApplicationSecretOpcional, útil apenas quando você tem dependências de uma biblioteca no Orchestrator. O segredo do aplicativo externo. Deve ser usado com o nome, id e escopo(s) da organização para o aplicativo externo. --libraryOrchestratorApplicationScopeOpcional, útil apenas quando você tem dependências de uma biblioteca no Orchestrator. A lista separada por espaços de escopos do aplicativo. Deve ser usado com o nome, ID e segredo da organização para um aplicativo externo. --libraryOrchestratorUrlOpcional, útil apenas quando você tem dependências de uma biblioteca no Orchestrator. A URL do Orchestrator. --libraryOrchestratorTenantOpcional, útil apenas quando você tem dependências de uma biblioteca no Orchestrator. O tenant do Orchestrator. --libraryIdentityUrlA URL do seu Identity Server. Obrigatório quando a biblioteca Orchestrator é executada no UiPath Automation Suite ou no Orchestrator independente (MSI no local). Não é necessário para o Automation Cloud — a CLI resolve o Identity Server do URL da nuvem. --traceLevelEspecifica quais tipos de mensagens de log darão origem a um dos seguintes valores: Nenhum, Crítico, Erro, Aviso, Informações, Detalhado. Valor padrão: informações. -l,--languageIdioma dos logs traduzidos. --ca-certUm ou mais arquivos de certificado de CA raiz confiáveis (pem, 5 ou PKCS#7DER) usados ao validar os certificados TLS do Orchestrator e do Identity Server. Repete o sinalizador ou vários caminhos separados por vírgulas. Consulte Confiança em certificados personalizados para obter mais detalhes. --pinnedpubkeyFixe a chave pública do certificado leaf do servidor. Formato: sha256//<base64>. Verificado além da validação de certificado padrão. Consulte Confiança em certificados personalizados para obter mais detalhes.
Ao usar a autenticação de aplicativos externos sem especificar o parâmetro --libraryOrchestratorApplicationScope , a CLI aplica automaticamente esses escopos do Orchestrator padrão:
OR.Assets OR.BackgroundTasks OR.Execution OR.Folders OR.Robots.Read OR.Machines.Read OR.Jobs OR.TestSets OR.TestSetExecutions OR.Monitoring OR.Settings.Read
Para instâncias do Orchestrator assinadas por uma Autoridade de Certificação privada (como o UiPath Automation Suite), esse comando também aceita parâmetros --ca-cert e --pinnedpubkey . Consulte Confiança em certificados personalizados para cenários e exemplos.
Uso
uipcli package restore <project_path> --restoreFolder <restore_directory> --nugetConfigFilePath <nuget_config_path> [--libraryOrchestratorUrl <orchestrator_url> --libraryOrchestratorTenant <orchestrator_tenant>] [--u <orchestrator_user> --p <orchestrator_pass>] [--t <auth_token> --a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --libraryOrchestratorApplicationScope <application_scope>] [--libraryIdentityUrl <identity_url>] [--libraryOrchestratorFolder <folder_name>] [-l <language>] [--disableBuiltInNugetFeeds] [--excludeConfiguredSources] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>]
uipcli package restore <project_path> --restoreFolder <restore_directory> --nugetConfigFilePath <nuget_config_path> [--libraryOrchestratorUrl <orchestrator_url> --libraryOrchestratorTenant <orchestrator_tenant>] [--u <orchestrator_user> --p <orchestrator_pass>] [--t <auth_token> --a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --libraryOrchestratorApplicationScope <application_scope>] [--libraryIdentityUrl <identity_url>] [--libraryOrchestratorFolder <folder_name>] [-l <language>] [--disableBuiltInNugetFeeds] [--excludeConfiguredSources] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>]
Exemplos mínimos de comando
uipcli package restore "C:\userprofile\AutomationProject" --traceLevel Information --restoreFolder ""C:\userprofile\DependencyPackages" --nugetConfigFilePath "C:\userprofile\Package\NuGet.Config"uipcli package restore "C:\userprofile\AutomationProject" --traceLevel Information --restoreFolder "C:\userprofile\DependencyPackages" --libraryOrchestratorUrl "https://orch-23-10-paas.cloudapp.azure.com/" --libraryOrchestratorTenant "TenantName" -u "orchestratorUsername" -p "********" --orchestratorFolder "FolderName"uipcli package restore "C:\userprofile\AutomationProject" --traceLevel Information --restoreFolder "C:\userprofile\DependencyPackages" --libraryOrchestratorUrl "https://orch-23-10-paas.cloudapp.azure.com/" --libraryOrchestratorTenant "TenantName" -A "organizationName" -I "76000552-3e4f-4590-9317-cdb420001f1d" -S '********' --libraryOrchestratorApplicationScope "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" --libraryOrchestratorFolder "FolderName" --libraryIdentityUrl "https://orch-23-10-paas.cloudapp.azure.com/identity"uipcli package restore "C:\userprofile\AutomationProject" --traceLevel Information --restoreFolder "C:\userprofile\DependencyPackages" --libraryOrchestratorUrl "https://automation-suite.base.url.com/" --libraryOrchestratorTenant "TenantName" -A "organizationName" -I "3f6239b9-e0e8-465e-a429-d9ffd1d9e57a" -S '********' --libraryOrchestratorApplicationScope "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" --libraryOrchestratorFolder "FolderName"uipcli package restore "C:\userprofile\AutomationProject" --traceLevel Information --restoreFolder "C:\userprofile\DependencyPackages" --libraryOrchestratorUrl "https://cloud.uipath.com/" --libraryOrchestratorTenant "TenantName" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S '********' --libraryOrchestratorApplicationScope "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" --libraryOrchestratorFolder "FolderName"
Restauração hermética — resolver dependências apenas a partir do nuget.config explícito
uipcli package restore "C:\userprofile\AutomationProject" --traceLevel Information --restoreFolder "C:\userprofile\DependencyPackages" --nugetConfigFilePath "C:\ci\nuget.config" --excludeConfiguredSources