DownloadBuildArtifacts@0 – Buildartefakte v0-Aufgabe 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 Herunterladen von Pipelineartefakten und Veröffentlichen von Pipelineartefakten für eine schnellere Leistung.

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.

Eingänge

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

Ganz gleich, ob Artefakte heruntergeladen werden sollen, die vom aktuellen Build oder aus einem bestimmten Build erstellt wurden.

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

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

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

Gibt den Namen der Buildpipeline an.

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

Wenn true, versucht diese Buildaufgabe, Artefakte aus dem auslösenden Build herunterzuladen. Wenn kein Auslösen von Build aus der angegebenen Pipeline vorhanden ist, werden Artefakte aus dem in den folgenden Optionen angegebenen Build heruntergeladen.

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.

allowPartiallySucceededBuilds - Laden Sie Artefakte sogar aus teilweise erfolgreichen Builds herunter.
boolean. Wahlfrei. Wird verwendet, wenn buildType == specific && buildVersionToDownload != specific. Standardwert: false.

Wenn true, versucht diese Buildaufgabe, Artefakte herunterzuladen, ob der Build erfolgreich ist oder teilweise erfolgreich ist.

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

Gibt an, ob nach Verzweigungs-/Verweisnamen gefiltert werden soll, z. B. refs/heads/develop.

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

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

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

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

downloadType - Downloadtyp
string. Erforderlich. Zulässige Werte: single (Spezifisches Artefakt), specific (bestimmte 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 - Abgleichsmusters
string. Standardwert: **.

Gibt die Dateien an, die als mehrzeiliges Miniübereinstimmungsmuster heruntergeladen werden sollen. Weitere Informationen finden Sie unter Dateiabgleichsmuster.

Das Standardmuster \*\* alle Dateien in allen Artefakten im Build herunterladen, wenn Sie die Option Spezifische Dateien auswählen. Um alle Dateien im Artefaktablage herunterzuladen, verwenden Sie drop/**.

.

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

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

cleanDestinationFolder - sauberen Zielordners
boolean. Standardwert: false.

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

parallelizationLimit - Parallelisierungsgrenzwert
string. Standardwert: 8.

Die Anzahl der Dateien, die gleichzeitig heruntergeladen werden sollen.

checkDownloadedFiles - Heruntergeladene Dateien überprüfen
boolean. Standardwert: false.

Wenn true, überprüft diese Buildaufgabe, ob alle Dateien vollständig heruntergeladen werden.

retryDownloadCount - Wiederholungsanzahl
string. Standardwert: 4.

Die Anzahl der Wiederholungsversuche beim Herunterladen eines Buildartefakts, wenn der Download fehlschlägt.

retryRedirectDownloadCount - Anzahl der Wiederholungen für den Umleitungsdownload
string. Standardwert: 0.

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

extractTars - Extrahieren aller Dateien, die in Tar-Archiven gespeichert sind,
boolean.

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

Aufgabensteuerungsoptionen

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

Ausgabevariablen

Mit dieser Aufgabe werden die folgenden Ausgabevariablendefiniert, die Sie in nachgeschalteten Schritten, Aufträgen und Phasen verwenden können.

BuildNumber
Speichert die Buildnummer der Buildartefaktequelle.

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

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	Alle unterstützten Agentversionen.
Vorgangskategorie	Nützlichkeit