DownloadPipelineArtifact@1 – Stažení úlohy artefaktu kanálu v1

Pomocí této úlohy můžete stáhnout artefakty kanálu z dřívějších fází tohoto kanálu nebo z jiného kanálu.

Existuje novější verze této úlohy. Další informace najdete v tématu DownloadPipelineArtifact@2.

Poznámka

Další informace, včetně příkazů Azure CLI, najdete v tématu o stahování artefaktů.

Syntax

# Download Pipeline Artifacts v1
# Download a named artifact from a pipeline to a local path.
- task: DownloadPipelineArtifact@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.
    #branchName: 'refs/heads/master' # string. Required when buildType == specific && buildVersionToDownload == latestFromBranch. Branch name. Default: refs/heads/master.
    #pipelineId: # string. Alias: buildId. Required when buildType == specific && buildVersionToDownload == specific. Build. 
    #tags: # string. Optional. Use when buildType == specific && buildVersionToDownload != specific. Build Tags. 
    #artifactName: # string. Artifact name. 
    #itemPattern: '**' # string. Matching pattern. Default: **.
    targetPath: '$(System.ArtifactsDirectory)' # string. Alias: downloadPath. Required. Destination directory. Default: $(System.ArtifactsDirectory).

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.

Stahuje artefakty vytvořené aktuálním spuštěním kanálu nebo z konkrétního spuštění kanálu.

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

Určuje název projektu nebo identifikátor GUID, ze kterého se mají stáhnout artefakty kanálu.

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

ID definice kanálu. Ve spuštěném kanálu definitionId najdete proměnnou System.DefinitionId . Můžete definitionId také načíst z adresy URL na stránce přehledu kanálu na portálu Azure DevOps. V následujícím příkladu definitionId adresy URL je hodnota 78: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. Pokud chcete stáhnout artefakty z konkrétní definice kanálu, zachyťte ho definitionId z daného kanálu a zadejte ho pipeline jako parametr .

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 je tato políčko zaškrtnuté, úloha stáhne artefakty z aktivačního sestavení. Pokud ze zadaného kanálu neaktivuje žádné sestavení, úloha 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 verzi buildu, která se má stáhnout.

branchName - Název větve
string. Vyžaduje se, když buildType == specific && buildVersionToDownload == latestFromBranch. Výchozí hodnota: refs/heads/master.

Určuje filtr pro název větve nebo odkazu. Příklad: refs/heads/develop.

pipelineId - Budovat
Alias vstupu: buildId. string. Vyžaduje se, když buildType == specific && buildVersionToDownload == specific.

Identifikátor spuštění kanálu, ze kterého se mají stáhnout artefakty. Ve spuštěném kanálu buildId najdete proměnnou Build.BuildId . Můžete buildId také načíst z adresy URL na stránce souhrnu spuštění kanálu na portálu Azure DevOps. V následujícím příkladu buildId adresy URL je 1088: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. Pokud chcete stáhnout artefakty z konkrétního spuštění kanálu, zachyťte ho buildId z daného spuštění a zadejte ho buildId jako parametr .

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

Seznam značek oddělených čárkami, které úloha používá k vrácení označených sestavení. Neoznačené sestavení se nevrátí.

artifactName - Název artefaktu
string.

Určuje název artefaktu, který se má stáhnout. Pokud je hodnota prázdná, úloha stáhne všechny artefakty přidružené ke spuštění kanálu.

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

Vzory porovnávání souborů, které omezují stažené soubory. Hodnotou může být jeden nebo více vzorů porovnávání souborů, které jsou oddělené novými řádky. Přečtěte si další informace o vzorech porovnávání souborů.

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

Cesta na počítači agenta, kam se artefakty stáhnou.

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é

Žádné

Poznámky

Existuje novější verze této úlohy. Další informace najdete v tématu DownloadPipelineArtifact@2.

Důležité

Tato úloha je podporována pouze v Azure DevOps Services. Pokud ho použijete na Azure DevOps Server, zobrazí se Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead. chybová zpráva podobná této: Pokud používáte Azure DevOps Server nebo TFS 2018, zobrazí se vám chybová zpráva, která se podobá použití stažení artefaktů sestavení.

Ve výchozím nastavení se artefakty stahují do .$(Pipeline.Workspace) Pokud nezadáte název artefaktu, vytvoří se pro každý stažený artefakt podadresář. Soubory, které chcete stáhnout, můžete omezit pomocí vzorů porovnávání souborů .

Jak najdu ID kanálu, ze kterého chci stáhnout artefakt?

Vyhledání ID definice pro konkrétní definici kanálu

Ve spuštěném kanálu najdete proměnnou definitionIdSystem.DefinitionId . Můžete definitionId také načíst z adresy URL na stránce přehledu kanálu na portálu Azure DevOps. V následujícím příkladu definitionId adresy URL je hodnota 78: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. Pokud chcete stáhnout artefakty z konkrétní definice kanálu, zachyťte ho definitionId z daného kanálu a zadejte ho pipeline jako parametr .

Zjištění ID sestavení pro konkrétní spuštění kanálu

Identifikátor spuštění kanálu, ze kterého se mají stáhnout artefakty. Ve spuštěném kanálu buildId najdete proměnnou Build.BuildId . Můžete buildId také načíst z adresy URL na stránce souhrnu spuštění kanálu na portálu Azure DevOps. V následujícím příkladu buildId adresy URL je 1088: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. Pokud chcete stáhnout artefakty z konkrétního spuštění kanálu, zachyťte ho buildId z daného spuštění a zadejte ho buildId jako parametr .

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.155.1 nebo vyšší
Kategorie úloh	Nástroj