Implantação de um pacote no Orchestrator

Prerequisites:

• Crie um pacote.
• Execute o arquivo CLI exe (para Windows) ou dll (para Linux).
• Adicione os escopos de aplicativos de acesso à API do Orchestrator necessários.

Para implantar um pacote no Orchestrator, execute as seguintes etapas:

1. Execute a tarefa package , usando uipcli package. Você pode ver uma lista das subtarefas disponíveis.
2. 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 é true. Quando definido como true, ele cria um processo na pasta do Orchestrator que é passado no comando. Quando definido como false, ele não cria um processo na pasta do Orchestrator. Por exemplo: --createProcess false.
--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! PackageName EntryPointName ProcessName MeuPacote Main.xaml Meu processo Ainda Outro Pacote CustomEntryPoint.xaml Ainda Outro Processo
--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 (Optional for external application authentication)	The list of application scopes, separated by single spaces. Optional when using external application authentication as default scopes are automatically applied. Must be paired with Application Account, Application ID, and Application Secret.
-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: AccountingTeam/TeamJohn.
-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) (Required) for SaaP deployments. (Optional) for PaaS deployments.	O locatário da instância do Orchestrator em que você deseja excluir uma máquina.

Observação:

When using external application authentication without specifying the --applicationScope parameter, the CLI automatically applies these default Orchestrator scopes:

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

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>]

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"n
• uipcli 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"