NuGetCommand@2 - Tâche NuGet v2

  • Article

Utilisez cette tâche pour restaurer, emballer ou envoyer (push) des packages NuGet, ou exécuter une commande NuGet. Cette tâche prend en charge les flux NuGet.org et authentifiés tels qu’Azure Artifacts et MyGet. Cette tâche utilise également NuGet.exe et fonctionne avec les applications .NET Framework. Pour les applications .NET Core et .NET Standard, utilisez la tâche .NET Core.

Syntax

# NuGet v2
# Restore, pack, or push NuGet packages, or run a NuGet command. Supports NuGet.org and authenticated feeds like Azure Artifacts and MyGet. Uses NuGet.exe and works with .NET Framework apps. For .NET Core and .NET Standard apps, use the .NET Core task.
- task: NuGetCommand@2
  inputs:
    command: 'restore' # 'restore' | 'pack' | 'push' | 'custom'. Required. Command. Default: restore.
    restoreSolution: '**/*.sln' # string. Alias: solution. Required when command = restore. Path to solution, packages.config, or project.json. Default: **/*.sln.
    #packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg' # string. Alias: searchPatternPush. Required when command = push. Path to NuGet package(s) to publish. Default: $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg.
    #nuGetFeedType: 'internal' # 'internal' | 'external'. Required when command = push. Target feed location. Default: internal.
    #publishVstsFeed: # string. Alias: feedPublish. Required when command = push && nuGetFeedType = internal. Target feed. 
    #allowPackageConflicts: false # boolean. Optional. Use when command = push && nuGetFeedType = internal. Allow duplicates to be skipped. Default: false.
    #publishFeedCredentials: # string. Alias: externalEndpoint. Required when command = push && nuGetFeedType = external. NuGet server. 
    #packagesToPack: '**/*.csproj' # string. Alias: searchPatternPack. Required when command = pack. Path to csproj or nuspec file(s) to pack. Default: **/*.csproj.
    #configuration: '$(BuildConfiguration)' # string. Alias: configurationToPack. Optional. Use when command = pack. Configuration to package. Default: $(BuildConfiguration).
    #packDestination: '$(Build.ArtifactStagingDirectory)' # string. Alias: outputDir. Optional. Use when command = pack. Package folder. Default: $(Build.ArtifactStagingDirectory).
    #arguments: # string. Required when command = custom. Command and arguments. 
  # Feeds and authentication
    feedsToUse: 'select' # 'select' | 'config'. Alias: selectOrConfig. Required when command = restore. Feeds to use. Default: select.
    #vstsFeed: # string. Alias: feedRestore. Optional. Use when selectOrConfig = select && command = restore. Use packages from this Azure Artifacts/TFS feed. 
    #includeNuGetOrg: true # boolean. Optional. Use when selectOrConfig = select && command = restore. Use packages from NuGet.org. Default: true.
    #nugetConfigPath: # string. Optional. Use when selectOrConfig = config && command = restore. Path to NuGet.config. 
    #externalFeedCredentials: # string. Alias: externalEndpoints. Optional. Use when selectOrConfig = config && command = restore. Credentials for feeds outside this organization/collection. 
  # Advanced
    #noCache: false # boolean. Optional. Use when command = restore. Disable local cache. Default: false.
    #disableParallelProcessing: false # boolean. Optional. Use when command = restore. Disable parallel processing. Default: false.
    #restoreDirectory: # string. Alias: packagesDirectory. Optional. Use when command = restore. Destination directory. 
    #verbosityRestore: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = restore. Verbosity. Default: Detailed.
  # Advanced
    #publishPackageMetadata: true # boolean. Optional. Use when command = push && nuGetFeedType = internal && command = push. Publish pipeline metadata. Default: true.
    #verbosityPush: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = push. Verbosity. Default: Detailed.
  # Pack options
    #versioningScheme: 'off' # 'off' | 'byPrereleaseNumber' | 'byEnvVar' | 'byBuildNumber'. Required when command = pack. Automatic package versioning. Default: off.
    #includeReferencedProjects: false # boolean. Optional. Use when versioningScheme = off && command = pack. Include referenced projects. Default: false.
    #versionEnvVar: # string. Required when versioningScheme = byEnvVar && command = pack. Environment variable. 
    #majorVersion: '1' # string. Alias: requestedMajorVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Major. Default: 1.
    #minorVersion: '0' # string. Alias: requestedMinorVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Minor. Default: 0.
    #patchVersion: '0' # string. Alias: requestedPatchVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Patch. Default: 0.
    #packTimezone: 'utc' # 'utc' | 'local'. Optional. Use when versioningScheme = byPrereleaseNumber && command = pack. Time zone. Default: utc.
    #includeSymbols: false # boolean. Optional. Use when command = pack. Create symbols package. Default: false.
    #toolPackage: false # boolean. Optional. Use when command = pack. Tool Package. Default: false.
  # Advanced
    #buildProperties: # string. Optional. Use when command = pack. Additional build properties. 
    #basePath: # string. Optional. Use when command = pack. Base path. 
    #verbosityPack: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = pack. Verbosity. Default: Detailed.

# NuGet v2
# Restore, pack, or push NuGet packages, or run a NuGet command. Supports NuGet.org and authenticated feeds like Package Management and MyGet. Uses NuGet.exe and works with .NET Framework apps. For .NET Core and .NET Standard apps, use the .NET Core task.
- task: NuGetCommand@2
  inputs:
    command: 'restore' # 'restore' | 'pack' | 'push' | 'custom'. Required. Command. Default: restore.
    restoreSolution: '**/*.sln' # string. Alias: solution. Required when command = restore. Path to solution, packages.config, or project.json. Default: **/*.sln.
    #packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg' # string. Alias: searchPatternPush. Required when command = push. Path to NuGet package(s) to publish. Default: $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg.
    #nuGetFeedType: 'internal' # 'internal' | 'external'. Required when command = push. Target feed location. Default: internal.
    #publishVstsFeed: # string. Alias: feedPublish. Required when command = push && nuGetFeedType = internal. Target feed. 
    #allowPackageConflicts: false # boolean. Optional. Use when command = push && nuGetFeedType = internal. Allow duplicates to be skipped. Default: false.
    #publishFeedCredentials: # string. Alias: externalEndpoint. Required when command = push && nuGetFeedType = external. NuGet server. 
    #packagesToPack: '**/*.csproj' # string. Alias: searchPatternPack. Required when command = pack. Path to csproj or nuspec file(s) to pack. Default: **/*.csproj.
    #configuration: '$(BuildConfiguration)' # string. Alias: configurationToPack. Optional. Use when command = pack. Configuration to package. Default: $(BuildConfiguration).
    #packDestination: '$(Build.ArtifactStagingDirectory)' # string. Alias: outputDir. Optional. Use when command = pack. Package folder. Default: $(Build.ArtifactStagingDirectory).
    #arguments: # string. Required when command = custom. Command and arguments. 
  # Feeds and authentication
    feedsToUse: 'select' # 'select' | 'config'. Alias: selectOrConfig. Required when command = restore. Feeds to use. Default: select.
    #vstsFeed: # string. Alias: feedRestore. Optional. Use when selectOrConfig = select && command = restore. Use packages from this Azure Artifacts/TFS feed. 
    #includeNuGetOrg: true # boolean. Optional. Use when selectOrConfig = select && command = restore. Use packages from NuGet.org. Default: true.
    #nugetConfigPath: # string. Optional. Use when selectOrConfig = config && command = restore. Path to NuGet.config. 
    #externalFeedCredentials: # string. Alias: externalEndpoints. Optional. Use when selectOrConfig = config && command = restore. Credentials for feeds outside this account/collection. 
  # Advanced
    #noCache: false # boolean. Optional. Use when command = restore. Disable local cache. Default: false.
    #disableParallelProcessing: false # boolean. Optional. Use when command = restore. Disable parallel processing. Default: false.
    #restoreDirectory: # string. Alias: packagesDirectory. Optional. Use when command = restore. Destination directory. 
    #verbosityRestore: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = restore. Verbosity. Default: Detailed.
  # Advanced
    #verbosityPush: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = push. Verbosity. Default: Detailed.
  # Pack options
    #versioningScheme: 'off' # 'off' | 'byPrereleaseNumber' | 'byEnvVar' | 'byBuildNumber'. Required when command = pack. Automatic package versioning. Default: off.
    #includeReferencedProjects: false # boolean. Optional. Use when versioningScheme = off && command = pack. Include referenced projects. Default: false.
    #versionEnvVar: # string. Required when versioningScheme = byEnvVar && command = pack. Environment variable. 
    #majorVersion: '1' # string. Alias: requestedMajorVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Major. Default: 1.
    #minorVersion: '0' # string. Alias: requestedMinorVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Minor. Default: 0.
    #patchVersion: '0' # string. Alias: requestedPatchVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Patch. Default: 0.
    #packTimezone: 'utc' # 'utc' | 'local'. Optional. Use when versioningScheme = byPrereleaseNumber && command = pack. Time zone. Default: utc.
    #includeSymbols: false # boolean. Optional. Use when command = pack. Create symbols package. Default: false.
    #toolPackage: false # boolean. Optional. Use when command = pack. Tool Package. Default: false.
  # Advanced
    #buildProperties: # string. Optional. Use when command = pack. Additional build properties. 
    #basePath: # string. Optional. Use when command = pack. Base path. 
    #verbosityPack: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = pack. Verbosity. Default: Detailed.

Entrées

command - Commande
string. Obligatoire. Valeurs autorisées : restore, pack, push, custom. Valeur par défaut : restore.

Spécifie la commande NuGet à exécuter. Utilisez la custom valeur pour ajouter des arguments ou pour utiliser une autre commande.


restoreSolution - Chemin d’accès à la solution, packages.config ou project.json
Alias d’entrée : solution. string. Nécessaire lorsque command = restore. Valeur par défaut : **/*.sln.

Spécifie le chemin d’accès à la solution, packages.configou project.json au fichier qui fait référence aux packages à restaurer.


feedsToUse - Flux à utiliser
Alias d’entrée : selectOrConfig. string. Nécessaire lorsque command = restore. Valeurs autorisées : select (Flux que je sélectionne ici), config (Flux dans mon NuGet.config). Valeur par défaut : select.

Spécifie un flux à partir d’Azure Artifacts et/ou NuGet.org que la tâche doit utiliser avec la select valeur. Vous pouvez également valider un NuGet.config fichier dans votre référentiel de code source et définir son chemin comme valeur à l’aide de la config valeur .


vstsFeed - Utiliser des packages de ce flux Azure Artifacts/TFS
Alias d’entrée : feedRestore. string. facultatif. Utilisez quand selectOrConfig = select && command = restore.

Spécifie le flux sélectionné dans le généré NuGet.config. Vous devez avoir installé La gestion des packages et disposer d’une licence pour spécifier un flux ici.


includeNuGetOrg - Utiliser des packages de NuGet.org
boolean. facultatif. Utilisez quand selectOrConfig = select && command = restore. Valeur par défaut : true.

Inclut NuGet.org dans le généré NuGet.config.


nugetConfigPath - Chemin d’accès à NuGet.config
string. facultatif. Utilisez quand selectOrConfig = config && command = restore.

Spécifie le chemin d’accès au NuGet.config dans votre dépôt qui détermine les flux à partir desquels restaurer les packages.


externalFeedCredentials - Informations d’identification pour les flux en dehors de cette organization/collection
Alias d’entrée : externalEndpoints. string. facultatif. Utilisez quand selectOrConfig = config && command = restore.

Spécifie les informations d’identification à utiliser pour les registres externes situés dans le sélectionné NuGet.config. Il s’agit du nom de votre connexion de service NuGet. Pour les flux de cette organization ou de cette collection, laissez ce champ vide ; les informations d’identification de la build sont utilisées automatiquement.


externalFeedCredentials - Informations d’identification pour les flux en dehors de ce compte/collection
Alias d’entrée : externalEndpoints. string. facultatif. Utilisez quand selectOrConfig = config && command = restore.

Spécifie les informations d’identification à utiliser pour les registres externes situés dans le sélectionné NuGet.config. Il s’agit du nom de votre connexion de service NuGet. Pour les flux de ce compte ou de cette collection, laissez ce champ vide ; les informations d’identification de la build sont utilisées automatiquement.


noCache - Désactiver le cache local
boolean. facultatif. Utilisez quand command = restore. Valeur par défaut : false.

Empêche NuGet d’utiliser des packages provenant de caches d’ordinateurs locaux lorsqu’il trueest défini sur .


disableParallelProcessing - Désactiver le traitement parallèle
boolean. facultatif. Utilisez quand command = restore. Valeur par défaut : false.

Empêche NuGet d’installer plusieurs packages dans des processus parallèles lorsqu’il est défini sur true.


restoreDirectory - Répertoire de destination
Alias d’entrée : packagesDirectory. string. facultatif. Utilisez quand command = restore.

Spécifie le dossier dans lequel les packages sont installés. Si aucun dossier n’est spécifié, les packages sont restaurés dans un packages/ dossier en même temps que la solution sélectionnée, packages.configou project.json.


verbosityRestore - Verbosité
string. facultatif. Utilisez quand command = restore. Valeurs autorisées : Quiet, Normal, Detailed. Valeur par défaut : Detailed.

Spécifie le niveau de détail affiché dans la sortie.


packagesToPush - Chemin d’accès au ou aux packages NuGet à publier
Alias d’entrée : searchPatternPush. string. Nécessaire lorsque command = push. Valeur par défaut : $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg.

Spécifie le modèle à mettre en correspondance ou le chemin d’accès aux nupkg fichiers à charger. Plusieurs modèles peuvent être séparés par un point-virgule.


nuGetFeedType - Emplacement du flux cible
string. Nécessaire lorsque command = push. Valeurs autorisées : internal (cette organization/collection), external (serveur NuGet externe (y compris d’autres comptes/collections)). Valeur par défaut : internal.

Spécifie si le flux cible est un flux/une collection interne ou un serveur NuGet externe.


nuGetFeedType - Emplacement du flux cible
string. Nécessaire lorsque command = push. Valeurs autorisées : internal (ce compte/collection), external (serveur NuGet externe (y compris d’autres comptes/collections)). Valeur par défaut : internal.

Spécifie si le flux cible est un flux/une collection interne ou un serveur NuGet externe.


publishVstsFeed - Flux cible
Alias d’entrée : feedPublish. string. Nécessaire lorsque command = push && nuGetFeedType = internal.

Spécifie un flux hébergé dans ce compte. Vous devez avoir Azure Artifacts installé et avec une licence pour sélectionner un flux ici.


publishPackageMetadata - Publier des métadonnées de pipeline
boolean. facultatif. Utilisez quand command = push && nuGetFeedType = internal && command = push. Valeur par défaut : true.

Modifie le numéro de version du sous-ensemble de packages modifiés dans un ensemble de packages publiés en continu.


allowPackageConflicts - Autoriser l’ignorer des doublons
boolean. facultatif. Utilisez quand command = push && nuGetFeedType = internal. Valeur par défaut : false.

Signale la réussite de la tâche même si certains de vos packages sont rejetés avec des erreurs de conflit 409.

Cette option est actuellement disponible uniquement sur Azure Pipelines et les agents Windows. Si NuGet.exe un conflit se produit, la tâche échoue. Cette option ne fonctionnera pas et la publication échouera si vous êtes dans un environnement proxy.


publishFeedCredentials - Serveur NuGet
Alias d’entrée : externalEndpoint. string. Nécessaire lorsque command = push && nuGetFeedType = external.

Spécifie la connexion de service NuGet qui contient les informations d’identification du serveur NuGet externe.


verbosityPush - Verbosité
string. facultatif. Utilisez quand command = push. Valeurs autorisées : Quiet, Normal, Detailed. Valeur par défaut : Detailed.

Spécifie le niveau de détail affiché dans la sortie.


packagesToPack - Chemin d’accès aux fichiers csproj ou nuspec à pack
Alias d’entrée : searchPatternPack. string. Nécessaire lorsque command = pack. Valeur par défaut : **/*.csproj.

Spécifie le modèle que la tâche utilise pour rechercher les répertoires csproj à emballer.

Vous pouvez séparer plusieurs modèles avec un point-virgule, et vous pouvez faire un modèle négatif en le préfixant avec !. Exemple : **\*.csproj;!**\*.Tests.csproj.


configuration - Configuration à empaqueter
Alias d’entrée : configurationToPack. string. facultatif. Utilisez quand command = pack. Valeur par défaut : $(BuildConfiguration).

Spécifie la configuration à empaqueter lors de l’utilisation d’un fichier csproj.


packDestination - Dossier de package
Alias d’entrée : outputDir. string. facultatif. Utilisez quand command = pack. Valeur par défaut : $(Build.ArtifactStagingDirectory).

Spécifie le dossier dans lequel la tâche crée des packages. Si la valeur est vide, la tâche crée des packages à la racine source.


versioningScheme - Contrôle de version automatique des packages
string. Nécessaire lorsque command = pack. Valeurs autorisées : off, byPrereleaseNumber (Utilisez la date et l’heure), byEnvVar (Utiliser une variable d’environnement) byBuildNumber (Utilisez le numéro de build). Valeur par défaut : off.

Applique le contrôle de version automatique du package en fonction de la valeur spécifiée. Cette chaîne ne peut pas être utilisée avec includeReferencedProjects. Les valeurs autorisées sont les suivantes :

  • byPrereleaseNumber - Utilisez la date et l’heure : la tâche génère une version conforme SemVer au X.Y.Z-ci-datetimeformat , où vous spécifiez les valeurs de X, Y et Z.
  • byEnvVar- Utiliser une variable d’environnement : la tâche utilise une variable d’environnement que vous spécifiez et contient le numéro de version que vous souhaitez utiliser.
  • byBuildNumber - Utiliser le numéro de build : la tâche utilise le numéro de build pour versionner le package.

Notes

Sous Général, définissez le format de build sur $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r).


includeReferencedProjects - Inclure les projets référencés
boolean. facultatif. Utilisez quand versioningScheme = off && command = pack. Valeur par défaut : false.

Inclut les projets référencés en tant que dépendances ou dans le cadre du package. Ne peut pas être utilisé avec le contrôle de version automatique des packages. Si un projet référencé a un fichier correspondant nuspec portant le même nom que le projet, ce projet référencé est ajouté en tant que dépendance. Sinon, le projet référencé est ajouté dans le cadre du package. En savoir plus sur l’utilisation de la commande pack pour l’interface CLI NuGet pour créer des packages NuGet.


versionEnvVar - Variable d’environnement
string. Nécessaire lorsque versioningScheme = byEnvVar && command = pack.

Spécifie le nom de la variable sans $, $envou %.


majorVersion - Majeur
Alias d’entrée : requestedMajorVersion. string. Nécessaire lorsque versioningScheme = byPrereleaseNumber && command = pack. Valeur par défaut : 1.

dans la X version X.Y.Z.


minorVersion - Mineur
Alias d’entrée : requestedMinorVersion. string. Nécessaire lorsque versioningScheme = byPrereleaseNumber && command = pack. Valeur par défaut : 0.

dans la Y version X.Y.Z.


patchVersion - Patch
Alias d’entrée : requestedPatchVersion. string. Nécessaire lorsque versioningScheme = byPrereleaseNumber && command = pack. Valeur par défaut : 0.

dans la Z version X.Y.Z.


packTimezone - Fuseau horaire
string. facultatif. Utilisez quand versioningScheme = byPrereleaseNumber && command = pack. Valeurs autorisées : utc, local (heure locale de l’agent). Valeur par défaut : utc.

Spécifie le fuseau horaire souhaité utilisé pour produire la version du package. Il est recommandé de sélectionner utc si vous utilisez des agents de build hébergés, car leur date et leur heure peuvent différer.


includeSymbols - Créer un package de symboles
boolean. facultatif. Utilisez quand command = pack. Valeur par défaut : false.

Spécifie que le package contient des sources et des symboles. Lorsqu’il est utilisé avec un .nuspec fichier, cela crée un fichier de package NuGet standard et le package de symboles correspondant.


toolPackage - Package d’outils
boolean. facultatif. Utilisez quand command = pack. Valeur par défaut : false.

Détermine si les fichiers de sortie du projet doivent se trouver dans le dossier de l’outil.


buildProperties - Propriétés de build supplémentaires
string. facultatif. Utilisez quand command = pack.

Spécifie une liste de paires token=value, séparées par des points-virgules, où chaque occurrence de $token$ dans le .nuspec fichier sera remplacée par la valeur donnée. Les valeurs peuvent être des chaînes entre des guillemets.


basePath - Chemin d’accès de base
string. facultatif. Utilisez quand command = pack.

Spécifie le chemin d’accès de base des fichiers définis dans le nuspec fichier.


verbosityPack - Verbosité
string. facultatif. Utilisez quand command = pack. Valeurs autorisées : Quiet, Normal, Detailed. Valeur par défaut : Detailed.

Spécifie le niveau de détail affiché dans la sortie.


arguments - Commande et arguments
string. Nécessaire lorsque command = custom.

Spécifie la commande et les arguments qui seront passés à NuGet.exe pour exécution. Si NuGet 3.5 ou version ultérieure est utilisé, les commandes authentifiées telles que list, restoreet publish par rapport à tout flux de ce organization ou collection auquel le service de génération de collection de projets a accès sont automatiquement authentifiées.


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

Important

La tâche Authentification NuGet est la nouvelle méthode recommandée pour s’authentifier auprès d’Azure Artifacts et d’autres dépôts NuGet. Cette tâche ne prend plus de nouvelles fonctionnalités et seuls les bogues critiques sont résolus.

Utilisez cette tâche pour installer et mettre à jour les dépendances de package NuGet, ou pour empaqueter et publier des packages NuGet. Utilise NuGet.exe et fonctionne avec les applications .NET Framework. Pour les applications .NET Core et .NET Standard, utilisez la tâche .NET Core.

Si votre code dépend de packages NuGet, veillez à ajouter cette étape avant votre tâche de génération Visual Studio. Veillez également à décocher la case à cocher Restaurer les packages NuGet déconseillée dans cette tâche.

Si vous utilisez .NET Core ou .NET Standard, utilisez la tâche .NET Core , qui prend entièrement en charge tous les scénarios de package et est actuellement prise en charge par dotnet.

Conseil

Cette version de la tâche NuGet utilise NuGet 4.1.0 par défaut. Pour sélectionner une autre version de NuGet, utilisez le Programme d’installation des outils.

Schémas de contrôle de version

Pour byPrereleaseNumber, la version est définie sur les valeurs que vous choisissez pour la version principale, la version mineure et le correctif, plus la date et l’heure, au format yyyymmdd-hhmmss.

Pour byEnvVar, la version est définie sur la valeur de la variable d’environnement qui a le nom spécifié par le paramètre versionEnvVar, par exemple MyVersion (pas $, seulement le nom de la variable d’environnement). Vérifiez que la variable d’environnement est définie sur un SemVer approprié, tel que 1.2.3 ou 1.2.3-beta1.

Pour byBuildNumber, la version est définie en utilisant le numéro de build de l’exécution du pipeline. C’est la valeur spécifiée pour la propriété name du pipeline, qui est enregistrée dans la variable d’environnement BUILD_BUILDNUMBER). Vérifiez que le numéro de build utilisé contient un SemVer approprié, tel que 1.0.$(Rev:r). Lors de l’utilisation de byBuildNumber, la tâche extrait la version en pointillés, 1.2.3.4, de la chaîne de numéro de build, et utilise uniquement cette partie. Le reste de la chaîne sera supprimé. Si vous voulez utiliser le numéro de build tel quel, vous pouvez utiliser byEnvVar comme décrit ci-dessus et définir versionEnvVar sur BUILD_BUILDNUMBER.

Migrer à partir de NuGetInstaller@0 ou de NuGetRestore@1

NuGetInstaller@0 et NuGetRestore@1 sont déconseillés, et vous devez les remplacer dans votre pipeline par NuGetCommand@2.

Si vous utilisez NuGetInstaller@0 avec restoreMode: restore, configurez les entrées suivantes lors de l’utilisation de NuGetCommand@2.

NuGetCommand@2 entrée de tâche Valeur
command restore
restoreSolution Chemin d’accès au fichier .sln

Si vous utilisez NuGetInstaller@0 avec restoreMode: install, configurez les entrées suivantes lors de l’utilisation de NuGetCommand@2.

NuGetCommand@2 entrée de tâche Valeur
command custom
arguments À quoi ressemblerait la commande d’installation complète dans l’interface CLI NuGet. Par exemple, si vous souhaitez exécuter l’équivalent de nuget install ninject -OutputDirectory c:\proj dans votre pipeline, le arguments paramètre est install ninject -OutputDirectory c:\proj. Si vous utilisiez le NuGetInstaller@0nuGetRestoreArgs paramètre , ceux-ci sont également maintenant dans arguments.

Si vous utilisez NuGetRestore@1, configurez les entrées suivantes lors de l’utilisation de NuGetCommand@2.

NuGetCommand@2 entrée de tâche Valeur
command restore
restoreSolution Chemin d’accès au fichier .sln

À l’instar de l’utilisation NuGetRestore@1 de ou de l’optionrestoreNuGetInstaller@0, NuGetCommand@2 a des entrées pour définir le flux, choisir entre select ou config, spécifier le chemin d’accès au NuGet.config fichier et utiliser des packages de nuget.org.

Pour plus d’informations, consultez les exemples suivants.

Exemples

Restaurer

Restaurez toutes vos solutions avec des packages provenant d’un flux sélectionné.

# Restore from a project scoped feed in the same organization
- task: NuGetCommand@2
  inputs:
    command: 'restore'
    feedsToUse: 'select'
    vstsFeed: 'my-project/my-project-scoped-feed'
    includeNuGetOrg: false
    restoreSolution: '**/*.sln'

# Restore from an organization scoped feed in the same organization
- task: NuGetCommand@2
  inputs:
    command: 'restore'
    feedsToUse: 'select'
    vstsFeed: 'my-organization-scoped-feed'
    restoreSolution: '**/*.sln'

# Restore from a feed in a different organization
- task: NuGetCommand@2
  inputs:
    command: 'restore'
    feedsToUse: config
    nugetConfigPath: ./nuget.config
    restoreSolution: '**/*.sln'
    externalFeedCredentials: 'MyServiceConnectionName'
    noCache: true
  continueOnError: true

# Restore from feed(s) set in nuget.config
- task: NuGetCommand@2
  inputs:
    command: 'restore'
    feedsToUse: 'config'
    nugetConfigPath: 'nuget.config'

Package

Créez un package NuGet dans le dossier de destination.

# Package a project
- task: NuGetCommand@2
  inputs:
    command: 'pack'
    packagesToPack: '**/*.csproj'
    packDestination: '$(Build.ArtifactStagingDirectory)'

Envoi (push)

Notes

Les artefacts de pipeline sont téléchargés dans le répertoire Pipeline.Workspace, et dans le répertoire System.ArtifactsDirectory pour les pipelines de mise en production classiques. La valeur de packagesToPush peut être définie sur $(Pipeline.Workspace)/**/*.nupkg ou $(System.ArtifactsDirectory)/**/*.nupkg, respectivement.

  • Envoyez/publiez un package sur un flux défini dans votre NuGet.config.

    # Push a project
- task: NuGetCommand@2
  inputs:
    command: 'push'
    packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg'
    feedsToUse: 'config'
    nugetConfigPath: '$(Build.WorkingDirectory)/NuGet.config'

  • Envoyer/publier un package sur un flux délimité à une organisation

    # Push a project
- task: NuGetCommand@2
  inputs:
    command: 'push'
    nuGetFeedType: 'internal'
    publishVstsFeed: 'my-organization-scoped-feed'

  • Envoyer/publier un package sur un flux délimité à un projet

    # Push a project
- task: NuGetCommand@2
  inputs:
    command: 'push'
    nuGetFeedType: 'internal'
    publishVstsFeed: 'my-project/my-project-scoped-feed'

  • Envoyer/publier un package sur NuGet.org

    # Push a project
- task: NuGetCommand@2
  inputs:
    command: 'push'
    feedsToUse: 'config'
    includeNugetOrg: 'true'

Custom

Exécutez n’importe quelle autre commande NuGet en plus des commandes par défaut : pack, push et restore.

# list local NuGet resources.
- task: NuGetCommand@2
  displayName: 'list locals'
  inputs:
    command: custom
    arguments: 'locals all -list'

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 Paquet
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.115.0 ou version ultérieure
Catégorie de la tâche Paquet