Pacote de download da solução UiPath

A tarefa Pacote de download de solução do UiPath baixa um pacote de solução do UiPath Orchestrator. Isso permite que você recupere pacotes de solução carregados anteriormente para backup, implantação em outros ambientes ou processamento local.

Observação:

Esta tarefa é compatível apenas com UiPath.CLI.Windows ou UiPath.CLI.Linux pelo menos a versão 25.10 ou posterior.

Configuração

Use a tabela a seguir para configurar as entradas do Pacote de download do UiPath Solution.

Parâmetro	Description
Conexão do Orchestrator (obrigatório)	Uma conexão de serviço com a instância do Orchestrator.
Nome do pacote (obrigatório)	O nome do pacote da solução do Orchestrator.
Package Version	Opcional. A versão do pacote da solução do Orchestrator. Se não for especificado, a versão mais recente será baixada.
Caminho de Destino (Obrigatório)	O caminho do local em que o pacote baixado será salvo.
Filename	Opcional. O nome do arquivo local, incluindo a extensão em que o pacote baixado será salvo. O caminho final concatenará o Caminho de Destino e o Nome do Arquivo.
Nível de trace	O nível do registro em log do trace. Padrão: Error. Opções: None, Critical, Error, Warning, Information, Verbose

Observações

• Recuperação do pacote: esta tarefa baixa os pacotes de soluções armazenados no Gerenciamento de soluções no Orchestrator.
• Flexibilidade de versão: pode baixar versões específicas ou a versão mais recente quando a versão não é especificada.
• Armazenamento local: baixa pacotes para o sistema de arquivos local para processamento ou implantação posterior.
• Backup e recuperação: útil para criar backups de pacotes de soluções ou cenários de recuperação de desastres.
• Implantação entre ambientes: permite baixar pacotes de um ambiente para implantação em outro.
• Nomenclatura de arquivo: suporta a especificação de nome de arquivo personalizado ou usa a nomeação padrão do Orchestrator.
• Conexão do Orchestrator: requer uma conexão de serviço válida com a instância do Orchestrator de origem.
• Compatibilidade com a CLI: essa tarefa usa a CLI da UiPath internamente e requer a instalação adequada da CLI no agente de compilação.
• Versão mínima da CLI: requer a versão 25.10 ou superior da CLI da UiPath para compatibilidade total.
• Integração pronta: os pacotes baixados podem ser usados com tarefas de upload ou implantação para a promoção do ambiente.

Exemplos de pipeline

Download do pacote básico

- task: UiPathSolutionDownloadPackage@6
  displayName: 'Download Solution Package'
  inputs:
    orchestratorConnection: 'UiPath-Orchestrator-Connection'
    packageName: 'MySolution'
    destinationPath: '$(Build.ArtifactStagingDirectory)/downloads'
    traceLevel: 'Information'

Com conexão do Orchestrator e versão específica

- task: UiPathSolutionDownloadPackage@6
  displayName: 'Download Production Solution Package'
  inputs:
    orchestratorConnection: 'Production-Orchestrator'
    packageName: 'MyBusinessSolution'
    packageVersion: '2.1.$(Build.BuildNumber)'
    destinationPath: '$(Build.SourcesDirectory)/packages'
    filename: 'business-solution-backup.zip'
    traceLevel: 'Verbose'

Pipeline completo: baixe e reimplante

variables:
  solutionName: 'MyBusinessSolution'
  sourceEnvironment: 'Production'
  targetEnvironment: 'Staging'
  packageVersion: '1.$(Date:yyyy).$(DayOfYear)$(Rev:.r)'

steps:
- task: UiPathSolutionDownloadPackage@6
  displayName: 'Download Package from $(sourceEnvironment)'
  inputs:
    orchestratorConnection: 'Production-Orchestrator'
    packageName: '$(solutionName)'
    packageVersion: '$(packageVersion)'
    destinationPath: '$(Build.ArtifactStagingDirectory)/downloads'
    filename: '$(solutionName)-$(packageVersion).zip'
    traceLevel: 'Information'

- task: UiPathSolutionUploadPackage@6
  displayName: 'Upload Package to $(targetEnvironment)'
  inputs:
    orchestratorConnection: 'Staging-Orchestrator'
    solutionPackagePath: '$(Build.ArtifactStagingDirectory)/downloads/$(solutionName)-$(packageVersion).zip'
    traceLevel: 'Information'

- task: UiPathSolutionDeploy@6
  displayName: 'Deploy to $(targetEnvironment)'
  inputs:
    orchestratorConnection: 'Staging-Orchestrator'
    packageName: '$(solutionName)'
    packageVersion: '$(packageVersion)'
    deploymentName: '$(solutionName)-$(targetEnvironment)-$(Build.BuildNumber)'
    deploymentParentFolder: '$(targetEnvironment)'
    deploymentFolderName: 'BusinessProcesses'
    traceLevel: 'Information'

- script: echo "Successfully promoted $(solutionName) v$(packageVersion) from $(sourceEnvironment) to $(targetEnvironment)"
  displayName: 'Promotion Summary'