DownloadPipelineArtifact@2: Task "Pipeline artifacts v2" herunterladen

Verwenden Sie diese Aufgabe, um Pipeline-Artefakte aus früheren Phasen dieser Pipeline oder aus einer anderen Pipeline herunterzuladen.

Hinweis

Weitere Informationen, einschließlich Azure CLI-Befehlen, finden Sie unter Herunterladen von Artefakten.

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

Eingaben

buildType - Herunterladen von Artefakten, die von erstellt wurden
Eingabealias: source. string. Erforderlich. Zulässige Werte: current (Aktuelle Ausführung), specific (Spezifische Ausführung). Standardwert. current.

Lädt Artefakte herunter, die von der aktuellen Pipelineausführung oder einer bestimmten Pipelineausführung erstellt wurden.

project - Projekt
string. Erforderlich, wenn source == specific.

Gibt den Projektnamen oder die GUID an, aus der die Pipelineartefakte heruntergeladen werden sollen.

definition - Erstellen einer Pipeline
Eingabealias: pipeline. string. Erforderlich, wenn source == specific.

Die Definitions-ID der Pipeline. In einer ausgeführten Pipeline befindet sich die definitionId in der System.DefinitionId-Variablen . Kann definitionId auch über die URL auf der Übersichtsseite der Pipeline im Azure DevOps-Portal abgerufen werden. Im folgenden URL-Beispiel ist der definitionId 78: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. Um Artefakte aus einer bestimmten Pipelinedefinition herunterzuladen, erfassen Sie die aus dieser definitionId Pipeline, und geben Sie sie als pipeline Parameter an.

specificBuildWithTriggering - Laden Sie ggf. Artefakte aus dem auslösenden Build herunter.
Eingabealias: preferTriggeringPipeline. boolean. Optional. Verwenden Sie , wenn source == specific. Standardwert. false.

Wenn diese Option aktiviert ist, lädt die Aufgabe Artefakte aus dem auslösenden Build herunter. Wenn kein auslösender Build aus der angegebenen Pipeline vorhanden ist, lädt die Aufgabe Artefakte aus dem build herunter, der in den folgenden Optionen angegeben ist.

buildVersionToDownload - Buildversion zum Herunterladen
Eingabealias: runVersion. string. Erforderlich, wenn source == specific. Zulässige Werte: latest, latestFromBranch (Latest from specific branch and specified Build Tags), specific (Specific version). Standardwert. latest.

Gibt die herunterzuladende Buildversion an.

branchName - Branchname
Eingabealias: runBranch. string. Erforderlich, wenn source == specific && runVersion == latestFromBranch. Standardwert. refs/heads/master.

Gibt den Filter für den Branch-/Ref-Namen an. Beispiel: refs/heads/develop.

pipelineId - Bauen
Eingabealias: runId | buildId. string. Erforderlich, wenn source == specific && runVersion == specific.

Der Bezeichner der Pipelineausführung, aus der die Artefakte heruntergeladen werden sollen. In einer ausgeführten Pipeline finden Sie die buildId in der Build.BuildId-Variable . Kann buildId auch über die URL auf der Seite mit der Zusammenfassung der Pipelineausführung im Azure DevOps-Portal abgerufen werden. Im folgenden URL-Beispiel buildId ist 1088: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. Um Artefakte aus einer bestimmten Pipelineausführung herunterzuladen, erfassen Sie die aus dieser buildId Ausführung, und geben Sie es als buildId Parameter an.

tags - Buildtags
string. Optional. Verwenden Sie , wenn source == specific && runVersion != specific.

Die durch Trennzeichen getrennte Liste von Tags, die der Task verwendet, um markierte Builds zurückzugeben. Nicht markierte Builds werden nicht zurückgegeben.

allowPartiallySucceededBuilds - Laden Sie Artefakte aus teilweise erfolgreichen Builds herunter.
boolean. Optional. Verwenden Sie , wenn source == specific && runVersion != specific. Standardwert. false.

Gibt an, ob die Buildaufgabe Artefakte herunterlädt, ob der Build erfolgreich oder teilweise erfolgreich ist.

allowFailedBuilds - Laden Sie Artefakte aus fehlerhaften Builds herunter.
boolean. Optional. Verwenden Sie , wenn source == specific && runVersion != specific. Standardwert. false.

Wenn diese Option aktiviert ist, lädt der Buildtask Artefakte herunter, unabhängig davon, ob der Build erfolgreich ist oder fehlschlägt.

artifactName - Artefaktname
Eingabealias: artifact. string.

Gibt den Namen des herunterzuladenden Artefakts an. Wenn der Wert leer bleibt, lädt die Aufgabe alle Artefakte herunter, die der Pipelineausführung zugeordnet sind.

itemPattern - Abgleichsmuster
Eingabealias: patterns. string. Standardwert. **.

Die Dateiabgleichsmuster, die heruntergeladene Dateien einschränken. Der Wert kann ein oder mehrere Dateiabgleichsmuster sein, bei denen eine neue Zeile durch Trennzeichen getrennt ist. Erfahren Sie mehr über Dateiabgleichsmuster.

targetPath - Zielverzeichnis
Eingabealias: path | downloadPath. string. Erforderlich. Standardwert. $(Pipeline.Workspace).

Gibt entweder einen relativen oder absoluten Pfad auf dem Agentcomputer an, auf den die Artefakte heruntergeladen werden. Wenn die Option "Mehrfachdownload" angewendet wird (durch Belassen eines leeren Artefaktnamens), wird für jeden Download ein Unterverzeichnis erstellt. Erfahren Sie mehr über Artefakte in Azure Pipelines.

Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Diese Aufgabe definiert die folgenden Ausgabevariablen, die Sie in Downstreamschritten, Aufträgen und Phasen verwenden können.

BuildNumber
Speichert die Buildnummer der Pipelineartefaktquelle.

Aufgrund der Abwärtskompatibilität gibt diese Variable BuildId zurück.

Erfahren Sie mehr über Buildvariablen.

Hinweise

Wichtig

Diese Aufgabe wird nur auf Azure DevOps Services unterstützt. Wenn Sie es auf Azure DevOps Server verwenden, erhalten Sie eine Fehlermeldung ähnlich wie Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead. Use Download Build Artifacts if you're use Azure DevOps Server or TFS 2018.

Verwenden Sie diese Aufgabe, um Pipeline-Artefakte aus früheren Phasen dieser Pipeline oder aus einer anderen Pipeline herunterzuladen. Standardmäßig werden Artefakte in $(Pipeline.Workspace) heruntergeladen. Wenn Sie keinen Artefaktnamen angeben, wird für jedes heruntergeladene Artefakt ein Unterverzeichnis erstellt. Sie können Dateiabgleichsmuster verwenden, um die Dateien einzuschränken, die Sie herunterladen möchten.

Die Schlüsselwörter veröffentlichen und herunterladen sind Aufgabenverknüpfungen zum Veröffentlichen und Herunterladen Ihrer Pipelineartefakte.

Wie finde ich die ID der Pipeline, aus der ich ein Artefakt herunterladen möchte?

So suchen Sie die definitionId für eine bestimmte Pipelinedefinition

In einer ausgeführten Pipeline befindet sich die definitionId in der System.DefinitionId-Variablen . Kann definitionId auch über die URL auf der Übersichtsseite der Pipeline im Azure DevOps-Portal abgerufen werden. Im folgenden URL-Beispiel ist der definitionId 78: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. Um Artefakte aus einer bestimmten Pipelinedefinition herunterzuladen, erfassen Sie die aus dieser definitionId Pipeline, und geben Sie sie als pipeline Parameter an.

So suchen Sie die buildId für eine bestimmte Pipeline

Der Bezeichner der Pipelineausführung, aus der die Artefakte heruntergeladen werden sollen. In einer ausgeführten Pipeline finden Sie die buildId in der Build.BuildId-Variable . Kann buildId auch über die URL auf der Seite mit der Zusammenfassung der Pipelineausführung im Azure DevOps-Portal abgerufen werden. Im folgenden URL-Beispiel buildId ist 1088: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. Um Artefakte aus einer bestimmten Pipelineausführung herunterzuladen, erfassen Sie die aus dieser buildId Ausführung, und geben Sie es als buildId Parameter an.

Beispiele

Herunterladen eines bestimmten Artefakts

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

Herunterladen von Artefakten aus einem bestimmten Projekt/einer bestimmten Pipeline

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

Herunterladen von Artefakten aus einem bestimmten Branch

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

Herunterladen eines Artefakts aus einer bestimmten Buildausführung

# 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

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Klassischer Build, klassisches Release
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Keine
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Any
Setzbare Variablen	Any
Agent-Version	2.164.1 oder höher
Aufgabenkategorie	Hilfsprogramm