DownloadBuildArtifacts@1 – Ladda ned uppgiften build artifacts v1

Använd den här uppgiften om du vill 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.

# 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.

buildType - Ladda ned artefakter som skapats av
string. Obligatoriskt. 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.

Projektet som byggartefakterna ska laddas ned från.

pipeline - Skapa 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 - Build-versionen för att ladda ned
string. Krävs när buildType == specific. Tillåtna värden: latest, latestFromBranch (senaste från en specifik gren och angivna versionstaggar), specific (specifik version). Standardvärde: latest.

Anger vilken version av bygget 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 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 efter gren-/referensnamn, till exempel: refs/heads/develop.

buildId - Skapa
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. Obligatoriskt. 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 att en specifik artefakt ska 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 - matchningsmönster
string. Standardvärde: **.

Anger de filer som ska laddas ned som ett minimatchningsmönster med flera rader. Mer information finns i referensen Filmatchningsmönster.

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

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

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

Mer information om System.ArtifactsDirectoryfinns i Använda variabler i klassiska versionspipelines.

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

Ta bort alla befintliga filer i målmappen innan du laddar ned artefakten.

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 tjärarkiv
boolean.

Ställ in på true för att extrahera alla nedladdade filer som har tillägget .tar . Detta är användbart eftersom du måste packa artefaktfilerna i tar om du vill bevara Unix-filbehörigheterna. Om du aktiverar alternativet StoreAsTar i uppgiften Publicera byggartefakter lagras artefakter som .tar filer automatiskt.

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

BuildNumber
Lagrar byggnumret för byggartefaktkällan.

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