Configuração de download da solução UiPath

A tarefa UiPath Solution Download Config baixa uma configuração de solução do UiPath Orchestrator. Isso permite que você recupere arquivos de configuração específicos do ambiente para soluções armazenadas no Orchestrator.

Observação:

Atualmente, as soluções são compatíveis apenas com o Automation Cloud. O suporte para o Automation Suite está planejado para uma versão futura. O Orchestrator no local (MSI) não é compatível com Soluções.

Observação:

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

Configuração

Use a tabela a seguir para configurar as entradas de Configuração 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á usada.
Caminho de Destino (Obrigatório)	O caminho local onde o arquivo de configuração baixado será salvo.
Filename	Opcional. O nome do arquivo local, incluindo a extensão em que a configuração baixada será salva. O caminho final concatenará o Caminho de Destino e o Nome do Arquivo.
Formato do Arquivo	O formato do arquivo de configuração a ser baixado. Padrão: json. Opções: json, yaml
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

• Gerenciamento de configurações: esta tarefa recupera arquivos de configuração de solução armazenados no Orchestrator para uso em implantações
• Configurações específicas do ambiente: útil para baixar diferentes arquivos de configuração para vários ambientes (dev, test, prod)
• Flexibilidade de formato: suporta os formatos de configuração JSON e YAML
• Controle de versão: pode baixar configurações para versões específicas de pacote ou a versão mais recente
• Armazenamento local: baixa as configurações para o sistema de arquivos local para uso em tarefas de pipeline subsequentes
• Conexão do Orchestrator: requer uma conexão de serviço válida com a instância do Orchestrator de destino
• Compatibilidade com a CLI: essa tarefa usa a CLI da UiPath internamente e requer a instalação adequada da CLI no agente de build
• Versão mínima da CLI: requer a versão 25.10 ou superior da CLI da UiPath para compatibilidade total
• Pronto para integração: as configurações baixadas podem ser usadas com tarefas de implantação para implantações específicas do ambiente

Exemplos de pipeline

Download da configuração básica

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

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

- task: UiPathSolutionDownloadConfig@6
  displayName: 'Download Production Configuration'
  inputs:
    orchestratorConnection: 'Production-Orchestrator'
    packageName: 'MyBusinessSolution'
    packageVersion: '2.1.$(Build.BuildNumber)'
    destinationPath: '$(Build.SourcesDirectory)/configs'
    filename: 'production-config.json'
    format: 'json'
    traceLevel: 'Verbose'

Pipeline completo: baixe a configuração e implante

variables:
  solutionName: 'MyBusinessSolution'
  solutionVersion: '1.$(Date:yyyy).$(DayOfYear)$(Rev:.r)'
  environmentName: 'Production'

steps:
- task: UiPathSolutionDownloadConfig@6
  displayName: 'Download $(environmentName) Configuration'
  inputs:
    orchestratorConnection: 'Production-Orchestrator'
    packageName: '$(solutionName)'
    packageVersion: '$(solutionVersion)'
    destinationPath: '$(Build.ArtifactStagingDirectory)/configs'
    filename: '$(environmentName)-config.yaml'
    format: 'yaml'
    traceLevel: 'Information'

- task: UiPathSolutionDeploy@6
  displayName: 'Deploy Solution with Downloaded Config'
  inputs:
    orchestratorConnection: 'Production-Orchestrator'
    packageName: '$(solutionName)'
    packageVersion: '$(solutionVersion)'
    deploymentName: '$(solutionName)-$(environmentName)-$(Build.BuildNumber)'
    deploymentParentFolder: '$(environmentName)'
    deploymentFolderName: 'BusinessProcesses'
    configPath: '$(Build.ArtifactStagingDirectory)/configs/$(environmentName)-config.yaml'
    traceLevel: 'Information'

- script: echo "Downloaded and used configuration for $(solutionName) v$(solutionVersion)"
  displayName: 'Configuration Summary'