DownloadPackage@1 : Task "Paket v1" herunterladen

Verwenden Sie diese Aufgabe, um ein Paket aus einem Paketverwaltungsfeed in Azure Artifacts herunterzuladen.

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.

Eingaben

packageType - Pakettyp
string. Erforderlich. Zulässige Werte: , , , (Python), upack (Universell), cargo. pypinugetnpmmaven Standardwert. nuget.

feed - Feed
string. Erforderlich.

Für projektbezogene Feeds ist projectID/feedIDdas Format . In den folgenden Anmerkungen erfahren Sie, wie Sie einen Feed oder eine Projekt-ID abrufen, oder wie Sie stattdessen ein Projekt und einen Feednamen verwenden.

view - Ansehen
string.

Gibt eine Ansicht an, die nur Versionen verwendet, die auf diese bestimmte Ansicht höhergestuft werden.

definition - Paket
string. Erforderlich.

Wenn Sie das Paket nicht in der Liste finden, können Sie die Paket-ID angeben, die Sie mithilfe der anweisungen hier finden können.

version - Version
string. Erforderlich.

Gibt die Version des Pakets an. Verwenden Sie latest , um die neueste Version des Pakets zur Laufzeit herunterzuladen.

files - Dateien
string. Optional. Verwenden Sie , wenn packageType = maven || packageType = pypi || packageType = upack. Standardwert. **.

Gibt mithilfe von Dateiabgleichsmustern an, welche Dateien heruntergeladen werden sollen.

extract - Paketinhalt extrahieren
boolean. Optional. Verwenden Sie , wenn packageType = nuget || packageType = npm. Standardwert. true.

Extrahiert den Paketinhalt und enthält das Paketarchiv im Artefaktordner.

downloadPath - Zielverzeichnis
string. Erforderlich. Standardwert. $(System.ArtifactsDirectory).

Gibt den Pfad auf dem Agent-Computer an, auf dem das Paket heruntergeladen wird.

Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Bemerkungen

Verwenden Sie diese Aufgabe, um ein Paket aus einem Paketverwaltungsfeed in Azure Artifacts oder TFS herunterzuladen.

Hinweis

Erfordert die Paketverwaltungserweiterung.

Gewusst wie die ID des Feeds (oder Projekts) finden, von dem ich mein Artefakt herunterladen möchte

Die Get-Feed-API kann verwendet werden, um den Feed und die Projekt-ID für Ihren Feed abzurufen. Die API ist hier dokumentiert.

Kann ich den Projekt- oder Feednamen anstelle von IDs verwenden?

Ja, Sie können den Projekt- oder Feednamen in Ihrer Definition verwenden. Wenn Ihr Projekt oder Feed jedoch in Zukunft umbenannt wird, muss Auch Ihre Aufgabe aktualisiert werden, sonst schlägt sie fehl.

Beispiele

Herunterladen eines NuGet-Pakets aus einem organization Feed und Extrahieren in das Zielverzeichnis

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

Laden Sie ein Maven-Paket aus einem projektbezogenen Feed herunter, und laden Sie nur pom-Dateien herunter.

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

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Klassischer Build, klassische Version
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Keine
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Any
Einstellbare Variablen	Any
Agent-Version	2.144.0 oder höher
Aufgabenkategorie	Hilfsprogramm