Sdílet prostřednictvím


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

Pomocí této úlohy můžete stáhnout soubory, které byly uloženy jako artefakty dokončeného sestavení.

Pokud používáte Azure DevOps Services, pro zajištění vyššího výkonu doporučujeme použít možnost Stáhnout artefakty kanálu a Publikovat artefakty kanálu.

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.

Vstupy

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

Jestli chcete stáhnout artefakty vytvořené aktuálním sestavením, nebo z konkrétního sestavení.


project - Projektu
string. Vyžaduje se, když buildType == specific.

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


pipeline - Kanál sestavení
Alias vstupu: definition. string. Vyžaduje se, když buildType == specific.

Určuje název kanálu buildu.


specificBuildWithTriggering - V případě potřeby stáhněte artefakty z aktivačního sestavení.
boolean. Nepovinný parametr. Použijte, když buildType == specific. Výchozí hodnota: false.

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


buildVersionToDownload - Verze buildu ke stažení
string. Vyžaduje se, když buildType == specific. Povolené hodnoty: latest, latestFromBranch (Nejnovější z konkrétní větve a zadané značky buildu) specific (konkrétní verze). Výchozí hodnota: latest.

Určuje, která verze sestavení se má stáhnout.

  • Zvolte latest stažení nejnovější dostupné verze buildu.
  • Zvolte latestFromBranch stažení nejnovější dostupné verze buildu větve určené parametrem branchName a značky určené parametrem tags.
  • Zvolte specific stažení verze sestavení určené parametrem buildId.

allowPartiallySucceededBuilds - Stahujte artefakty i z částečně úspěšných sestavení.
boolean. Nepovinný parametr. Použijte, když buildType == specific && buildVersionToDownload != specific. Výchozí hodnota: false.

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


branchName - Název větve
string. Vyžaduje se, když 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 - Budovat
string. Vyžaduje se, když buildType == specific && buildVersionToDownload == specific.

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


tags - Značky sestavení
string. Nepovinný parametr. Použijte, když buildType == specific && buildVersionToDownload != specific.

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


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

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

  • Zvolte single (Konkrétní artefakt), pokud chcete zadat pouze jeden konkrétní artefakt artifactName
  • Zvolte specific (Konkrétní soubory), pokud chcete všechny artefakty vybraného sestavení.

artifactName - Název artefaktu
string. Vyžaduje se, když downloadType == single.

Název artefaktu, který se má stáhnout.


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

Určuje soubory, které se mají stáhnout, jako víceřádkový vzor minimatch. Další informace najdete v tématu Referenční informace ke vzorům porovnávání souborů.

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 rámci odstranění artefaktů, použijte drop/**.


downloadPath - Cílový adresář
string. Povinná hodnota. Výchozí hodnota: $(System.ArtifactsDirectory).

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


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

Před stažením artefaktů 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 trueje , tato úloha sestavení zkontroluje, jestli 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í v případě, že se stahování nezdaří.


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

Pokud chcete extrahovat všechny stažené soubory s příponou .tar, nastavte na true hodnotu . To je užitečné, protože pokud chcete zachovat oprávnění k souborům unixového souboru, musíte soubory artefaktů zabalit do tar. Povolením StoreAsTar možnosti v úloze Publikovat artefakty sestavení se artefakty budou automaticky ukládat jako soubory .tar .


Možnosti ovládání úloh

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

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 artefaktů sestavení.

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

Poznámky

Poznámka

Tým Azure Pipelines pro zajištění rychlejšího výkonu doporučuje upgrade z artefaktů sestavení na artefakty kanálu .

Požadavky

Požadavek Popis
Typy kanálů YAML, klasický build, 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ů Všechny
Nastavitelné proměnné Všechny
Verze agenta 2.191.1 nebo vyšší
Kategorie úloh Nástroj