Dela via

DownloadPipelineArtifact@1 – Ladda ned pipelineartefakt v1-uppgift

  • Artikel

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.

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

Anmärkning

Mer information, inklusive Azure CLI-kommandon, finns i nedladdning av artefakter.

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.

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 build artifacts 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).

Ingångar

buildType - Ladda ned artefakter som skapats av
string. Obligatoriskt. 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 - Project
string. Krävs när buildType == specific.

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


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

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


pipelineId - Skapa
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 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 buildType == specific && buildVersionToDownload != specific.

Den kommaavgränsade listan ö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 - matchningsmönster
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.


targetPath - Målkatalog
Indataalias: downloadPath. string. Obligatoriskt. Standardvärde: $(System.ArtifactsDirectory).

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


Kontrollalternativ för aktivitet

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

Utdatavariabler

Ingen.

Anmärkningar

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 Ladda ned build artifacts 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 definitionId för en specifik pipelinedefinition

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.

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

Krav

Krav Beskrivning
Pipelinetyper YAML, klassisk version, klassisk version
Körs på Agent, DeploymentGroup
kräver Ingen
funktioner Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar Vilken som helst
variabler som kan Vilken som helst
Agentversion 2.155.1 eller senare
Aktivitetskategori Nytta