DownloadPipelineArtifact@1 – Aufgabe "Pipelineartefakt v1" herunterladen

Verwenden Sie diese Aufgabe, um Pipeline-Artefakte 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-Befehlen, finden Sie unter Herunterladen von Artefakten.

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

Eingaben

buildType - Herunterladen von Artefakten, die von erstellt wurden
string. Erforderlich. Zulässige Werte: current (Aktueller Build), specific (Spezifischer Build). Standardwert. current.

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

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

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

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

Die Definitions-ID der Pipeline. In einer ausgeführten Pipeline befindet sich die definitionId in der System.DefinitionId-Variable . Die definitionId kann auch über die URL auf der Pipelineübersichtsseite 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.
boolean. Optional. Verwenden Sie , wenn buildType == specific. Standardwert. false.

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

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

Gibt die herunterzuladende Buildversion an.

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

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

pipelineId - Bauen
Eingabealias: buildId. string. Erforderlich, wenn buildType == specific && buildVersionToDownload == 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 . Die buildId kann 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 von dieser Ausführung, und geben Sie es als buildId Parameter an.

tags - Buildtags
string. Optional. Verwenden Sie , wenn buildType == specific && buildVersionToDownload != specific.

Die durch Trennzeichen getrennte Liste von Tags, die der Task verwendet, um getaggte 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 der Task alle Artefakte herunter, die der Pipelineausführung zugeordnet sind.

itemPattern - Übereinstimmende Muster
string. Standardwert. **.

Die Dateiabgleichsmuster, die heruntergeladene Dateien einschränken. Der Wert kann ein oder mehrere Dateiabgleichsmuster sein, die durch neue Zeilentrennzeichen getrennt sind. Erfahren Sie mehr über Dateiabgleichsmuster.

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

Der Pfad auf dem Agent-Computer, auf dem die Artefakte heruntergeladen werden.

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

Keine.

Hinweise

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

Wichtig

Diese Aufgabe wird nur auf Azure DevOps Services unterstützt. Wenn Sie es auf Azure DevOps Server verwenden, erhalten Sie eine Fehlermeldung, die der Verwendung von Buildartefakten zum Herunterladen ähneltPipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead., wenn Sie Azure DevOps Server oder TFS 2018 verwenden.

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-Variable . Die definitionId kann auch über die URL auf der Pipelineübersichtsseite 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 . Die buildId kann 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 von dieser Ausführung, und geben Sie es als buildId Parameter an.

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.155.1 oder höher
Aufgabenkategorie	Hilfsprogramm