DownloadPipelineArtifact@2 – Ladda ned pipelineartefakt v2-uppgift

Använd den här uppgiften för att ladda ned pipelineartefakter från tidigare steg i den här pipelinen eller från en annan pipeline.

Anteckning

Mer information, inklusive Azure CLI-kommandon, finns i ladda ned artefakter.

Syntax

# 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).

Indata

buildType - Ladda ned artefakter som skapats av
Indataalias: source. string. Krävs. 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 - Bygg-pipeline
Indataalias: pipeline. string. Krävs när source == specific.

Definitions-ID för pipelinen. I en pipeline som körs definitionId finns den 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 definitionId är är 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 från pipelinen definitionId och anger den som parameter.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 den är markerad 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 - Skapa version som ska laddas ned
Indataalias: runVersion. string. Krävs när source == specific. Tillåtna värden: latest, latestFromBranch (Senaste från en specifik gren och angivna build-taggar), specific (specifik version). Standardvärde: latest.

Anger den version av versionen som ska laddas ned.

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

Anger filtret för grenen/referensnamnet. Exempel: refs/heads/develop.

pipelineId - Bygga
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 buildId finns den 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 buildId är 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 från den körningen buildId och anger den som parameter.buildId

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

Kommaavgränsad lista ö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 bygguppgiften laddar ned artefakter om bygget lyckas eller delvis lyckas.

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

Om den är markerad laddar bygguppgiften ned artefakter om bygget lyckas eller misslyckas.

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: **.

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.

targetPath - Målkatalog
Indataalias: path | downloadPath. string. Krävs. 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.

Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

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

BuildNumber
Lagrar byggnumret för pipelineartefaktkällan.

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

Läs mer om byggvariabler.

Kommentarer

Viktigt

Den här uppgiften stöds endast i Azure DevOps Services. Om du använder den på Azure DevOps Server får du ett felmeddelande som liknar Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead. Använd Ladda ned byggartefakter om du använder Azure DevOps Server eller TFS 2018.

Använd den här uppgiften om du vill ladda ned pipelineartefakter från tidigare faser i den här pipelinen eller från en annan pipeline. Som standard laddas artefakter ned till $(Pipeline.Workspace). Om du inte anger ett artefaktnamn skapas en underkatalog för varje nedladdad artefakt. Du kan använda filmatchningsmönster för att begränsa de filer som du vill ladda ned.

Nyckelorden publicera och ladda ned är uppgiftsgenvägar för att publicera och ladda ned pipelineartefakter.

Hur hittar jag ID:t för den pipeline som jag vill ladda ned en artefakt från?

Så här hittar du definitionId för en specifik pipelinedefinition

I en pipeline definitionId som körs finns den 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 definitionId är 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 parameter.pipeline

Så här hittar du buildId för en specifik pipelinekörning

Identifieraren för pipelinekörningen som artefakterna ska laddas ned från. I en pipeline buildId som körs finns 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 buildId är 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 från den körningen buildId och anger den som parameter.buildId

Exempel

Ladda ned en specifik artefakt

# Download an artifact named 'WebApp' to 'bin' in $(Build.SourcesDirectory)
- task: DownloadPipelineArtifact@2
  inputs:
    artifactName: 'WebApp'
    targetPath: $(Build.SourcesDirectory)/bin

Ladda ned artefakter från ett specifikt projekt/pipeline

# Download artifacts from a specific pipeline.
- task: DownloadPipelineArtifact@2
  inputs:
    buildType: 'specific'
    project: 'FabrikamFiber'
    definition: 12
    buildVersionToDownload: 'latest'

Ladda ned artefakter från en specifik gren

# Download artifacts from a specific branch with a tag
- task: DownloadPipelineArtifact@2
  inputs:
    buildType: 'specific'
    project: 'FabrikamFiber'
    definition: 12
    buildVersionToDownload: 'latestFromBranch'
    branchName: 'refs/heads/master'
    tags: 'testTag'

Ladda ned en artefakt från en specifik byggkörning

# Download an artifact named 'WebApp' from a specific build run to 'bin' in $(Build.SourcesDirectory)
- task: DownloadPipelineArtifact@2
  inputs:
    buildType: 'specific'
    artifactName: 'WebApp'
    targetPath: $(Build.SourcesDirectory)/bin
    project: 'FabrikamFiber'
    definition: 12
    buildVersionToDownload: 'specific'
    pipelineId: 40

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent, DeploymentGroup
Krav	Ingen
Funktioner	Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar	Valfri
Inställningsbara variabler	Valfri
Agentversion	2.164.1 eller senare
Uppgiftskategori	Verktyg