DownloadBuildArtifacts@0 – Ladda ned v0-uppgift för att skapa artefakter

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.

Anteckning

Inaktivera grundläggande IIS-autentisering om du använder Azure DevOps Server för att tillåta autentisering med din personliga åtkomsttoken. Mer information finns i Grundläggande autentisering och PAT för IIS .

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.

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 du vill ladda ned byggartefakterna 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.

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.

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.

Tar bort alla befintliga filer i målmappen innan artefakten laddas ned.

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.

retryRedirectDownloadCount - Antal återförsök för nedladdning av omdirigering
string. Standardvärde: 0.

Valfritt antal gånger för att försöka ladda ned en byggartefakt igen om nedladdningen baserat på omdirigering misslyckas. Om nätverket inte tillåter att du följer omdirigeringen kan du ställa in det på -1 för att alltid ladda ned strömmat svar från Azure DevOps i stället.

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

Extraherar alla nedladdade filer som har ett .tar tillägg. Det här är användbart eftersom du måste packa dina artefaktfiler i en .tar fil om du vill behålla Unix-filbehörigheter. StoreAsTar Om du aktiverar alternativet i aktiviteten PublishBuildArtifacts 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 byggetefaktkällans byggnummer.

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

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	Alla agentversioner som stöds.
Uppgiftskategori	Verktyg