DownloadPackage@1 – Ladda ned paket v1-uppgift

Artikel
10/31/2024

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.

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

Ingångar

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

packageType - pakettyp
string. Krävs. Tillåtna värden: maven, npm, nuget, pypi (Python), upack (Universal). 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

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.115.0 eller senare
Aktivitetskategori	Nytta

Dela via