Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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 obter mais informações, incluindo comandos da CLI do Azure, consulte baixar artefatos.
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 obter mais informações, incluindo comandos da CLI do Azure, consulte 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 no Azure DevOps Services. Se você usá-lo no Servidor do Azure DevOps, 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 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).
Entradas
buildType
-
Baixar artefatos produzidos pelo
string. Obrigatório Valores permitidos: current (build atual), specific (build específico). Valor padrão: current.
Baixa artefatos produzidos pela execução atual do pipeline ou de uma execução de pipeline específica.
project
-
project
string. Necessário quando buildType == specific.
Especifica o nome do projeto ou GUID do qual baixar os artefatos de pipeline.
de pipeline de build do pipeline -
Alias de entrada: definition.
string. Necessá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 parâmetro pipeline.
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 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 a versão de build a ser baixada.
branchName
-
nome do Branch
string. Necessário quando buildType == specific && buildVersionToDownload == latestFromBranch. Valor padrão: refs/heads/master.
Especifica o filtro no nome branch/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 do qual baixar os artefatos. Em um pipeline em execução, o buildId pode ser encontrado na variável de Build.BuildId. O buildId também pode ser recuperado da URL na página de resumo de execução de 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.
de marcas de build tags -
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 registrados não são retornados.
de nome do artefato artifactName -
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.
padrão de correspondência itemPattern -
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 pela nova linha. Saiba mais sobre padrões de correspondência de arquivos.
de diretório de destino
Alias de entrada: downloadPath.
string. Obrigatório Valor padrão: $(System.ArtifactsDirectory).
O caminho no computador do agente em que os artefatos serão baixados.
Opções de controle de tarefa
Todas as tarefas têm opções de controle além das suas entradas de tarefas. Para obter mais informações, consulte as opções de Controle de e as propriedades comuns da tarefa.
Variáveis de saída
Nenhum.
Observações
Há uma versão mais recente dessa tarefa. Para obter mais informações, consulte DownloadPipelineArtifact@2.
Importante
Essa tarefa tem suporte apenas no Azure DevOps Services. Se você usá-lo no Servidor do Azure DevOps, 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 o Servidor de DevOps do Azure ou o TFS 2018.
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 a ID do Pipeline da 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 parâmetro pipeline.
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 de Build.BuildId. O buildId também pode ser recuperado da URL na página de resumo de execução de 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.
Requisitos
| Requisito | Descrição |
|---|---|
| Tipos de pipeline | YAML, build clássico, versão clássica |
| Execuções em | Agente, DeploymentGroup |
| de demandas | Nenhum |
| recursos | Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho. |
| restrições de comando | Qualquer |
| variáveis settable | Qualquer |
| Versão do agente | 2.155.1 ou superior |
| Categoria de tarefa | Utilidade |