DownloadBuildArtifacts@1 - Transferir a tarefa de artefactos de compilação v1

  • Artigo

Utilize esta tarefa para transferir ficheiros que foram guardados como artefactos de uma compilação concluída.

Se estiver a utilizar os Serviços de DevOps do Azure, recomendamos que utilize Transferir Artefactos de Pipeline e Publicar Artefactos de Pipeline para um desempenho mais rápido.

Syntax

# Download build artifacts v1
# Download files that were saved as artifacts of a completed build.
- task: DownloadBuildArtifacts@1
  inputs:
    buildType: 'current' # 'current' | 'specific'. Required. Download artifacts produced by. Default: current.
    #project: # string. Required when buildType == specific. Project. 
    #pipeline: # string. Alias: definition. Required when buildType == specific. Build pipeline. 
    #specificBuildWithTriggering: false # boolean. Optional. Use when buildType == specific. When appropriate, download artifacts from the triggering build. Default: false.
    #buildVersionToDownload: 'latest' # 'latest' | 'latestFromBranch' | 'specific'. Required when buildType == specific. Build version to download. Default: latest.
    #allowPartiallySucceededBuilds: false # boolean. Optional. Use when buildType == specific && buildVersionToDownload != specific. Download artifacts even from partially succeeded builds. Default: false.
    #branchName: 'refs/heads/master' # string. Required when buildType == specific && buildVersionToDownload == latestFromBranch. Branch name. Default: refs/heads/master.
    #buildId: # string. Required when buildType == specific && buildVersionToDownload == specific. Build. 
    #tags: # string. Optional. Use when buildType == specific && buildVersionToDownload != specific. Build Tags. 
    downloadType: 'single' # 'single' | 'specific'. Required. Download type. Default: single.
    artifactName: # string. Required when downloadType == single. Artifact name. 
    #itemPattern: '**' # string. Matching pattern. Default: **.
    downloadPath: '$(System.ArtifactsDirectory)' # string. Required. Destination directory. Default: $(System.ArtifactsDirectory).
    #cleanDestinationFolder: false # boolean. Clean destination folder. Default: false.
  # Advanced
    #parallelizationLimit: '8' # string. Parallelization limit. Default: 8.
    #checkDownloadedFiles: false # boolean. Check downloaded files. Default: false.
    #retryDownloadCount: '4' # string. Retry count. Default: 4.
    #extractTars: # boolean. Extract all files that are stored inside tar archives.

Entradas

buildType - Transferir artefactos produzidos por
string. Obrigatório. Valores permitidos: current (Compilação atual), specific (Compilação específica). Valor predefinido: current.

Quer transfira artefactos produzidos pela compilação atual ou a partir de uma compilação específica.


project - Projeto
string. Necessário quando buildType == specific.

O projeto a partir do qual pode transferir os artefactos de compilação.


pipeline - Pipeline de compilação
Alias de entrada: definition. string. Necessário quando buildType == specific.

Especifica o nome do pipeline de compilação.


specificBuildWithTriggering - Quando adequado, transfira artefactos a partir da compilação de acionamento.
boolean. Opcional. Utilize quando buildType == specific. Valor predefinido: false.

Se true, esta tarefa de compilação tenta transferir artefactos da compilação de acionamento. Se não existir nenhuma compilação de acionamento a partir do pipeline especificado, transfere os artefactos da compilação especificada nas opções abaixo.


buildVersionToDownload - Criar versão para transferir
string. Necessário quando buildType == specific. Valores permitidos: latest, latestFromBranch (Mais recente a partir de um ramo específico e etiquetas de compilação especificadas), specific (versão específica). Valor predefinido: latest.

Especifica a versão da compilação a transferir.

  • Opte por latest transferir a versão de compilação mais recente disponível.
  • Opte latestFromBranch por transferir a versão de compilação mais recente disponível do ramo especificado por branchName e as etiquetas especificadas por tags.
  • Opte specific por transferir a versão de compilação especificada por buildId.

allowPartiallySucceededBuilds - Transfira artefactos mesmo a partir de compilações com êxito parcial.
boolean. Opcional. Utilize quando buildType == specific && buildVersionToDownload != specific. Valor predefinido: false.

Se true, esta tarefa de compilação tentar transferir artefactos, quer a compilação tenha êxito ou seja parcialmente bem-sucedida.


branchName - Nome do ramo
string. Necessário quando buildType == specific && buildVersionToDownload == latestFromBranch. Valor predefinido: refs/heads/master.

Especifica se pretende filtrar o nome do ramo/ref, por exemplo: refs/heads/develop.


buildId - Compilar
string. Necessário quando buildType == specific && buildVersionToDownload == specific.

A compilação a partir da qual pretende transferir os artefactos.


tags - Criar Etiquetas
string. Opcional. Utilize quando buildType == specific && buildVersionToDownload != specific.

Uma lista delimitada por vírgulas de etiquetas. Só são devolvidas compilações com estas etiquetas.


downloadType - Tipo de transferência
string. Obrigatório. Valores permitidos: single (Artefacto específico), specific (Ficheiros específicos). Valor predefinido: single.

Transfere um artefacto específico ou ficheiros específicos da compilação.

  • Selecione single (artefacto específico) quando quiser apenas um artefacto específico especificado por artifactName
  • Escolha specific (Ficheiros específicos) quando pretender todos os artefactos da compilação selecionada

artifactName - Nome do artefacto
string. Necessário quando downloadType == single.

O nome do artefacto a transferir.


itemPattern - Padrão correspondente
string. Valor predefinido: **.

Especifica os ficheiros a transferir como um padrão de minimatch de várias linhas. Para obter mais informações, veja Referência de padrões de correspondência de ficheiros.

O padrão \*\* predefinido transfere todos os ficheiros em todos os artefactos na compilação se escolher a opção Ficheiros específicos . Para transferir todos os ficheiros na remoção do artefacto, utilize drop/**.


downloadPath - Diretório de destino
string. Obrigatório. Valor predefinido: $(System.ArtifactsDirectory).

O caminho no computador do agente onde os artefactos são transferidos.


cleanDestinationFolder - Limpar pasta de destino
boolean. Valor predefinido: false.

Elimine todos os ficheiros existentes na pasta de destino antes da transferência do artefacto.


parallelizationLimit - Limite de paralelização
string. Valor predefinido: 8.

O número de ficheiros a transferir em simultâneo.


checkDownloadedFiles - Verificar ficheiros transferidos
boolean. Valor predefinido: false.

Se true, esta tarefa de compilação verifica se todos os ficheiros estão totalmente transferidos.


retryDownloadCount - Contagem de repetições
string. Valor predefinido: 4.

O número de vezes que tentará transferir um artefacto de compilação se a transferência falhar.


extractTars - Extrair todos os ficheiros armazenados dentro de arquivos tar
boolean.

Defina como true para extrair todos os ficheiros transferidos que tenham a extensão .tar . Isto é útil porque tem de empacotar os seus ficheiros de artefacto em tar se quiser preservar as permissões de ficheiro Unix. Ativar a opção StoreAsTar na tarefa Publicar artefactos de compilação irá armazenar artefactos como ficheiros .tar automaticamente.


Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.

Variáveis de saída

Esta tarefa define as seguintes variáveis de saída, que pode consumir em passos, tarefas e fases a jusante.

BuildNumber
Armazena o número de compilação da origem do artefacto de compilação.

Tenha em atenção que esta entrada devolve BuildId devido à retrocompatibilidade. Para obter mais informações, veja Variáveis.

Observações

Nota

A equipa do Azure Pipelines recomenda a atualização de artefactos de compilação para Artefactos de Pipeline para um desempenho mais rápido.

Requisitos

Requisito Description
Tipos de pipeline YAML, Compilação clássica, Versão clássica
É executado em Agente, DeploymentGroup
Exigências Nenhuma
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos Qualquer
Variáveis de tabelas definidas Qualquer
Versão do agente 2.191.1 ou superior
Categoria da tarefa Utilitário