DownloadPipelineArtifact@2 – Ladda ned pipelineartefakter v2-uppgift

Använd den här uppgiften om du vill ladda ned pipelineartefakter från tidigare steg i den här pipelinen eller från en annan pipeline.

Använd den här uppgiften om du vill ladda ned pipelineartefakter från tidigare steg i den här pipelinen eller från en annan 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 - Ladda ned artefakter som skapats av
Indataalias: source. string. Obligatoriskt. Tillåtna värden: current (Aktuell körning), specific (Specifik körning). Standardvärde: current.

Laddar ned artefakter som skapats av den aktuella pipelinekörningen eller från en specifik pipelinekörning.

project - Projekt
string. Krävs när source == specific.

Anger projektnamnet eller GUID som pipelineartefakterna ska laddas ned från.

definition - Skapa pipeline
Indataalias: pipeline. string. Krävs när source == specific.

Pipelinens definitions-ID. I en pipeline som körs finns definitionId i variabeln System.DefinitionId. definitionId kan också hämtas från URL:en på pipelineöversiktssidan i Azure DevOps-portalen. I följande URL-exempel är definitionId 78: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. Om du vill ladda ned artefakter från en specifik pipelinedefinition samlar du in definitionId från pipelinen och anger den som parametern pipeline.

specificBuildWithTriggering - När det är lämpligt laddar du ned artefakter från den utlösande versionen.
Indataalias: preferTriggeringPipeline. boolean. Valfritt. Använd när source == specific. Standardvärde: false.

Om det är markerat laddar aktiviteten ned artefakter från den utlösande versionen. Om det inte finns någon utlösande version från den angivna pipelinen laddar aktiviteten ned artefakter från den version som anges i alternativen nedan.

buildVersionToDownload - Build-versionen för att ladda ned
Indataalias: runVersion. string. Krävs när source == specific. Tillåtna värden: latest, latestFromBranch (senaste från en specifik gren och angivna versionstaggar), specific (specifik version). Standardvärde: latest.

Anger den versionsversion som ska laddas ned.

branchName - Grennamn
Indataalias: runBranch. string. Krävs när source == specific && runVersion == latestFromBranch. Standardvärde: refs/heads/master.

Anger filtret på grenen/referensnamnet. Till exempel: refs/heads/develop.

pipelineId - Skapa
Indataalias: runId | buildId. string. Krävs när source == specific && runVersion == specific.

Identifieraren för pipelinekörningen som artefakterna ska laddas ned från. I en pipeline som körs finns buildId i variabeln Build.BuildId. buildId kan också hämtas från URL:en på sammanfattningssidan för pipelinekörning i Azure DevOps-portalen. I följande URL-exempel är buildId 1088: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. Om du vill ladda ned artefakter från en specifik pipelinekörning samlar du in buildId från den körningen och anger den som parametern buildId.

tags - Skapa taggar
string. Valfritt. Använd när source == specific && runVersion != specific.

Den kommaavgränsade listan över taggar som aktiviteten använder för att returnera taggade versioner. Ej taggade versioner returneras inte.

allowPartiallySucceededBuilds - Ladda ned artefakter från delvis slutförda versioner.
boolean. Valfritt. Använd när source == specific && runVersion != specific. Standardvärde: false.

Anger om artefakter ska laddas ned från delvis slutförda versioner. Om du vill göra det måste du ange både allowPartiallySucceededBuilds och allowFailedBuilds till true.

allowFailedBuilds - Ladda ned artefakter från misslyckade versioner.
boolean. Valfritt. Använd när source == specific && runVersion != specific. Standardvärde: false.

Anger om artefakter ska laddas ned från misslyckade versioner.

artifactName - Artefaktnamn
Indataalias: artifact. string.

Anger namnet på artefakten som ska laddas ned. Om värdet lämnas tomt laddar aktiviteten ned alla artefakter som är associerade med pipelinekörningen.

itemPattern - Matchande mönster
Indataalias: patterns. string. Standardvärde: **.

De filmatchningsmönster som begränsar nedladdade filer. Värdet kan vara ett eller flera filmatchningsmönster som är avgränsade med en ny rad. Läs mer om filmatchningsmönster.

Till skillnad från andra uppgifter kommer den här uppgiften att ladda ner en fil som matchar alla mönster. Exkludera mönster kan inte användas för att exkludera tidigare inkluderade filer och inkluderar filer som inte matchar några inkluderingsmönster.

targetPath - Målkatalog
Indataalias: path | downloadPath. string. Obligatoriskt. Standardvärde: $(Pipeline.Workspace).

Anger antingen en relativ eller absolut sökväg på agentdatorn där artefakterna laddas ned. Om alternativet för flera hämtningar tillämpas (genom att lämna ett tomt artefaktnamn) skapas en underkatalog för varje nedladdning. Läs mer om artefakter i Azure Pipelines.

Den här uppgiften definierar följande utdatavariabler som du kan använda i underordnade steg, jobb och faser.

BuildNumber
Lagrar byggnumret för pipelineartefaktkällan.

På grund av bakåtkompatibilitet returnerar den här variabeln BuildId.

Läs mer om byggvariabler.

Den här uppgiften definierar följande utdatavariabler som du kan använda i underordnade steg, jobb och faser.

BuildNumber
Lagrar byggnumret för pipelineartefaktkällan.