DownloadBuildArtifacts@0 – Baixar a tarefa compilar artefatos v0

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.

Observação

Para permitir a autenticação com seu Token de Acesso Pessoal, desabilite a Autenticação Básica do IIS caso esteja usando o Azure DevOps Server. Confira Autenticação Básica do IIS e PATs para obter mais detalhes.

Syntax

# Download build artifacts v0
# Download files that were saved as artifacts of a completed build.
- task: DownloadBuildArtifacts@0
  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.
    #retryRedirectDownloadCount: '0' # string. Retry count for redirect download. Default: 0.
    #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 você deseja 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.

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.

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.

Exclui todos os arquivos existentes na pasta de destino antes que o artefato seja baixado.

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.

retryRedirectDownloadCount - Contagem de repetições para download de redirecionamento
string. Valor padrão: 0.

Número opcional de vezes para tentar baixar novamente um artefato de build se o download com base no redirecionamento falhar. Se sua rede não permitir o redirecionamento, você poderá defini-la como -1 para sempre baixar a resposta transmitida do Azure DevOps.

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

Extrai todos os arquivos baixados que têm uma .tar extensão. Isso é útil porque você precisa empacotar seus arquivos de artefato em um .tar arquivo se quiser preservar as permissões de arquivo do Unix. Habilitar a opção StoreAsTar na tarefa PublishBuildArtifacts armazena artefatos como .tar arquivos 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.

Requisitos

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