DownloadBuildArtifacts@0 - Transferir tarefa de artefactos de compilação v0

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.

Nota

Desative a Autenticação Básica do IIS se estiver a utilizar Azure DevOps Server para permitir a autenticação com o Token de Acesso Pessoal. Veja 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 - 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 pretende 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.

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.

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.

Elimina todos os ficheiros existentes na pasta de destino antes de o artefacto ser transferido.

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.

retryRedirectDownloadCount - Contagem de repetições para transferência de redirecionamento
string. Valor predefinido: 0.

Número opcional de vezes para repetir a transferência de um artefacto de compilação se a transferência com base no redirecionamento falhar. Se a sua rede não permitir seguir o redirecionamento, pode defini-lo como -1 para transferir sempre a resposta transmitida em fluxo a partir do Azure DevOps.

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

Extrai todos os ficheiros transferidos que têm uma .tar extensão. Isto é útil porque tem de empacotar os ficheiros de artefactos num .tar ficheiro se quiser preservar as permissões de ficheiro Unix. Ativar a opção StoreAsTar na tarefa PublishBuildArtifacts armazena artefactos como .tar ficheiros 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.

Requisitos

Requisito	Description
Tipos de pipeline	YAML, Compilação clássica, Versão clássica
É executado em	Agent, 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 definição	Qualquer
Versão do agente	Todas as versões de agente suportadas.
Categoria da tarefa	Utilitário