DownloadPackage@1 – Aufgabe "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.

Eingänge

packageType - Pakettyp-
string. Erforderlich. Zulässige Werte: maven, npm, nuget, pypi (Python), upack (Universal), cargo. Standardwert: nuget.

feed - Feed-
string. Erforderlich.

Bei projektbezogenen Feeds ist das Format projectID/feedID. In den folgenden Anmerkungen erfahren Sie, wie Sie einen Feed oder eine Projekt-ID abrufen oder wie Sie stattdessen einen Projekt- und Feednamen verwenden.

view - Ansicht
string.

Gibt eine Ansicht an, die nur Versionen verwendet, die zu dieser bestimmten Ansicht heraufgestuft werden.

definition - -Paket-
string. Erforderlich.

Wenn Sie das Paket in der Liste nicht finden, können Sie die Paket-ID angeben, die Sie mit den Anweisungen hierfinden können.

version - Version
string. Erforderlich.

Gibt die Version des Pakets an. Verwenden Sie latest, um die neueste Version des Pakets zur Laufzeit herunterzuladen. Verwenden Sie *, um die neueste Version eines Pakets herunterzuladen, wenn packageType = upack.

files - Dateien
string. Wahlfrei. Wird verwendet, wenn packageType = maven || packageType = pypi || packageType = upack. Standardwert: **.

Gibt an, welche Dateien mit Dateiabgleichsmusternheruntergeladen werden sollen.

extract - Extrahieren von Paketinhalten
boolean. Wahlfrei. Wird verwendet, 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 Agentcomputer an, auf den das Paket heruntergeladen wird.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Nichts.

Bemerkungen

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

Anmerkung

Erfordert die Paketverwaltungserweiterung.

Wie finde ich die ID des Feeds (oder Projekts), aus 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 hierdokumentiert.

Kann ich anstelle von IDs den Projekt- oder Feednamen verwenden

Ja, Sie können den Projekt- oder Feednamen in Ihrer Definition verwenden. Wenn Ihr Projekt oder Feed jedoch in Zukunft umbenannt wird, muss der Vorgang ebenfalls aktualisiert werden, oder er schlägt fehl.

Beispiele

Herunterladen eines NuGet-Pakets aus einem vom Unternehmen bezogenen 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, Classic Build, Classic Release
Läuft auf	Agent, DeploymentGroup
Anforderungen	Nichts
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Jegliche
Settable-Variablen	Jegliche
Agentversion	2.144.0 oder höher
Vorgangskategorie	Nützlichkeit