DownloadPipelineArtifact@1 - Tarefa Download do artefato de pipeline v1

2025-06-24

Use esta tarefa para baixar artefatos de pipeline de estágios anteriores desse pipeline ou de outro pipeline.

Existe uma versão mais recente desta tarefa. Para obter mais informações, consulte DownloadPipelineArtifact@2.

Observação

Para obter mais informações, incluindo comandos da CLI do Azure, consulte baixando artefatos.

Use esta tarefa para baixar artefatos de pipeline de estágios anteriores desse pipeline ou de outro pipeline.

Importante

Esta tarefa é suportada apenas nos Serviços de DevOps do Azure. Se você usá-lo no Servidor de DevOps do Azure, receberá uma mensagem de erro semelhante a Usar Baixar Artefatos de Compilação Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead. se estiver usando o Servidor de DevOps do Azure ou o TFS 2018.

Sintaxe

# Download Pipeline Artifacts v1
# Download a named artifact from a pipeline to a local path.
- task: DownloadPipelineArtifact@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.
    #branchName: 'refs/heads/master' # string. Required when buildType == specific && buildVersionToDownload == latestFromBranch. Branch name. Default: refs/heads/master.
    #pipelineId: # string. Alias: buildId. Required when buildType == specific && buildVersionToDownload == specific. Build. 
    #tags: # string. Optional. Use when buildType == specific && buildVersionToDownload != specific. Build Tags. 
    #artifactName: # string. Artifact name. 
    #itemPattern: '**' # string. Matching pattern. Default: **.
    targetPath: '$(System.ArtifactsDirectory)' # string. Alias: downloadPath. Required. Destination directory. Default: $(System.ArtifactsDirectory).

Insumos

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

Downloads de artefatos produzidos pela execução de pipeline atual ou de uma execução de pipeline específica.

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

Especifica o nome do projeto ou GUID do qual baixar os artefatos de pipeline.

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

O ID de definição do pipeline. Em um pipeline em execução, o definitionId pode ser encontrado na variável System.DefinitionId. O definitionId também pode ser recuperado da URL na página de visão geral do pipeline no portal do Azure DevOps. No exemplo de URL a seguir, o definitionId é 78: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. Para baixar artefatos de uma definição de pipeline específica, capture o definitionId desse pipeline e especifique-o como o parâmetro pipeline.

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

Se estiver marcada, a tarefa baixará artefatos da compilação de acionamento. Se não houver nenhuma compilação de acionamento do pipeline especificado, a tarefa 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 padrão: latest.

Especifica a versão de compilação a ser baixada.

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

Especifica o filtro no nome da ramificação/ref. Por exemplo: refs/heads/develop.

pipelineId - Criar
Alias de entrada: buildId. string. Necessário quando buildType == specific && buildVersionToDownload == specific.

O identificador do pipeline é executado a partir do qual baixar os artefatos. Em um pipeline em execução, o buildId pode ser encontrado na variável Build.BuildId. O buildId também pode ser recuperado da URL na página de resumo de execução do pipeline no portal do Azure DevOps. No exemplo de URL a seguir, o buildId é 1088: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. Para baixar artefatos de uma execução de pipeline específica, capture o buildId dessa execução e especifique-o como o parâmetro buildId.

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

A lista delimitada por vírgulas de tags que a tarefa usa para retornar compilações marcadas. Compilações não marcadas não são retornadas.

artifactName - Nome do artefato
string.

Especifica o nome do artefato a ser baixado. Se o valor for deixado vazio, a tarefa baixará todos os artefatos associados à execução do pipeline.

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

Os padrões de correspondência de arquivos que limitam os arquivos baixados. O valor pode ser um ou mais padrões de correspondência de arquivo que são delimitados por novas linhas. Saiba mais sobre padrões de correspondência de arquivos.

targetPath - Diretório de destino
Alias de entrada: downloadPath. string. Obrigatório. Valor padrão: $(System.ArtifactsDirectory).

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

Opções de controlo de tarefas

Todas as tarefas têm opções de controle, além de suas entradas de tarefas. Para obter mais informações, consulte Opções de controle de e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Observações

Existe uma versão mais recente desta tarefa. Para obter mais informações, consulte DownloadPipelineArtifact@2.

Importante

Por padrão, os artefatos são baixados para $(Pipeline.Workspace). Se você não especificar um nome de artefato, um subdiretório será criado para cada artefato baixado. Você pode usar padrões de correspondência de arquivos para limitar os arquivos que deseja baixar.

Como posso encontrar o ID do Pipeline do qual quero baixar um artefato?

Para localizar o definitionId para uma definição de pipeline específica

Em um pipeline em execução, o definitionId pode ser encontrado na variável System.DefinitionId. O definitionId também pode ser recuperado da URL na página de visão geral do pipeline no portal do Azure DevOps. No exemplo de URL a seguir, o definitionId é 78: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. Para baixar artefatos de uma definição de pipeline específica, capture o definitionId desse pipeline e especifique-o como o parâmetro pipeline.

Para localizar o buildId para um pipeline específico, execute

Requerimentos

Requisito	Descrição
Tipos de pipeline	YAML, Construção clássica, Versão clássica
Funciona em	Agente, DeploymentGroup
Exigências	Nenhum
Capacidades	Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes no trabalho.
Restrições de comando	Qualquer
Variáveis configuráveis	Qualquer
Versão do agente	2.155.1 ou superior
Categoria de tarefa	Utilidade