DownloadPipelineArtifact@2 - Transferir a tarefa Artefactos de Pipeline v2

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

Utilize esta tarefa para transferir artefactos de pipeline de fases 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 - Transferir artefactos produzidos por
Alias de entrada: source. string. Obrigatório. Valores permitidos: current (Execução atual), specific (Execuçã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 source == specific.

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

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

O ID de definição do pipeline. Num pipeline em execução, pode encontrar-se definitionId 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 a partir de uma definição de pipeline específica, capture o definitionId desse pipeline e especifique-o como o pipeline parâmetro.

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

Se for verificada, 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
Alias de entrada: runVersion. string. Necessário quando source == 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
Alias de entrada: runBranch. string. Necessário quando source == specific && runVersion == latestFromBranch. Valor predefinido: refs/heads/master.

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

pipelineId - Compilar
Alias de entrada: runId | buildId. string. Necessário quando source == specific && runVersion == specific.

O identificador do pipeline é executado a partir do qual pode transferir os artefactos. Num pipeline em execução, pode encontrar-se buildId 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, é 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 a buildId partir dessa execução e especifique-a como o buildId parâmetro.

tags - Criar Etiquetas
string. Opcional. Utilize quando source == specific && runVersion != specific.

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

allowPartiallySucceededBuilds - Transfira artefactos de compilações com êxito parcial.
boolean. Opcional. Utilize quando source == specific && runVersion != specific. Valor predefinido: false.

Especifica se a tarefa de compilação transfere artefactos se a compilação é bem-sucedida ou se é parcialmente bem-sucedida.

allowFailedBuilds - Transfira artefactos de compilações falhadas.
boolean. Opcional. Utilize quando source == specific && runVersion != specific. Valor predefinido: false.

Se selecionada, a tarefa de compilação transfere artefactos, quer a compilação tenha êxito ou falhe.

artifactName - Nome do artefacto
Alias de entrada: artifact. string.

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

itemPattern - Padrões correspondentes
Alias de entrada: patterns. 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: path | downloadPath. string. Obrigatório. Valor predefinido: $(Pipeline.Workspace).

Especifica um caminho relativo ou absoluto no computador do agente onde os artefactos serão transferidos. Se a opção de transferência múltipla for aplicada (deixando um nome de artefacto vazio), será criado um subdiretório para cada transferência. Saiba mais sobre Artefactos nos Pipelines do Azure.

Esta tarefa define as seguintes variáveis de saída, que pode consumir em passos, tarefas e fases a jusante.

BuildNumber
Armazena o número de compilação da origem do artefacto do pipeline.

Devido à retrocompatibilidade, esta variável devolve BuildId.

Saiba mais sobre as variáveis de compilação.

Esta tarefa define as seguintes variáveis de saída, que pode consumir em passos, tarefas e fases a jusante.

BuildNumber
Armazena o número de compilação da origem do artefacto do pipeline.