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

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.

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

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).
# Download Pipeline Artifacts v1
# Download Pipeline Artifact.
- 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
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.150.3 nebo vyšší
Kategorie úloh Nástroj