Dela via


DownloadPipelineArtifact@1 – Ladda ned pipelineartefakt v1-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.

Det finns en nyare version av den här uppgiften. Mer information finns i DownloadPipelineArtifact@2.

Anteckning

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

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.

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 Hämta byggartefakter om du använder Azure DevOps Server eller TFS 2018.

Syntax

# 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).
# Download Pipeline Artifacts v1
# Download Pipeline Artifact.
- 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).

Indata

buildType - Ladda ned artefakter som skapats av
string. Krävs. Tillåtna värden: current (Aktuell version), specific (Specifik version). 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 buildType == specific.

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


pipeline - Bygg-pipeline
Indataalias: definition. string. Krävs när buildType == 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.
boolean. Valfritt. Använd när buildType == 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
string. Krävs när buildType == 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
string. Krävs när buildType == specific && buildVersionToDownload == latestFromBranch. Standardvärde: refs/heads/master.

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


pipelineId - Bygga
Indataalias: buildId. string. Krävs när buildType == specific && buildVersionToDownload == 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 buildType == specific && buildVersionToDownload != specific.

Kommaavgränsad lista över taggar som aktiviteten använder för att returnera taggade versioner. Ej taggade versioner returneras inte.


artifactName - Artefaktnamn
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
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: downloadPath. string. Krävs. Standardvärde: $(System.ArtifactsDirectory).

Sökvägen till agentdatorn där artefakterna ska laddas ned.


Kontrollalternativ för aktivitet

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

Utdatavariabler

Inga.

Kommentarer

Det finns en nyare version av den här uppgiften. Mer information finns i DownloadPipelineArtifact@2.

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 Hämta byggartefakter om du använder Azure DevOps Server eller TFS 2018.

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.

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

Så här hittar du definitionSid 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 ä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

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 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

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.155.1 eller senare
Uppgiftskategori Verktyg
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.150.3 eller senare
Uppgiftskategori Verktyg