DownloadBuildArtifacts@1 – Ladda ned v1-uppgift för byggartefakter

  • Artikel

Använd den här uppgiften för att ladda ned filer som har sparats som artefakter i en färdig version.

Om du använder Azure DevOps Services rekommenderar vi att du använder Ladda ned pipelineartefakter och publicera pipelineartefakter för snabbare prestanda.

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.

Indata

buildType - Ladda ned artefakter som skapats av
string. Krävs. Tillåtna värden: current (Aktuell version), specific (Specifik version). Standardvärde: current.

Om du vill ladda ned artefakter som skapats av den aktuella versionen eller från en specifik version.


project - Projekt
string. Krävs när buildType == specific.

Det projekt som byggartefakterna ska laddas ned från.


pipeline - Bygg-pipeline
Indataalias: definition. string. Krävs när buildType == specific.

Anger namnet på bygg-pipelinen.


specificBuildWithTriggering - När det är lämpligt laddar du ned artefakter från den utlösande versionen.
boolean. Valfritt. Använd när buildType == specific. Standardvärde: false.

Om trueförsöker den här bygguppgiften ladda ned artefakter från den utlösande versionen. Om det inte finns någon utlösande version från den angivna pipelinen hämtar den artefakter från den version som anges i alternativen nedan.


buildVersionToDownload - Skapa version som ska laddas ned
string. Krävs när buildType == specific. Tillåtna värden: latest, latestFromBranch (Senaste från en specifik gren och angivna build-taggar), specific (specifik version). Standardvärde: latest.

Anger vilken version av versionen som ska laddas ned.

  • Välj latest att ladda ned den senaste tillgängliga versionen.
  • Välj latestFromBranch att ladda ned den senaste tillgängliga versionen av grenen som anges av branchName och taggar som anges av tags.
  • Välj specific att ladda ned den version av versionen som anges av buildId.

allowPartiallySucceededBuilds - Ladda ned artefakter även från delvis slutförda versioner.
boolean. Valfritt. Använd när buildType == specific && buildVersionToDownload != specific. Standardvärde: false.

Om trueförsöker den här bygguppgiften ladda ned artefakter om bygget lyckas eller delvis lyckas.


branchName - Grennamn
string. Krävs när buildType == specific && buildVersionToDownload == latestFromBranch. Standardvärde: refs/heads/master.

Anger om du vill filtrera på gren-/referensnamn, till exempel: refs/heads/develop.


buildId - Bygga
string. Krävs när buildType == specific && buildVersionToDownload == specific.

Den version som du vill ladda ned artefakterna från.


tags - Skapa taggar
string. Valfritt. Använd när buildType == specific && buildVersionToDownload != specific.

En kommaavgränsad lista med taggar. Endast versioner med dessa taggar returneras.


downloadType - Nedladdningstyp
string. Krävs. Tillåtna värden: single (specifik artefakt), specific (specifika filer). Standardvärde: single.

Laddar ned en specifik artefakt eller specifika filer från bygget.

  • Välj single (specifik artefakt) när du bara vill ha en specifik artefakt som anges av artifactName
  • Välj specific (specifika filer) när du vill ha alla artefakter i den valda versionen

artifactName - Artefaktnamn
string. Krävs när downloadType == single.

Namnet på artefakten som ska laddas ned.


itemPattern - Matchande mönster
string. Standardvärde: **.

Anger vilka filer som ska laddas ned som ett minimatchningsmönster med flera rader. Mer information finns i Referens för filmatchningsmönster.

Standardmönstret \*\* laddar ned alla filer över alla artefakter i bygget om du väljer alternativet Specifika filer . Om du vill ladda ned alla filer i artefaktdroppen använder du drop/**.


downloadPath - Målkatalog
string. Krävs. Standardvärde: $(System.ArtifactsDirectory).

Sökvägen till agentdatorn där artefakterna laddas ned.


cleanDestinationFolder - Rensa målmapp
boolean. Standardvärde: false.

Ta bort alla befintliga filer i målmappen innan artefaktnedladdningen.


parallelizationLimit - Gräns för parallellisering
string. Standardvärde: 8.

Antalet filer som ska laddas ned samtidigt.


checkDownloadedFiles - Kontrollera nedladdade filer
boolean. Standardvärde: false.

Om truekontrollerar den här bygguppgiften att alla filer är helt nedladdade.


retryDownloadCount - Antal återförsök
string. Standardvärde: 4.

Antalet gånger du försöker ladda ned en byggartefakt igen om nedladdningen misslyckas.


extractTars - Extrahera alla filer som lagras i tar-arkiv
boolean.

Ange till för att true extrahera alla nedladdade filer som har .tar-tillägget . Det här är användbart eftersom du måste packa dina artefaktfiler i tjära om du vill behålla Unix-filbehörigheter. StoreAsTar Om du aktiverar alternativet i aktiviteten Publicera byggartefakter lagras artefakter automatiskt som .tar-filer.


Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Den här uppgiften definierar följande utdatavariabler, som du kan använda i underordnade steg, jobb och steg.

BuildNumber
Lagrar byggnumret för kompileringsartefaktkällan.

Observera att dessa indata returnerar BuildId på grund av bakåtkompatibilitet. Mer information finns i Variabler.

Kommentarer

Anteckning

Azure Pipelines-teamet rekommenderar att du uppgraderar från byggartefakter till pipelineartefakter för snabbare prestanda.

Krav

Krav Beskrivning
Pipelinetyper YAML, klassisk version, klassisk version
Körs på Agent, DeploymentGroup
Krav Ingen
Funktioner Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar Valfri
Inställningsbara variabler Valfri
Agentversion 2.191.1 eller senare
Uppgiftskategori Verktyg