DownloadPipelineArtifact@1 – Aufgabe "Pipelineartefakt v1 herunterladen"

Artikel
03/24/2025

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

Es gibt eine neuere Version dieser Aufgabe. Weitere Informationen finden Sie unter DownloadPipelineArtifact@2.

Hinweis

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

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

Wichtig

Diese Aufgabe wird nur für Azure DevOps Services unterstützt. Wenn Sie es auf Azure DevOps Server verwenden, erhalten Sie eine Fehlermeldung wie Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead. Verwenden von Herunterladen von Buildartefakten, wenn Sie Azure DevOps Server oder TFS 2018 verwenden.

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

Eingänge

buildType - Von erzeugte Artefakte herunterladen
string. Erforderlich. Zulässige Werte: current (Aktueller Build), specific (Spezifischer Build). Standardwert: current.

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

project - Project
string. Erforderlich, wenn buildType == specific.

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

pipeline - Buildpipeline-
Eingabealias: definition. string. Erforderlich, wenn buildType == specific.

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

specificBuildWithTriggering - Laden Sie bei Bedarf Artefakte aus dem auslösenden Build herunter.
boolean. Wahlfrei. Wird verwendet, wenn buildType == specific. Standardwert: false.

Wenn diese Option aktiviert ist, lädt die Aufgabe Artefakte aus dem auslösenden Build herunter. Wenn der Build nicht von der angegebenen Pipeline ausgelöst wird, lädt die Aufgabe Artefakte aus dem build herunter, der in den folgenden Optionen angegeben ist.

buildVersionToDownload - Buildversion zum Herunterladen von
string. Erforderlich, wenn buildType == specific. Zulässige Werte: latest, latestFromBranch (Neueste aus einer bestimmten Verzweigung und angegebene Buildtags), specific (Spezifische Version). Standardwert: latest.

Gibt die herunterzuladende Buildversion an.

branchName - Branch-Name
string. Erforderlich, wenn buildType == specific && buildVersionToDownload == latestFromBranch. Standardwert: refs/heads/master.

Gibt den Filter für den Verzweigungs-/Verweisnamen an. Beispiel: refs/heads/develop.

pipelineId - Erstellen
Eingabealias: buildId. string. Erforderlich, wenn buildType == specific && buildVersionToDownload == specific.

Der Bezeichner der Pipeline, aus der die Artefakte heruntergeladen werden sollen. In einer ausgeführten Pipeline finden Sie die buildId in der variablen Build.BuildId. Die buildId können auch über die URL auf der Zusammenfassungsseite der Pipelineausführung im Azure DevOps-Portal abgerufen werden. Im folgenden URL-Beispiel ist die buildId 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 buildId aus dieser Ausführung, und geben Sie sie als buildId-Parameter an.

tags - Buildtags
string. Wahlfrei. Wird verwendet, wenn buildType == specific && buildVersionToDownload != specific.

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

artifactName - Artefaktname
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 - Abgleichsmusters
string. Standardwert: **.

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

targetPath - Zielverzeichnis
Eingabealias: downloadPath. string. Erforderlich. Standardwert: $(System.ArtifactsDirectory).

Der Pfad auf dem Agentcomputer, auf dem die Artefakte heruntergeladen werden.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Bemerkungen

Es gibt eine neuere Version dieser Aufgabe. Weitere Informationen finden Sie unter DownloadPipelineArtifact@2.

Wichtig

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.

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. Die definitionId können auch über die URL auf der Pipelineübersichtsseite im Azure DevOps-Portal abgerufen werden. Im folgenden URL-Beispiel ist die definitionId 78: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. Um Artefakte aus einer bestimmten Pipelinedefinition herunterzuladen, erfassen Sie die definitionId aus dieser Pipeline, und geben Sie sie als pipeline-Parameter an.

So suchen Sie die BuildId für eine bestimmte Pipelineausführung

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Classic Build, Classic Release
Läuft auf	Agent, DeploymentGroup
Anforderungen	Nichts
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Jegliche
Settable-Variablen	Jegliche
Agentversion	2.155.1 oder höher
Vorgangskategorie	Nützlichkeit

Teilen über