DownloadPipelineArtifact@1 - Transferir a tarefa do artefacto do pipeline v1

Utilize esta tarefa para transferir artefactos de pipeline de fases anteriores neste pipeline ou de outro pipeline.

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

Nota

Para obter mais informações, incluindo comandos da CLI do Azure, veja Transferir artefactos.

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

Entradas

buildType - Transferir artefactos produzidos por
string. Obrigatório. Valores permitidos: current (Compilação atual), specific (Compilação específica). Valor predefinido: current.

Transfere artefactos produzidos pela execução do pipeline atual ou a partir de uma execução de pipeline específica.

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

Especifica o nome do projeto ou GUID a partir do qual pretende transferir os artefactos do pipeline.

pipeline - Pipeline de compilação
Alias de entrada: definition. string. Necessário quando buildType == specific.

O ID de definição do pipeline. Num pipeline em execução, o definitionId pode ser encontrado na variável System.DefinitionId . Também definitionId pode ser obtido a partir do URL na página de descrição geral do pipeline no portal do Azure DevOps. No seguinte exemplo de URL, o definitionId é 78: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. Para transferir artefactos de uma definição de pipeline específica, capture o a definitionId partir desse pipeline e especifique-o como o pipeline parâmetro .

specificBuildWithTriggering - Quando adequado, transfira artefactos a partir da compilação de acionamento.
boolean. Opcional. Utilize quando buildType == specific. Valor predefinido: false.

Se estiver selecionada, a tarefa transfere artefactos da compilação de acionamento. Se não existir nenhuma compilação acionada a partir do pipeline especificado, a tarefa transfere artefactos da compilação especificada nas opções abaixo.

buildVersionToDownload - Criar versão para transferir
string. Necessário quando buildType == specific. Valores permitidos: latest, latestFromBranch (Mais recente a partir de um ramo específico e etiquetas de compilação especificadas), specific (Versão específica). Valor predefinido: latest.

Especifica a versão de compilação a transferir.

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

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

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

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

tags - Criar Etiquetas
string. Opcional. Utilize quando buildType == specific && buildVersionToDownload != specific.

A lista delimitada por vírgulas de etiquetas que a tarefa utiliza para devolver compilações etiquetadas. As compilações não etiquetadas não são devolvidas.

artifactName - Nome do artefacto
string.

Especifica o nome do artefacto a transferir. Se o valor for deixado vazio, a tarefa transfere todos os artefactos associados à execução do pipeline.

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

Os padrões de correspondência de ficheiros que limitam os ficheiros transferidos. O valor pode ser um ou mais padrões de correspondência de ficheiros delimitados por novas linhas. Saiba mais sobre os padrões de correspondência de ficheiros.

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

O caminho no computador do agente onde os artefactos serão transferidos.

Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo 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, veja DownloadPipelineArtifact@2.

Importante

Esta tarefa é suportada apenas nos Serviços de DevOps do Azure. Se o utilizar no 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. Utilizar Transferir Artefactos de Compilação se estiver a utilizar o Azure DevOps Server ou o TFS 2018.

Por predefinição, os artefactos são transferidos para $(Pipeline.Workspace). Se não especificar um nome de artefacto, será criado um subdiretório para cada artefacto transferido. Pode utilizar padrões de correspondência de ficheiros para limitar os ficheiros que pretende transferir.

Como posso encontrar o ID do Pipeline a partir do qual quero transferir um artefacto?

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

Num pipeline em execução, o definitionId pode ser encontrado na variável System.DefinitionId . Também definitionId pode ser obtido a partir do URL na página de descrição geral do pipeline no portal do Azure DevOps. No seguinte exemplo de URL, o definitionId é 78: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. Para transferir artefactos de uma definição de pipeline específica, capture o a definitionId partir desse pipeline e especifique-o como o pipeline parâmetro .

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

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

Requisitos

Requisito	Description
Tipos de pipeline	YAML, Compilação clássica, Versão clássica
É executado em	Agente, DeploymentGroup
Exigências	Nenhuma
Capacidades	Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos	Qualquer
Variáveis de tabelas definidas	Qualquer
Versão do agente	2.155.1 ou superior
Categoria da tarefa	Utilitário