DownloadBuildArtifacts@1 - Download build artifacts v1 task

Use esta tarefa para baixar arquivos que foram salvos como artefatos de uma compilação concluída.

Se você estiver usando os Serviços de DevOps do Azure, recomendamos usar Download Pipeline Artifacts e Publish Pipeline Artifacts para um desempenho mais rápido.

# 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.

buildType - Download de artefatos produzidos por
string. Obrigatório Valores permitidos: current (compilação atual), specific (compilação específica). Valor predefinido: current.

Seja para baixar artefatos produzidos pela compilação atual ou de uma compilação específica.

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

O projeto a partir do qual baixar os artefatos de construção.

pipeline - Construir pipeline
Alias de entrada: definition. string. Necessário quando buildType == specific.

Especifica o nome do pipeline de compilação.

specificBuildWithTriggering - Quando apropriado, baixe artefatos da compilação de acionamento.
boolean. Opcional. Use quando buildType == specific. Valor predefinido: false.

Se true, esta tarefa de compilação tenta baixar artefatos da compilação de acionamento. Se não houver nenhuma compilação de acionamento do pipeline especificado, ela baixará artefatos da compilação especificada nas opções abaixo.

buildVersionToDownload - Versão de compilação para baixar
string. Necessário quando buildType == specific. Valores permitidos: latest, latestFromBranch (Latest from specific branch and specified Build Tags), specific (Specific version). Valor predefinido: latest.

Especifica qual versão da compilação deve ser baixada.

• Escolha latest fazer o download da versão de compilação mais recente disponível.
• Escolha latestFromBranch baixar a versão de compilação mais recente disponível da ramificação especificada por branchName e as tags especificadas por tags.
• Escolha specific baixar a versão de compilação especificada pelo buildId.

allowPartiallySucceededBuilds - Baixe artefatos mesmo de compilações parcialmente bem-sucedidas.
boolean. Opcional. Use quando buildType == specific && buildVersionToDownload != specific. Valor predefinido: false.

Se true, esta tarefa de compilação tenta baixar artefatos se a compilação for bem-sucedida ou parcialmente bem-sucedida.

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

Especifica se o nome da ramificação/referência deve ser filtrado, por exemplo: refs/heads/develop.

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

A compilação da qual você deseja baixar os artefatos.

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

Uma lista delimitada por vírgulas de tags. Somente compilações com essas tags são retornadas.

downloadType - Tipo de download
string. Obrigatório Valores permitidos: single (artefato específico), specific (arquivos específicos). Valor predefinido: single.

Baixa um artefato específico ou arquivos específicos da compilação.

• Escolha single (Artefato específico) quando quiser apenas um artefato específico especificado por artifactName
• Escolha specific (Arquivos específicos) quando quiser todos os artefatos da compilação selecionada

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

O nome do artefato a ser baixado.

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

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

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

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

O caminho na máquina do agente onde os artefatos são baixados.

Para obter mais informações sobre System.ArtifactsDirectoryo , consulte Usar variáveis em pipelines de versão clássica.

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

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

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

O número de arquivos para baixar simultaneamente.

checkDownloadedFiles - Verifique os arquivos baixados
boolean. Valor predefinido: false.

Se true, esta tarefa de compilação verifica se todos os arquivos foram totalmente baixados.

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

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

extractTars - Extraia 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 arquivos Unix. Habilitar a StoreAsTar opção na tarefa Publicar artefatos de compilação armazenará artefatos como .tar arquivos automaticamente.

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

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

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