Freigeben über

DownloadBuildArtifacts@1 – Laden Sie die Aufgabe "Buildartefakte v1" herunter

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.

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.

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 - Projekt
string. Erforderlich, wenn buildType == specific.

Das Projekt, aus dem die Buildartefakte heruntergeladen werden sollen.


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.

Gibt an, welche Version des Builds heruntergeladen werden soll.

  • Wählen Sie aus, dass Sie latest die neueste verfügbare Build-Version herunterladen möchten.
  • Wählen Sie aus latestFromBranch , ob die neueste verfügbare Buildversion des Zweigs branchName und der von angegebenen Tags tagsheruntergeladen werden soll.
  • Wählen Sie aus specific , dass die Build-Version heruntergeladen werden soll, die durch angegeben wird buildId.

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.

  • Wählen Sie (Spezifisches Artefakt) aus single , wenn nur ein bestimmtes Artefakt angegeben werden soll durch artifactName
  • Wählen Sie (Spezifische Dateien) aus specific , wenn Sie alle Artefakte des ausgewählten Builds anzeigen möchten

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.

Weitere Informationen zu finden Sie unter System.ArtifactsDirectoryVerwenden von Variablen in klassischen Releasepipelines.


cleanDestinationFolder - sauberen Zielordners
boolean. Standardwert: false.

Löschen Sie alle vorhandenen Dateien im Zielordner, bevor Sie das Artefakt herunterladen.


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.


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

Legen Sie diese Option 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 in der Aufgabe Buildartefakte veröffentlichen 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 Buildartefaktquelle.

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

Bemerkungen

Hinweis

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

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 Beliebig
Settable-Variablen Beliebig
Agentversion 2.191.1 oder höher
Vorgangskategorie Nützlichkeit