Sdílet prostřednictvím


DownloadPackage@1 – stažení úkolu balíčku v1

Tuto úlohu použijte ke stažení balíčku z kanálu správy balíčků v Azure Artifacts.

Syntax

# Download package v1
# Download a package from a package management feed in Azure Artifacts.
- task: DownloadPackage@1
  inputs:
    packageType: 'nuget' # 'maven' | 'npm' | 'nuget' | 'pypi' | 'upack' | 'cargo'. Required. Package Type. Default: nuget.
    feed: # string. Required. Feed. 
    #view: # string. View. 
    definition: # string. Required. Package. 
    version: # string. Required. Version. 
    downloadPath: '$(System.ArtifactsDirectory)' # string. Required. Destination directory. Default: $(System.ArtifactsDirectory).
  # Advanced
    #files: '**' # string. Optional. Use when packageType = maven || packageType = pypi || packageType = upack. Files. Default: **.
    #extract: true # boolean. Optional. Use when packageType = nuget || packageType = npm. Extract package contents. Default: true.
# Download package v1
# Download a package from a package management feed in Azure Artifacts.
- task: DownloadPackage@1
  inputs:
    packageType: 'nuget' # 'maven' | 'npm' | 'nuget' | 'pypi' | 'upack'. Required. Package Type. Default: nuget.
    feed: # string. Required. Feed. 
    #view: # string. View. 
    definition: # string. Required. Package. 
    version: # string. Required. Version. 
    downloadPath: '$(System.ArtifactsDirectory)' # string. Required. Destination directory. Default: $(System.ArtifactsDirectory).
  # Advanced
    #files: '**' # string. Optional. Use when packageType = maven || packageType = pypi || packageType = upack. Files. Default: **.
    #extract: true # boolean. Optional. Use when packageType = nuget || packageType = npm. Extract package contents. Default: true.

Vstupy

typ balíčku packageType -
string. Požadovaný. Povolené hodnoty: maven, npm, nuget, pypi (Python), upack (Universal), cargo. Výchozí hodnota: nuget.


typ balíčku packageType -
string. Požadovaný. Povolené hodnoty: maven, npm, nuget, pypi (Python), upack (Universal). Výchozí hodnota: nuget.


informačního kanálu
string. Požadovaný.

Pro informační kanály v oboru projektu je formát projectID/feedID. V následujících poznámkách se dozvíte, jak získat informační kanál nebo ID projektu, nebo se dozvíte, jak místo toho použít název projektu a informačního kanálu.


view - zobrazení
string.

Určuje zobrazení, které používá pouze verze povýšené na toto konkrétní zobrazení.


balíčku
string. Požadovaný.

Pokud balíček v seznamu nenajdete, můžete zadat ID balíčku, které najdete pomocí pokynů zde.


version - verze
string. Požadovaný.

Určuje verzi balíčku. Pomocí latest stáhněte nejnovější verzi balíčku za běhu. Pomocí * stáhněte nejnovější verzi balíčku při packageType = upack.


soubory
string. Volitelný. Používá se při packageType = maven || packageType = pypi || packageType = upack. Výchozí hodnota: **.

Určuje, které soubory se mají stáhnout pomocí vzorů porovnávání souborů .


extract - extrahovat obsah balíčku
boolean. Volitelný. Používá se při packageType = nuget || packageType = npm. Výchozí hodnota: true.

Extrahuje obsah balíčku a obsahuje archiv balíčku ve složce artefaktů.


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

Určuje cestu na počítači agenta, na kterém se balíček stáhne.


Možnosti řízení úkolů

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

Výstupní proměnné

Žádný.

Poznámky

Tuto úlohu použijte ke stažení balíčku z kanálu správy balíčků v Azure Artifacts nebo TFS.

Poznámka

Vyžadujerozšíření správy balíčků .

Jak najdu ID informačního kanálu (nebo projektu), ze kterého chci stáhnout artefakt

Rozhraní API pro získání informačního kanálu se dá použít k načtení informačního kanálu a ID projektu pro váš informační kanál. Rozhraní API je zdokumentované zde.

Můžu místo ID použít název projektu nebo informačního kanálu.

Ano, název projektu nebo informačního kanálu můžete použít ve své definici. Pokud se ale projekt nebo informační kanál v budoucnu přejmenuje, bude potřeba úkol aktualizovat nebo může selhat.

Příklady

Stažení balíčku NuGet z informačního kanálu v oboru organizace a extrakce do cílového adresáře

# Download an artifact with id 'cfe01b64-ded4-47b7-a569-2ac17cbcedbd' to $(System.ArtifactsDirectory)
- task: DownloadPackage@1
  inputs:
    packageType: 'nuget'
    feed: '6a60ef3b-e29f-41b6-9885-7874278baac7'
    definition: 'cfe01b64-ded4-47b7-a569-2ac17cbcedbd' # Can also be package name
    version: '1.0.0'
    extract: true
    downloadPath: '$(System.ArtifactsDirectory)'

Stažení balíčku Maven z informačního kanálu s oborem projektu a stažení pouze souborů pom

# Download an artifact with name 'com.test:testpackage' to $(System.ArtifactsDirectory)
- task: DownloadPackage@1
  inputs:
    packageType: 'maven'
    feed: '132f5c2c-2aa0-475a-8b47-02c79617954b/c85e5de9-7b12-4cfd-9293-1b33cdff540e' # <projectId>/<feedId>
    definition: 'com.test:testpackage' 
    version: '1.0.0-snapshot' # Should be normalized version
    files: '*.pom'
    downloadPath: '$(System.ArtifactsDirectory)'

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.144.0 nebo vyšší
Kategorie úkolu Užitek
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.115.0 nebo vyšší
Kategorie úkolu Užitek