UiPath Pack

A tarefa UiPathPack permite empacotar um projeto existente da UiPath em um pacote NuGet.

Configuração

Use a tabela a seguir para configurar as entradas do UiPath Pack.

Argumento	Description
Nome da exibição (obrigatório)	Insira um nome para a sua tarefa.
Escolher método de versionamento (obrigatório)	Você pode selecionar uma versão gerada automaticamente, usar a versão do projeto ou definir uma nova versão. Para obter mais informações, consulte Versões do pacote.
Versão (obrigatório)	Disponível apenas em pastas modernas juntamente com uma estratégia de alocação dinâmica. A especificação da versão do pacote fornece a possibilidade de rastrear os pacotes criados e sua origem com mais eficiência. Por exemplo, o padrão do assembly da Microsoft pode ser utilizado para criar a versão do pacote NuGet: [Principal].[Secundária].[NúmerodaCompilação].[NúmerodeRevisão]. As opções disponíveis são: AutoVersion : esta opção atualiza automaticamente a versão para o próximo número sequencial. Você pode usar o seguinte exemplo de configuração de tarefas: Atribuição - task: UiPathPack@3 inputs: versionType: AutoVersion projectJsonPath: '$(projectFolder)/project.json' outputPath: '$(Build.ArtifactStagingDirectory)\artifact-manifests' - tarefa: UiPathPack@3 entradas: versionType: AutoVersion projectJsonPath: '$(projectFolder)/project.json' outputPath: '$(Build.ArtifactStaagingDirectory)\artifact-manifests' Versão manual : com essa opção, você pode especificar seu próprio número de versão. Você pode usar o seguinte exemplo de configuração de tarefas: Atribuição - task: UiPathPack@3 inputs: versionType: ManualVersion version: '$(Build.BuildNumber)' projectJsonPath: '$(projectFolder)/project.json' outputPath: '$(Build.ArtifactStagingDirectory)\artifact-manifests' - tarefa: UiPathPack@3 entradas: versionType: ManualVersion version: '$(Build.BuildNumber)' projectJsonPath: '$(projectFolder)/project.json' outputPath: '$(Build.ArifactStaagingDirectory)\artifact-manifests' VersãoAtual : essa opção mantém a versão igual à especificada no arquivo project.json . Você pode usar o seguinte exemplo de configuração de tarefas: Atribuição - task: UiPathPack@3 inputs: versionType: CurrentVersion projectJsonPath: '$(projectFolder)/project.json' outputPath: '$(Build.ArtifactStagingDirectory)\artifact-manifests' - tarefa: UiPathPack@3 entradas: versionType: CurrentVersion projectJsonPath: '$(projectFolder)/project.json' outputPath: '$(Build.ArifactStaagingDirectory)\artifact-manifests'
Caminho do(s) projeto(s) (obrigatório)	Selecione a localização do projeto que será empacotado. Pode ser um caminho direto para um arquivo project.json ou um diretório com um, ou vários projetos. Nesse último caso, cada projeto de nível um é empacotado individualmente.
Escolher tipo de saída (obrigatório apenas para o versionamento manual)	Defina um tipo de projeto para o projeto que será empacotado. Se você definir None , o tipo de projeto será extraído do arquivo JSON do projeto. Os seguintes tipos de projeto são compatíveis: 'Processo', 'Biblioteca', 'Testes', 'Objetos', 'Nenhum'.
Conexão do Orchestrator (obrigatório)	Configure a conexão de serviço para acessar os serviços do UiPath Orchestrator. Você pode configurar uma conexão apenas para esta etapa ou usar uma conexão global existente. Para obter mais informações, consulte Configuração da conexão de serviço do UiPath Orchestrator.
Caminho de Saída (Obrigatório)	Defina um caminho da pasta em que o pacote será colocado.
Dividir a saída em bibliotecas de design e runtime	Selecione essa opção para dividir a saída em bibliotecas de design e runtime. Por padrão, essa opção não fica ativada.
Desabilitar feeds integrados do NuGet	Selecione essa opção para desabilitar feeds integrados do NuGet. Por padrão, esse parâmetro é definido como false.
Informações da versão do código-fonte e URL da ideia do Automation Hub	Selecione esta opção para habilitar os metadados do pacote, incluindo informações da versão do código-fonte e a URL da ideia do Automation Hub. Quando habilitado, você pode especificar detalhes do repositório e URL do projeto.
O caminho completo para o project.json no repositório remoto	Especifique o caminho completo para o project.json no repositório remoto. Disponível quando os metadados do pacote estão habilitados.
O ID de confirmação	Especifique o ID de confirmação de seu sistema de controle de versões. Disponível quando os metadados do pacote estão habilitados. Exemplo: $(Build.SourceVersion)
A ramificação do repositório	Especifique o nome da ramificação do repositório. Disponível quando os metadados do pacote estão habilitados. Exemplo: $(Build.SourceBranchName)
O tipo do repositório	Especifique o tipo do repositório (por exemplo, git). Disponível quando os metadados do pacote estão habilitados.
Ideias para o Automation Hub	Especifique a URL de ideia do Automation Hub para vincular o pacote a uma ideia de automação específica. Disponível quando os metadados do pacote estão habilitados.
Notas de Versão	Especifique as notas de versão para o pacote. Disponível quando os metadados do pacote estão habilitados.
Executar análise de fluxo de trabalho	Selecione essa opção para aplicar regras de análise de fluxo de trabalho no seu projeto de automação (por exemplo: gerar falha em trabalhos em caso de erros). Por padrão, essa opção não fica ativada. Para obter mais informações, consulte Regras do analisador de fluxo de trabalho dos testes de aplicativos.
Caminho do arquivo de governança	Especifique o caminho para as 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. Disponível quando a análise do fluxo de trabalho estiver habilitada.
Caminho do Certificado	Especifique o caminho para o arquivo de certificado no formato .pfx usado para assinar o pacote. Quando fornecido, o pacote será assinado digitalmente com o certificado. Exemplo: $(Build.SourcesDirectory)\certificates\signing-cert.pfx
SenhaDoCertificado	Especifique a senha do certificado. É recomendável armazenar esse valor como uma variável secreta no Azure DevOps. Exemplo: $(CertificatePassword)
URL do servidor de carimbo de data/hora	Especifique a URL do servidor de carimbo de data/hora para usar ao assinar o pacote. O carimbo de data/hora garante que a assinatura permaneça válida mesmo depois que o certificado expira. Exemplo: https://timestamp.digicert.com
Nível de trace	Selecione o nível de log da lista suspensa.

Pipeline YAML

Você pode visualizar um documento YAML totalmente analisado para o UiPath Pack.

Exemplo: criação de pacote básico

- task: UiPathPack@2
  inputs:
    versionType: AutoVersion
    projectJsonPath: '$(Build.SourcesDirectory)\MyFirstProcess'
    outputPath: '$(Build.ArtifactStagingDirectory)\Packages\MyFirstProcess'
    outputType: 'Process'
    orchestratorConnection: 'service-connection-name'
    traceLevel: 'Information'

Exemplo: pacote com assinatura

- task: UiPathPack@2
  displayName: 'Pack and Sign UiPath Project'
  inputs:
    versionType: 'ManualVersion'
    version: '1.0.$(Build.BuildId)'
    projectJsonPath: '$(Build.SourcesDirectory)\MyAutomationProject'
    outputPath: '$(Build.ArtifactStagingDirectory)\Packages'
    outputType: 'Process'
    orchestratorConnection: 'uipath-orchestrator-connection'
    certificatePath: '$(Build.SourcesDirectory)\certificates\signing-cert.pfx'
    certificatePassword: '$(SigningCertPassword)'
    timestampServerUrl: 'http://timestamp.digicert.com'
    traceLevel: 'Information'

Exemplo: pacote com análise e assinatura de fluxo de trabalho

- task: UiPathPack@2
  displayName: 'Pack, Analyze, and Sign Project'
  inputs:
    versionType: 'ManualVersion'
    version: '$(Major).$(Minor).$(Build.BuildId)'
    projectJsonPath: '$(Build.SourcesDirectory)\EnterpriseAutomation'
    outputPath: '$(Build.ArtifactStagingDirectory)\Packages'
    outputType: 'Process'
    orchestratorConnection: 'uipath-orchestrator-connection'
    runWorkflowAnalysis: true
    certificatePath: '$(Pipeline.Workspace)\secure-files\company-cert.pfx'
    certificatePassword: '$(CertPassword)'
    timestampServerUrl: 'http://timestamp.digicert.com'
    traceLevel: 'Verbose'

Observação:

Ao usar a assinatura de pacotes, armazene a senha do seu certificado como uma variável secreta no Azure DevOps. Navegue até Pipelines > Biblioteca > Grupos de variáveis ou defina-o em suas variáveis de pipeline com o ícone de cadeado habilitado para mantê-lo seguro.