DownloadPipelineArtifact@2 – Tarefa Baixar Artefatos de Pipeline v2

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

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

# Download Pipeline Artifacts v2
# Download build and pipeline artifacts.
- task: DownloadPipelineArtifact@2
  inputs:
    buildType: 'current' # 'current' | 'specific'. Alias: source. Required. Download artifacts produced by. Default: current.
    #project: # string. Required when source == specific. Project. 
    #definition: # string. Alias: pipeline. Required when source == specific. Build pipeline. 
    #specificBuildWithTriggering: false # boolean. Alias: preferTriggeringPipeline. Optional. Use when source == specific. When appropriate, download artifacts from the triggering build. Default: false.
    #buildVersionToDownload: 'latest' # 'latest' | 'latestFromBranch' | 'specific'. Alias: runVersion. Required when source == specific. Build version to download. Default: latest.
    #branchName: 'refs/heads/master' # string. Alias: runBranch. Required when source == specific && runVersion == latestFromBranch. Branch name. Default: refs/heads/master.
    #pipelineId: # string. Alias: runId | buildId. Required when source == specific && runVersion == specific. Build. 
    #tags: # string. Optional. Use when source == specific && runVersion != specific. Build Tags. 
    #allowPartiallySucceededBuilds: false # boolean. Optional. Use when source == specific && runVersion != specific. Download artifacts from partially succeeded builds. Default: false.
    #allowFailedBuilds: false # boolean. Optional. Use when source == specific && runVersion != specific. Download artifacts from failed builds. Default: false.
    #artifactName: # string. Alias: artifact. Artifact name. 
    #itemPattern: '**' # string. Alias: patterns. Matching patterns. Default: **.
    targetPath: '$(Pipeline.Workspace)' # string. Alias: path | downloadPath. Required. Destination directory. Default: $(Pipeline.Workspace).

buildType - Baixar artefatos produzidos pelo
Alias de entrada: source. string. Obrigatório Valores permitidos: current (Execução atual) specific (execução específica). 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 source == specific.

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

de pipeline de build do definition -
Alias de entrada: pipeline. string. Necessário quando source == 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.
Alias de entrada: preferTriggeringPipeline. boolean. Opcional. Use quando source == 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
Alias de entrada: runVersion. string. Necessário quando source == 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
Alias de entrada: runBranch. string. Necessário quando source == specific && runVersion == latestFromBranch. Valor padrão: refs/heads/master.

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

pipelineId - Criar
Alias de entrada: runId | buildId. string. Necessário quando source == specific && runVersion == 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 source == specific && runVersion != 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.

allowPartiallySucceededBuilds - Baixe artefatos de builds parcialmente bem-sucedidos.
boolean. Opcional. Use quando source == specific && runVersion != specific. Valor padrão: false.

Especifica se os artefatos devem ser baixados de builds parcialmente bem-sucedidos. Para fazer isso, você deve definir ambos allowPartiallySucceededBuilds e allowFailedBuilds para true.

allowFailedBuilds - Baixe artefatos de builds com falha.
boolean. Opcional. Use quando source == specific && runVersion != specific. Valor padrão: false.

Especifica se os artefatos de builds com falha devem ser baixados.

de nome do artefato artifactName -
Alias de entrada: artifact. 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ões de correspondência
Alias de entrada: patterns. 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.

Ao contrário de outras tarefas, esta tarefa baixará um arquivo que corresponda a qualquer padrão. Os padrões de exclusão não podem ser usados para excluir arquivos incluídos anteriormente e incluirão arquivos que não correspondem a nenhum padrão de inclusão.

de diretório de destino
Alias de entrada: path | downloadPath. string. Obrigatório Valor padrão: $(Pipeline.Workspace).

Especifica um caminho relativo ou absoluto no computador do agente em que os artefatos serão baixados. Se a opção de download múltiplo for aplicada (deixando um nome de artefato vazio), um subdiretório será criado para cada download. Saiba mais sobre artefatos no Azure Pipelines.

Essa tarefa define as seguintes variáveis de saída , que você pode consumir em etapas downstream, trabalhos e estágios.

BuildNumber
Armazena o número de build da origem do artefato de pipeline.

Devido à compatibilidade com versões anteriores, essa variável retorna BuildId.

Saiba mais sobre variáveis de build.

Essa tarefa define as seguintes variáveis de saída , que você pode consumir em etapas downstream, trabalhos e estágios.

BuildNumber
Armazena o número de build da origem do artefato de pipeline.