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 |