DownloadPipelineArtifact@1 – Baixar a tarefa do artefato de pipeline v1

Use essa tarefa para baixar artefatos de pipeline de estágios anteriores neste pipeline ou de outro pipeline.

Há uma versão mais recente dessa tarefa. Para obter mais informações, consulte DownloadPipelineArtifact@2.

Observação

Para saber mais, incluindo comandos da CLI do Azure, confira Como baixar artefatos.

Use essa tarefa para baixar artefatos de pipeline de estágios anteriores neste pipeline ou de outro pipeline.

Importante

Essa tarefa tem suporte apenas em Azure DevOps Services. Se você usá-lo em Azure DevOps Server, receberá uma mensagem de erro semelhante a Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead. Usar Baixar Artefatos de Build se estiver usando Azure DevOps Server ou TFS 2018.

Syntax

# 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).
# Download Pipeline Artifacts v1
# Download Pipeline Artifact.
- 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).

Entradas

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

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


project - Projeto
string. Obrigatório quando buildType == specific.

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


pipeline - Pipeline de build
Alias de entrada: definition. string. Obrigatório quando buildType == specific.

A 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 pipeline parâmetro .


specificBuildWithTriggering - Quando apropriado, baixe artefatos do build de gatilho.
boolean. Opcional. Use quando buildType == specific. Valor padrão: false.

Se marcada, a tarefa baixa artefatos do build de gatilho. Se não houver nenhum build de gatilho do pipeline especificado, a tarefa baixará artefatos do build especificado nas opções abaixo.


buildVersionToDownload - Versão de build a ser baixada
string. Obrigatório quando buildType == specific. Valores permitidos: latest, latestFromBranch (Mais recente do branch específico e marcas de build especificadas), specific (versão específica). Valor padrão: latest.

Especifica a versão de build a ser baixada.


branchName - Nome do branch
string. Obrigatório quando buildType == specific && buildVersionToDownload == latestFromBranch. Valor padrão: refs/heads/master.

Especifica o filtro no nome do branch/ref. Por exemplo: refs/heads/develop.


pipelineId - Construir
Alias de entrada: buildId. string. Obrigatório quando buildType == specific && buildVersionToDownload == specific.

O identificador da execução do pipeline 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 da 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 buildId parâmetro .


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

A lista delimitada por vírgulas de marcas que a tarefa usa para retornar builds marcados. Builds não marcados não são retornados.


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 arquivo que limitam os arquivos baixados. O valor pode ser um ou mais padrões de correspondência de arquivo delimitados por uma nova linha. Saiba mais sobre padrões de correspondência de arquivos.


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

O caminho no computador do agente em que os artefatos serão baixados.


Opções de controle da tarefa

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

Variáveis de saída

Nenhum.

Comentários

Há uma versão mais recente dessa tarefa. Para obter mais informações, consulte DownloadPipelineArtifact@2.

Importante

Essa tarefa tem suporte apenas em Azure DevOps Services. Se você usá-lo em Azure DevOps Server, receberá uma mensagem de erro semelhante a Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead. Usar Baixar Artefatos de Build se estiver usando Azure DevOps Server ou TFS 2018.

Por padrão, os artefatos são baixados em $(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 a ID do pipeline do qual quero baixar um artefato?

Para localizar a 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 pipeline parâmetro .

Para localizar a buildId para uma execução de pipeline específica

O identificador da execução do pipeline 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 da 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 buildId parâmetro .

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Executa em Agent, DeploymentGroup
Demandas Nenhum
Funcionalidades Essa tarefa não atende a nenhuma demanda 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 da tarefa Utilitário
Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Executa em Agent, DeploymentGroup
Demandas Nenhum
Funcionalidades Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente 2.150.3 ou superior
Categoria da tarefa Utilitário