DownloadPackage@1 - Tâche télécharger le package v1

Utilisez cette tâche pour télécharger un package à partir d’un flux de gestion de package dans Azure Artifacts.

Syntaxe

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

Entrées

packageType - Package Type
string. Obligatoire. Valeurs autorisées : maven, npm, pypinuget(Python), upack (Universel), cargo. Valeur par défaut : nuget.

feed - Nourrir
string. Obligatoire.

Pour les flux étendus au projet, le format est projectID/feedID. Consultez les remarques suivantes pour savoir comment obtenir un flux ou un ID de projet, ou comment utiliser un projet et un nom de flux à la place.

view - Vue
string.

Spécifie une vue qui utilise uniquement les versions promues vers cette vue spécifique.

definition - Paquet
string. Obligatoire.

Si vous ne trouvez pas le package dans la liste, vous pouvez fournir l’ID du package, que vous pouvez trouver en suivant les instructions ici.

version - Version
string. Obligatoire.

Spécifie la version du package. Utilisez latest pour télécharger la dernière version du package au moment de l’exécution.

files - Fichiers
string. facultatif. Utilisez quand packageType = maven || packageType = pypi || packageType = upack. Valeur par défaut : **.

Spécifie les fichiers à télécharger à l’aide de modèles de correspondance de fichiers.

extract - Extraire le contenu du package
boolean. facultatif. Utilisez quand packageType = nuget || packageType = npm. Valeur par défaut : true.

Extrait le contenu du package et contient l’archive du package dans le dossier d’artefacts.

downloadPath - Répertoire de destination
string. Obligatoire. Valeur par défaut : $(System.ArtifactsDirectory).

Spécifie le chemin d’accès sur l’ordinateur agent où le package est téléchargé.

Options de contrôle de la tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Notes

Utilisez cette tâche pour télécharger un package à partir d’un flux de gestion de package dans Azure Artifacts ou TFS.

Notes

Nécessite l’extension Gestion des packages.

Comment faire trouver l’ID du flux (ou du projet) à partir duquel je souhaite télécharger mon artefact

L’API get feed peut être utilisée pour récupérer le flux et l’ID de projet de votre flux. L’API est documentée ici.

Puis-je utiliser le nom du projet ou du flux au lieu des ID ?

Oui, vous pouvez utiliser le nom du projet ou du flux dans votre définition. Toutefois, si votre projet ou flux est renommé à l’avenir, votre tâche devra également être mise à jour, sinon elle peut échouer.

Exemples

Télécharger un package NuGet à partir d’un flux d’étendue organization et extraire vers le répertoire de destination

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

Télécharger un package maven à partir d’un flux étendu au projet et télécharger uniquement les fichiers 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)'

Configuration requise

Condition requise	Description
Types de pipelines	YAML, build classique, version classique
S’exécute sur	Agent, DeploymentGroup
Demandes	None
Capabilities	Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commande	Quelconque
Variables paramétrables	Quelconque
Version de l’agent	2.144.0 ou version ultérieure
Catégorie de la tâche	Utilitaire