DownloadBuildArtifacts@1 – Tarefa Baixar artefatos de build v1

Use essa tarefa para baixar arquivos que foram salvos como artefatos de um build concluído.

Se você estiver usando Azure DevOps Services, recomendamos usar Baixar Artefatos de Pipeline e Publicar Artefatos de Pipeline para obter 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 - Baixar artefatos produzidos por
string. Obrigatórios. Valores permitidos: current (build atual) specific (build específico). Valor padrão: current.

Se deseja baixar artefatos produzidos pelo build atual ou de um build específico.

project - Projeto
string. Obrigatório quando buildType == specific.

O projeto do qual baixar os artefatos de build.

pipeline - Pipeline de build
Alias de entrada: definition. string. Obrigatório quando buildType == specific.

Especifica o nome do pipeline de build.

specificBuildWithTriggering - Quando apropriado, baixe artefatos do build de gatilho.
boolean. Opcional. Use quando buildType == specific. Valor padrão: false.

Se truefor , essa tarefa de build tentará baixar artefatos do build de gatilho. Se não houver nenhum build de gatilho do pipeline especificado, ele baixará artefatos do build especificado nas opções abaixo.

buildVersionToDownload - Compilar versão a ser baixada
string. Obrigatório quando buildType == specific. Valores permitidos: latest, latestFromBranch (mais recente de branch específico e marcas de build especificadas), specific (versão específica). Valor padrão: latest.

Especifica qual versão do build será baixada.

• Escolha latest baixar a versão de build mais recente disponível.
• Escolha latestFromBranch baixar a versão de build mais recente disponível do branch especificado por branchName e as marcas especificadas por tags.
• Escolha specific baixar a versão de build especificada por buildId.

allowPartiallySucceededBuilds - Baixe artefatos mesmo de builds parcialmente bem-sucedidos.
boolean. Opcional. Use quando buildType == specific && buildVersionToDownload != specific. Valor padrão: false.

Se true, essa tarefa de build tentará baixar artefatos se o build for bem-sucedido ou parcialmente bem-sucedido.

branchName - Nome do branch
string. Obrigatório quando buildType == specific && buildVersionToDownload == latestFromBranch. Valor padrão: refs/heads/master.

Especifica se o nome branch/ref deve ser filtrado, por exemplo: refs/heads/develop.

buildId - Construir
string. Obrigatório quando buildType == specific && buildVersionToDownload == specific.

O build do qual você deseja baixar os artefatos.

tags - Criar marcas
string. Opcional. Use quando buildType == specific && buildVersionToDownload != specific.

Uma lista delimitada por vírgulas de marcas. Somente builds com essas marcas são retornados.

downloadType - Tipo de download
string. Obrigatórios. Valores permitidos: single (artefato específico) specific (Arquivos específicos). Valor padrão: single.

Baixa um artefato específico ou arquivos específicos do build.

• Escolha single (artefato específico) quando desejar apenas um artefato específico especificado por artifactName
• Escolha specific (Arquivos específicos) quando quiser todos os artefatos do build selecionado

artifactName - Nome do artefato
string. Obrigatório quando downloadType == single.

O nome do artefato a ser baixado.

itemPattern - Padrão de correspondência
string. Valor padrão: **.

Especifica os arquivos a serem baixados como um padrão de minimatch de várias linhas. Para obter mais informações, consulte Referência de padrões de correspondência de arquivos.

O padrão \*\* baixa todos os arquivos em todos os artefatos no build se você escolher a opção Arquivos específicos . Para baixar todos os arquivos na queda de artefato, use drop/**.

downloadPath - Diretório de destino
string. Obrigatórios. Valor padrão: $(System.ArtifactsDirectory).

O caminho no computador do agente em que os artefatos são baixados.

cleanDestinationFolder - Limpar pasta de destino
boolean. Valor padrão: false.

Exclua todos os arquivos existentes na pasta de destino antes do download do artefato.

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

O número de arquivos a serem baixados simultaneamente.

checkDownloadedFiles - Verificar arquivos baixados
boolean. Valor padrão: false.

Se true, essa tarefa de build verificará se todos os arquivos foram totalmente baixados.

retryDownloadCount - Contagem de repetições
string. Valor padrão: 4.

O número de vezes para tentar baixar novamente um artefato de build se o download falhar.

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

Defina como true para extrair todos os arquivos baixados que têm a extensão .tar . Isso é útil porque você precisa empacotar seus arquivos de artefato em tar se quiser preservar as permissões de arquivo unix. Habilitar a opção StoreAsTar na tarefa Publicar artefatos de build armazenará artefatos como arquivos .tar automaticamente.

Opções de controle da tarefa

Todas as tarefas têm opções de controle além de suas entradas de tarefa. Para obter mais informações, consulte Opções de controle e propriedades comuns da tarefa.

Variáveis de saída

Essa tarefa define as variáveis de saída a seguir, que você pode consumir em etapas downstream, trabalhos e estágios.

BuildNumber
Armazena o número de build da origem do artefato de build.

Observe que essa entrada retorna BuildId devido à compatibilidade com versões anteriores. Para obter mais informações, consulte Variáveis.

Comentários

Observação

A equipe do Azure Pipelines recomenda atualizar de artefatos de build para Artefatos de Pipeline para obter um desempenho mais rápido.

Requisitos

Requisito	Descrição
Tipos de pipeline	YAML, build clássico, versão clássica
Executa em	Agent, DeploymentGroup
Demandas	Nenhum
Funcionalidades	Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
Restrições de comando	Qualquer
Variáveis configuráveis	Qualquer
Versão do agente	2.191.1 ou superior
Categoria da tarefa	Utilitário