DownloadBuildArtifacts@1 - Baixar a tarefa de artefatos de build v1

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

Especifica qual versão da compilação baixar.

• Escolha latest baixar a 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 das tags especificadas por tags.
• Escolha specific baixar a versão de compilação especificada por buildId.

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.

• 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

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.

Para obter mais informações sobre System.ArtifactsDirectoryo , consulte Usar variáveis em pipelines de lançamento clássicos.

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.

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.

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 StoreAsTar opção na tarefa Publicar artefatos de compilação armazenará 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 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.