DownloadBuildArtifacts@0 – Aufgabe "Buildartefakte v0" herunterladen

Verwenden Sie diese Aufgabe, um Dateien herunterzuladen, die als Artefakte eines abgeschlossenen Builds gespeichert wurden.

Wenn Sie Azure DevOps Services verwenden, empfehlen wir die Verwendung von Pipelineartefakten herunterladen und Pipelineartefakte veröffentlichen, um eine höhere Leistung zu erzielen.

Hinweis

Deaktivieren Sie die IIS-Standardauthentifizierung, wenn Sie Azure DevOps Server verwenden, um die Authentifizierung mit Ihrem persönlichen Zugriffstoken zuzulassen. Weitere Informationen finden Sie unter IIS-Standardauthentifizierung und PATs.

Syntax

# Download build artifacts v0
# Download files that were saved as artifacts of a completed build.
- task: DownloadBuildArtifacts@0
  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.
    #allowPartiallySucceededBuilds: false # boolean. Optional. Use when buildType == specific && buildVersionToDownload != specific. Download artifacts even from partially succeeded builds. Default: false.
    #branchName: 'refs/heads/master' # string. Required when buildType == specific && buildVersionToDownload == latestFromBranch. Branch name. Default: refs/heads/master.
    #buildId: # string. Required when buildType == specific && buildVersionToDownload == specific. Build. 
    #tags: # string. Optional. Use when buildType == specific && buildVersionToDownload != specific. Build Tags. 
    downloadType: 'single' # 'single' | 'specific'. Required. Download type. Default: single.
    artifactName: # string. Required when downloadType == single. Artifact name. 
    #itemPattern: '**' # string. Matching pattern. Default: **.
    downloadPath: '$(System.ArtifactsDirectory)' # string. Required. Destination directory. Default: $(System.ArtifactsDirectory).
    #cleanDestinationFolder: false # boolean. Clean destination folder. Default: false.
  # Advanced
    #parallelizationLimit: '8' # string. Parallelization limit. Default: 8.
    #checkDownloadedFiles: false # boolean. Check downloaded files. Default: false.
    #retryDownloadCount: '4' # string. Retry count. Default: 4.
    #retryRedirectDownloadCount: '0' # string. Retry count for redirect download. Default: 0.
    #extractTars: # boolean. Extract all files that are stored inside tar archives.

Eingaben

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

Gibt an, ob Artefakte heruntergeladen werden sollen, die vom aktuellen Build oder von einem bestimmten Build erstellt werden.

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

Das Projekt, aus dem Sie die Buildartefakte herunterladen möchten.

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

Gibt den Namen der Buildpipeline an.

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

Wenn true, versucht dieser Buildtask, Artefakte aus dem auslösenden Build herunterzuladen. Wenn kein auslösender Build aus der angegebenen Pipeline vorhanden ist, werden Artefakte aus dem build heruntergeladen, 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.

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

Wenn trueversucht, diese Buildaufgabe Artefakte herunterzuladen, unabhängig davon, ob der Build erfolgreich oder teilweise erfolgreich ist.

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

Gibt an, ob nach Branch-/Ref-Name gefiltert werden soll, z. B. . refs/heads/develop

buildId - Bauen
string. Erforderlich, wenn buildType == specific && buildVersionToDownload == specific.

Der Build, aus dem Sie die Artefakte herunterladen möchten.

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

Eine durch Trennzeichen getrennte Liste von Tags. Nur Builds mit diesen Tags werden zurückgegeben.

downloadType - Downloadtyp
string. Erforderlich. Zulässige Werte: single (Spezifisches Artefakt), specific (Spezifische Dateien). Standardwert. single.

Lädt ein bestimmtes Artefakt oder bestimmte Dateien aus dem Build herunter.

artifactName - Artefaktname
string. Erforderlich, wenn downloadType == single.

Der Name des herunterzuladenden Artefakts.

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

Gibt die Dateien an, die als mehrzeiliges Minimatchmuster heruntergeladen werden sollen. Weitere Informationen finden Sie unter Referenz zu Dateiabgleichsmustern.

Das Standardmuster \*\* lädt alle Dateien für alle Artefakte im Build herunter, wenn Sie die Option Spezifische Dateien auswählen. Verwenden drop/**Sie zum Herunterladen aller Dateien innerhalb des Artefakt-Drops .

.

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

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

cleanDestinationFolder - Zielordner bereinigen
boolean. Standardwert. false.

Löscht alle vorhandenen Dateien im Zielordner, bevor das Artefakt heruntergeladen wird.

parallelizationLimit - Parallelisierungslimit
string. Standardwert. 8.

Die Anzahl der Dateien, die gleichzeitig heruntergeladen werden sollen.

checkDownloadedFiles - Überprüfen heruntergeladener Dateien
boolean. Standardwert. false.

Wenn true, überprüft dieser Buildtask, ob alle Dateien vollständig heruntergeladen wurden.

retryDownloadCount - Wiederholungsanzahl
string. Standardwert. 4.

Die Anzahl der Wiederholungsversuche beim Herunterladen eines Buildartefakts, wenn beim Download ein Fehler auftritt.

retryRedirectDownloadCount - Wiederholungsanzahl für den Umleitungsdownload
string. Standardwert. 0.

Optionale Anzahl von Wiederholungsversuchen zum Herunterladen eines Buildartefakts, wenn der Download basierend auf der Umleitung fehlschlägt. Wenn Ihr Netzwerk die Umleitung nicht zulässt, können Sie dies auf -1 festlegen, um stattdessen immer gestreamte Antworten von Azure DevOps herunterzuladen.

extractTars - Extrahieren sie alle Dateien, die in tar-Archiven gespeichert sind.
boolean.

Extrahiert alle heruntergeladenen Dateien mit einer .tar Erweiterung. Dies ist hilfreich, da Sie Ihre Artefaktdateien in eine .tar Datei packen müssen, wenn Sie Unix-Dateiberechtigungen beibehalten möchten. Wenn Sie die StoreAsTar Option in der Aufgabe PublishBuildArtifacts aktivieren, werden Artefakte automatisch als .tar Dateien gespeichert.

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 nachgelagerten Schritten, Aufträgen und Phasen nutzen können.

BuildNumber
Speichert die Buildnummer der Buildartefaktquelle.

Beachten Sie, dass diese Eingabe aufgrund der Abwärtskompatibilität BuildId zurückgibt. Weitere Informationen finden Sie unter Variablen.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Klassischer Build, klassische Version
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Keine
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Any
Einstellbare Variablen	Any
Agent-Version	Alle unterstützten Agent-Versionen.
Aufgabenkategorie	Hilfsprogramm