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