Teilen über

DownloadBuildArtifacts@1 – Aufgabe "Buildartefakte v1" herunterladen

  • Artikel

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.

Syntax

# Download build artifacts v1
# Download files that were saved as artifacts of a completed build.
- task: DownloadBuildArtifacts@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.
    #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.
    #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 die Buildartefakte heruntergeladen werden sollen.


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.

Gibt an, welche Version des Builds heruntergeladen werden soll.

  • Wählen Sie latest aus, um die neueste verfügbare Buildversion herunterzuladen.
  • Wählen Sie aus latestFromBranch , um die neueste verfügbare Buildversion der durch branchName und angegebenen Tags angegebenen tagsBranch herunterzuladen.
  • Wählen Sie specific aus, um die von buildIdangegebene Buildversion herunterzuladen.

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.

  • Wählen Sie single (Spezifisches Artefakt) aus, wenn Sie nur ein bestimmtes Artefakt angeben möchten. artifactName
  • Wählen Sie specific (Bestimmte Dateien) aus, wenn Sie alle Artefakte des ausgewählten Builds benötigen.

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öschen Sie alle vorhandenen Dateien im Zielordner vor dem Download des Artefakts.


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.


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

Legen Sie auf fest true , um alle heruntergeladenen Dateien mit der Erweiterung .tar zu extrahieren. Dies ist hilfreich, da Sie Ihre Artefaktdateien in tar packen müssen, wenn Sie Unix-Dateiberechtigungen beibehalten möchten. Wenn Sie die StoreAsTar Option im Task Buildartefakte veröffentlichen 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.

Hinweise

Hinweis

Das Azure Pipelines-Team empfiehlt ein Upgrade von Buildartefakten auf Pipelineartefakte , um die Leistung zu beschleunigen.

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