Pacote de solução da UiPath

A tarefa UiPath Solution Pack empacota um arquivo arquivado de solução da UiPath existente em um pacote implantável que pode ser carregado para o Gerenciamento de soluções 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.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 solução da UiPath.

Parâmetro	Description
Caminho da solução (obrigatório)	O caminho local da solução. Pode ser um caminho direto para um arquivo Solution.uipx ou um diretório de soluções.
Versão (obrigatório)	Especificar a versão do pacote da solução permite rastrear os pacotes criados e controlar a versão de origem de forma mais eficiente. Por exemplo, o padrão do assembly da Microsoft pode ser utilizado para criar a versão do pacote NuGet: [Major].[Minor].[BuildNumber].[RevisionNumber]
Caminho de Saída (Obrigatório)	O caminho para a pasta em que o pacote criado será colocado.Padrão: $(Build.ArtifactStagingDirectory)\Output
Desabilitar feeds integrados do NuGet	Desabilite feeds integrados do NuGet. Padrão: false
Informações da versão do código-fonte e URL da ideia do Automation Hub	Habilite os metadados do pacote, incluindo informações da versão do código-fonte e a URL da ideia do Automation Hub. Padrão: false
O caminho completo para o project.json no repositório remoto	O caminho completo para o project.json no repositório remoto. Visível apenas quando os metadados do pacote estão habilitados.
O ID de confirmação	O ID de confirmação para rastreamento do código-fonte. Visível apenas quando os metadados do pacote estão habilitados.
A ramificação do repositório	A ramificação do repositório para rastreamento do código-fonte. Visível apenas quando os metadados do pacote estão habilitados.
O tipo do repositório (por exemplo, git)	O tipo do repositório (por exemplo: git). Visível apenas quando os metadados do pacote estão habilitados.
Ideias para o Automation Hub	URL de Ideia do Automation Hub para vincular à ideia de automação original. Visível apenas quando os metadados do pacote estão habilitados.
Notas de Versão	Notas de lançamento para a versão do pacote. Visível apenas quando os metadados do pacote estão habilitados.
Conexão com o Orchestrator	Uma conexão de serviço com uma instância do Orchestrator que inclui no seu feed as dependências do(s) projeto(s) a serempacotado(s). Normalmente usado para empacotar bibliotecas. A versão do Orchestrator deve igual ou posterior à 20.4.
Executar análise do fluxo de trabalho	Execute a análise do fluxo de trabalho antes do empacotamento. No caso de erros, o processo falhará. Padrão: false
Caminho do arquivo de governança	Aprovar políticas de governança que contenham as regras do Analisador de Fluxo de Trabalho. As políticas podem ser baixadas do Automation Ops ou extraídas do arquivo zip compactado exportado do Studio. Para obter mais detalhes, consulte a documentação. Visível apenas quando a análise de fluxo de trabalho estiver habilitada.
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

• Empacotamento da solução: essa tarefa cria pacotes implantáveis a partir de soluções UiPath que podem ser carregadas para o Gerenciamento de soluções no Orchestrator.
• Requisito de versão: ao contrário de projetos independentes, as soluções exigem especificação de versão explícita usando o versionamento semântico.
• Dependências do Orchestrator: ao empacotar bibliotecas ou projetos com dependências de feeds do Orchestrator, configure o parâmetro de conexão do Orchestrator.
• Análise de fluxo de trabalho: habilite a análise de fluxo de trabalho para validar sua solução em relação às políticas de governança antes de empacotar.
• Rastreamento de metadados: habilite os metadados do pacote para incluir informações do código-fonte e links para ideias do Automation Hub para uma melhor rastreabilidade.
• Formato de saída: a tarefa cria um arquivo de solução empacotada no diretório de saída especificado com padrão de nome: {SolutionName}.{Version}.zip.
• 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.

Exemplos de pipeline

Pacotes básicos da solução

- task: UiPathSolutionPack@6
  displayName: 'Pack Solution'
  inputs:
    solutionPath: '$(Build.SourcesDirectory)/MySolution'
    version: '1.0.$(Build.BuildId)'
    outputPath: '$(Build.ArtifactStagingDirectory)/Output'
    traceLevel: 'Information'

Com conexão do Orchestrator

- task: UiPathSolutionPack@6
  displayName: 'Pack Solution with Orchestrator Dependencies'
  inputs:
    solutionPath: '$(Build.SourcesDirectory)/MyLibrarySolution'
    version: '2.1.$(Build.BuildNumber)'
    outputPath: '$(Build.ArtifactStagingDirectory)/Packages'
    orchestratorConnection: 'UiPath-Orchestrator-Connection'
    runWorkflowAnalysis: true
    governanceFilePath: '$(Build.SourcesDirectory)/governance/policies.json'
    traceLevel: 'Verbose'

Conclua o pipeline com metadados e governança

variables:
  solutionVersion: '1.$(Date:yyyy).$(DayOfYear)$(Rev:.r)'

steps:
- task: UiPathSolutionPack@6
  displayName: 'Pack Solution with Full Metadata'
  inputs:
    solutionPath: '$(Build.SourcesDirectory)/MyBusinessSolution'
    version: '$(solutionVersion)'
    outputPath: '$(Build.ArtifactStagingDirectory)'
    disableBuiltInNugetFeeds: false
    enablePackageMetadata: true
    repositoryUrl: '$(Build.Repository.Uri)/$(Build.SourcesDirectory)/MyBusinessSolution/project.json'
    repositoryCommit: '$(Build.SourceVersion)'
    repositoryBranch: '$(Build.SourceBranchName)'
    repositoryType: 'git'
    projectUrl: 'https://cloud.uipath.com/automationhub/idea/12345'
    releaseNotes: 'Automated build $(Build.BuildNumber) - Added new features and bug fixes'
    orchestratorConnection: 'Production-Orchestrator'
    runWorkflowAnalysis: true
    governanceFilePath: '$(Build.SourcesDirectory)/governance/workflow-analyzer-rules.json'
    traceLevel: 'Information'

- task: PublishBuildArtifacts@1
  displayName: 'Publish Solution Package'
  inputs:
    pathToPublish: '$(Build.ArtifactStagingDirectory)'
    artifactName: 'SolutionPackage'