DownloadPackage@1 – Ladda ned paket v1-uppgift

Använd den här uppgiften för att ladda ned ett paket från ett pakethanteringsflöde i 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.

Ingångar

packageType - pakettyp
string. Krävs. Tillåtna värden: maven, npm, nuget, pypi (Python), upack (Universal), cargo. Standardvärde: nuget.

feed - Feed
string. Krävs.

För feeds med projektomfattning är formatet projectID/feedID. Se följande kommentarer för att lära dig hur du hämtar ett feed- eller projekt-ID eller lär dig hur du använder ett projekt- och flödesnamn i stället.

view - Visa
string.

Anger en vy som endast använder versioner som har befordrats till den specifika vyn.

definition - Paket
string. Krävs.

Om du inte hittar paketet i listan kan du ange paket-ID:t, som du hittar med hjälp av anvisningarna här.

version - version
string. Krävs.

Anger versionen av paketet. Använd latest för att ladda ned den senaste versionen av paketet vid körning. Använd * för att ladda ned den senaste versionen av ett paket när packageType = upack.

files - Files
string. Valfri. Använd när packageType = maven || packageType = pypi || packageType = upack. Standardvärde: **.

Anger vilka filer som ska laddas ned med hjälp av filmatchningsmönster.

extract - Extrahera paketinnehåll
boolean. Valfri. Använd när packageType = nuget || packageType = npm. Standardvärde: true.

Extraherar paketinnehållet och innehåller paketarkivet i artefaktmappen.

downloadPath - Målkatalog
string. Krävs. Standardvärde: $(System.ArtifactsDirectory).

Anger sökvägen på agentdatorn där paketet laddas ned.

Alternativ för aktivitetskontroll

Alla aktiviteter har kontrollalternativ utöver sina uppgiftsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Ingen.

Anmärkningar

Använd den här uppgiften för att ladda ned ett paket från ett pakethanteringsflöde i Azure Artifacts eller TFS.

Not

Kräver Package Management-tillägget.

Hur hittar jag ID:t för feeden (eller projektet) som jag vill ladda ned min artefakt från

API:et för hämtningsflöde kan användas för att hämta feeden och projekt-ID:t för feeden. API:et dokumenteras här.

Kan jag använda projektet eller feednamnet i stället för ID:t

Ja, du kan använda projektet eller feednamnet i din definition. Men om projektet eller flödet byter namn i framtiden måste uppgiften också uppdateras, annars kan det misslyckas.

Exempel

Ladda ned ett NuGet-paket från ett flöde med organisationsomfattning och extrahera till målkatalogen

# 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)'

Ladda ned ett maven-paket från ett projektomfattningsflöde och ladda endast ned pom-filer

# 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)'

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent, DeploymentGroup
kräver	Ingen
funktioner	Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar	Någon
variabler som kan	Någon
Agentversion	2.144.0 eller senare
Aktivitetskategori	Nytta