DownloadBuildArtifacts@1 – Stažení úlohy artefaktů sestavení v1

Pomocí této úlohy můžete stahovat soubory uložené jako artefakty dokončeného sestavení.

Pokud používáte Azure DevOps Services, doporučujeme použít stažení artefaktů kanálu a publikování artefaktů kanálu pro zajištění rychlejšího výkonu.

Syntaxe

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

Vstupy

buildType - Stažení artefaktů vytvořených službou
string. Povinné. Povolené hodnoty: current (aktuální sestavení), specific (konkrétní sestavení). Výchozí hodnota: current.

Ať už chcete stáhnout artefakty vytvořené aktuálním sestavením nebo z konkrétního sestavení.

project - Projekt
string. Požadováno při buildType == specific.

Projekt, ze kterého se mají stáhnout artefakty sestavení.

pipeline - kanálu buildu
Vstupní alias: definition. string. Požadováno při buildType == specific.

Určuje název kanálu buildu.

specificBuildWithTriggering - Pokud je to vhodné, stáhněte artefakty z triggerujícího sestavení.
boolean. Volitelný. Používá se při buildType == specific. Výchozí hodnota: false.

Pokud true, pokusí se tato úloha sestavení stáhnout artefakty z triggerujícího sestavení. Pokud se ze zadaného kanálu neaktivuje sestavení, stáhne artefakty z sestavení zadaného v následujících možnostech.

buildVersionToDownload - verzi buildu ke stažení
string. Požadováno při buildType == specific. Povolené hodnoty: latest, latestFromBranch (nejnovější z konkrétní větve a zadané značky sestavení), specific (konkrétní verze). Výchozí hodnota: latest.

Určuje, kterou verzi sestavení se má stáhnout.

• Zvolte latest možnost stáhnout nejnovější dostupnou verzi sestavení.
• Zvolte latestFromBranch , zda chcete stáhnout nejnovější dostupnou verzi sestavení větve určené parametrem branchName a značek určených parametrem tags.
• Zvolte specific , zda chcete stáhnout verzi sestavení určenou parametrem buildId.

allowPartiallySucceededBuilds - Stažení artefaktů i z částečně úspěšných sestavení.
boolean. Volitelný. Používá se při buildType == specific && buildVersionToDownload != specific. Výchozí hodnota: false.

Pokud true, pokusí se tato úloha sestavení stáhnout artefakty bez ohledu na to, jestli sestavení proběhne úspěšně nebo částečně úspěšně.

branchName - název větve
string. Požadováno při buildType == specific && buildVersionToDownload == latestFromBranch. Výchozí hodnota: refs/heads/master.

Určuje, jestli se má filtrovat podle názvu větve nebo odkazu, například: refs/heads/develop.

buildId - Sestavení
string. Požadováno při buildType == specific && buildVersionToDownload == specific.

Sestavení, ze kterého chcete stáhnout artefakty.

tags - vytvářet značky
string. Volitelný. Používá se při buildType == specific && buildVersionToDownload != specific.

Seznam značek oddělených čárkami. Vrátí se pouze sestavení s těmito značkami.

downloadType - Typ stahování
string. Povinné. Povolené hodnoty: single (konkrétní artefakt), specific (konkrétní soubory). Výchozí hodnota: single.

Stáhne konkrétní artefakt nebo konkrétní soubory z sestavení.

• Zvolte single (Specifický artefakt), pokud chcete pouze jeden konkrétní artefakt určený parametrem artifactName
• Zvolte specific (Specifické soubory), pokud chcete všechny artefakty vybraného sestavení

artifactName - název artefaktu
string. Požadováno při downloadType == single.

Název artefaktu, který chcete stáhnout.

vzor porovnávání itemPattern -
string. Výchozí hodnota: **.

Určuje soubory, které se mají stáhnout jako vzor minimatchu s více řádky. Další informace naleznete v tématu Vzory porovnávání souborů referenční.

Výchozí vzor \*\* stáhne všechny soubory napříč všemi artefakty v sestavení, pokud zvolíte možnost Konkrétní soubory. Pokud chcete stáhnout všechny soubory v rozevíracím seznamu artefaktů, použijte drop/**.

cílového adresáře
string. Povinné. Výchozí hodnota: $(System.ArtifactsDirectory).

Cesta na počítači agenta, kde se stahují artefakty.

Další informace o System.ArtifactsDirectorytématu najdete v tématu Použití proměnných v klasických kanálech verze.

cleanDestinationFolder - vyčistit cílovou složku
boolean. Výchozí hodnota: false.

Před stažením artefaktu odstraňte všechny existující soubory v cílové složce.

parallelizationLimit - limit paralelizace
string. Výchozí hodnota: 8.

Počet souborů, které se mají stáhnout současně.

checkDownloadedFiles - Kontrola stažených souborů
boolean. Výchozí hodnota: false.

Pokud true, tato úloha sestavení zkontroluje, zda jsou všechny soubory plně staženy.

retryDownloadCount - počet opakování
string. Výchozí hodnota: 4.

Počet opakování pokusu o stažení artefaktu sestavení, pokud se stahování nezdaří.

extractTars - Extrahování všech souborů uložených v archivech tar
boolean.

Nastavte na tuto hodnotu true , pokud chcete extrahovat všechny stažené soubory s příponou .tar . To je užitečné, protože pokud chcete zachovat oprávnění k souborům Unix, musíte soubory artefaktů zabalit do taru. Povolením této StoreAsTar možnosti v úloze Publikovat artefakty sestavení se artefakty automaticky uloží jako .tar soubory.

Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace naleznete v tématu Možnosti ovládacího prvku a běžné vlastnosti úloh.

Výstupní proměnné

Tato úloha definuje následující výstupní proměnné, které můžete využívat v podřízených krocích, úlohách a fázích.

BuildNumber
Ukládá číslo sestavení zdroje artefaktu sestavení.

Upozorňujeme, že tento vstup vrací Id sestavení kvůli zpětné kompatibilitě. Další informace naleznete v tématu proměnné.

Poznámky

Poznámka:

Tým Azure Pipelines doporučuje upgradovat z artefaktů sestavení na artefakty kanálu pro rychlejší výkon.

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasické sestavení, klasická verze
Běží na	Agent, DeploymentGroup
Požadavky	Žádné
možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
omezení příkazů	Jakýkoliv
nastavitelné proměnné	Jakýkoliv
Verze agenta	2.191.1 nebo vyšší
Kategorie úkolu	Užitnost