DownloadBuildArtifacts@0 – Tarefa Baixar artefatos de build v0

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

Se você estiver usando o Azure DevOps Services, recomendamos usar Baixar artefatos de pipeline e publicar artefatos de pipeline para obter um desempenho mais rápido.

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

# 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.
    #extractTars: # boolean. Extract all files that are stored inside tar archives.

buildType - Baixar artefatos produzidos pelo
string. Obrigatório Valores permitidos: current (build atual), specific (build específico). Valor padrão: current.

Se você deve baixar artefatos produzidos pelo build atual ou de um build específico.

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

O projeto do qual você deseja baixar os artefatos de build.

de pipeline de build do pipeline -
Alias de entrada: definition. string. Necessá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 true, 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 - versão do Build para baixar
string. Necessá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 - Baixar 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. Necessário quando buildType == specific && buildVersionToDownload == latestFromBranch. Valor padrão: refs/heads/master.

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

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

O build do qual você deseja baixar os artefatos.

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

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

de tipo de download do downloadType -
string. Obrigatório 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.

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

O nome do artefato a ser baixado.

padrão de correspondência itemPattern -
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 arquivo.

O padrã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 do artefato, use drop/**.

de diretório de destino
string. Obrigatório 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.

contagem de repetição retryDownloadCount -
string. Valor padrão: 4.

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

retryRedirectDownloadCount - contagem de repetições para de 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 a seguir, você poderá defini-lo 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 extensão .tar. Isso é útil porque você precisa empacotar seus arquivos de artefato em um arquivo .tar se quiser preservar as permissões de arquivo unix. Habilitar a opção StoreAsTar na tarefa PublishBuildArtifacts armazena artefatos como arquivos .tar automaticamente.

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

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

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