DownloadPackage@1 - Télécharger la tâche de 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 - type de package
string. Obligatoire. Valeurs autorisées : maven, npm, nuget, pypi (Python), upack (universel), cargo. Valeur par défaut : nuget.

feed - de flux
string. Obligatoire.

Pour les flux délimités par le projet, le format est projectID/feedID. Consultez les remarques suivantes pour apprendre à obtenir un flux ou un ID de projet, ou à utiliser un nom de projet et de flux à la place.

vue view -
string.

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

definition - package
string. Obligatoire.

Si vous ne trouvez pas le package dans la liste, vous pouvez fournir l’ID du package, que vous pouvez trouver à l’aide des 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. Utilisez * pour télécharger la dernière version d’un package lorsque packageType = upack.

files - Fichiers
string. Optionnel. 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. Optionnel. 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 de l’agent sur lequel le package est téléchargé.

Options de contrôle de tâche

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

Variables de sortie

Aucun.

Remarques

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

Note

Nécessite l’extension Gestion des packages.

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

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é ultérieurement, votre tâche doit également être mise à jour, ou elle risque d’échouer.

Exemples

Télécharger un package NuGet à partir d’un flux d’étendue de l’organisation 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)'

Exigences

Exigence	Description
Types de pipelines	YAML, Build Classique, Version Classique
Exécutions sur	Agent, DeploymentGroup
demandes	Aucun
fonctionnalités de	Cette tâche ne répond à aucune demande de tâches ultérieures dans le travail.
restrictions de commande	Quelconque
variables settables	Quelconque
Version de l’agent	2.144.0 ou version ultérieure
Catégorie de tâche	Utilité