DotNetCoreCLI@2 - Tâche .NET Core v2

Générez, testez, packagez ou publiez une application .NET ou exécutez une commande CLI .NET personnalisée.

Syntaxe

# .NET Core v2
# Build, test, package, or publish a .NET application, or run a custom .NET CLI command.
- task: DotNetCoreCLI@2
  inputs:
    #azureSubscription: # string. Alias: ConnectedServiceName. Azure Resource Manager connection. 
    command: 'build' # 'build' | 'push' | 'pack' | 'publish' | 'restore' | 'run' | 'test' | 'custom'. Required. Command. Default: build.
    #publishWebProjects: true # boolean. Optional. Use when command = publish. Publish web projects. Default: true.
    #projects: # string. Optional. Use when command = build || command = restore || command = run || command = test || command = custom || publishWebProjects = false. Path to project(s) or solution(s). 
    #custom: # string. Required when command = custom. Custom command. 
    #arguments: # string. Optional. Use when command = build || command = publish || command = run || command = test || command = custom. Arguments. 
    #restoreArguments: # string. Optional. Use when command = restore. Arguments. 
    #publishTestResults: true # boolean. Optional. Use when command = test. Publish test results and code coverage. Default: true.
    #testRunTitle: # string. Optional. Use when command = test. Test run title. 
    #zipAfterPublish: true # boolean. Optional. Use when command = publish. Zip published projects. Default: true.
    #modifyOutputPath: true # boolean. Optional. Use when command = publish. Add project's folder name to publish path. Default: true.
    #packagesToPush: '$(Build.ArtifactStagingDirectory)/*.nupkg' # string. Alias: searchPatternPush. Required when command = push. Path to NuGet package(s) to publish. Default: $(Build.ArtifactStagingDirectory)/*.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. 
    #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).
    #packDirectory: '$(Build.ArtifactStagingDirectory)' # string. Alias: outputDir. Optional. Use when command = pack. Package Folder. Default: $(Build.ArtifactStagingDirectory).
    #nobuild: false # boolean. Optional. Use when command = pack. Do not build. Default: false.
    #includesymbols: false # boolean. Optional. Use when command = pack. Include Symbols. Default: false.
    #includesource: false # boolean. Optional. Use when command = pack. Include Source. Default: false.
    #requestTimeout: '300000' # string. Set timeout for package download request. Default: 300000.
  # 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 feed. Select from the dropdown or enter [project name/]feed name. 
    #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.
    #restoreDirectory: # string. Alias: packagesDirectory. Optional. Use when command = restore. Destination directory. 
    #verbosityRestore: 'Normal' # '-' | 'Quiet' | 'Minimal' | 'Normal' | 'Detailed' | 'Diagnostic'. Optional. Use when command = restore. Verbosity. Default: Normal.
  # Advanced
    #publishPackageMetadata: true # boolean. Optional. Use when command = push && nuGetFeedType = internal && command = push. Publish pipeline metadata. Default: true.
  # Pack options
    #versioningScheme: 'off' # 'off' | 'byPrereleaseNumber' | 'byEnvVar' | 'byBuildNumber'. Required when command = pack. Automatic package versioning. Default: off.
    #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.
  # Advanced
    #buildProperties: # string. Optional. Use when command = pack. Additional build properties. 
    #verbosityPack: 'Normal' # '-' | 'Quiet' | 'Minimal' | 'Normal' | 'Detailed' | 'Diagnostic'. Optional. Use when command = pack. Verbosity. Default: Normal.
  # Advanced
    #workingDirectory: # string. Optional. Use when command != restore && command != push && command != pack && command != pack && command != push && command != restore. Working directory.

Entrées

azureSubscription - de connexion Azure Resource Manager
Alias d’entrée : ConnectedServiceName. string.

Spécifiez une connexion de service Azure Resource Manager configurée avec la fédération d’identité de charge de travail pour utiliser AzurePipelinesCredential dans les tests d’intégration. Pour plus d’informations, consultez Utiliser AzurePipelinesCredential dans les tests d’intégration.

Note

Cette entrée prend uniquement en charge les connexions de service ARM configurées pour utiliser la fédération des identités de charge de travail.

command - commande
string. Obligatoire. Valeurs autorisées : build, push (push nuget), pack, publish, restore, run, test, custom. Valeur par défaut : build.

Commande dotnet à exécuter. Spécifiez custom pour ajouter des arguments ou utiliser une commande non répertoriée ici.

Important

La tâche l’authentification NuGet est la nouvelle méthode recommandée pour s’authentifier auprès d’Azure Artifacts et d’autres référentiels NuGet. Les commandes restore et push de cette tâche CLI .NET Core ne prennent plus de nouvelles fonctionnalités et seuls les bogues critiques sont résolus. Pour plus d’informations, consultez les remarques.

publishWebProjects - Publier des projets web
boolean. Optionnel. Utilisez quand command = publish. Valeur par défaut : true.

Si cette entrée est définie sur true, la valeur de la propriété projects est ignorée et la tâche tente de rechercher les projets web dans le référentiel et d’exécuter la commande de publication sur ces derniers. Les projets web sont identifiés par la présence d’un fichier web.config ou d’un dossier wwwroot dans le répertoire. En l’absence d’un fichier web.config ou d’un dossier wwwroot, les projets qui utilisent un SDK web, comme Microsoft.NET.Sdk.Web, sont sélectionnés.

projects - chemin d’accès aux projets ou aux solutions
string. Optionnel. Utilisez quand command = build || command = restore || command = run || command = test || command = custom || publishWebProjects = false.

Chemin d’accès au ou aux fichiers .csproj ou .sln à utiliser. Vous pouvez utiliser des caractères génériques (par exemple, **/*.csproj pour tous les fichiers .csproj dans tous les sous-dossiers). Pour plus d’informations, consultez la référence modèles de correspondance de fichiers.

Ce chemin d’accès est relatif à la racine du référentiel, quel que soit le paramètre workingDirectory.

custom - commande personnalisée
string. Obligatoire lorsque command = custom.

Commande à passer à dotnet.exe pour l’exécution. Pour obtenir la liste complète des commandes disponibles, consultez la documentation dotnet CLI.

arguments - arguments
string. Optionnel. Utilisez quand command = build || command = publish || command = run || command = test || command = custom.

Spécifie les arguments de la commande sélectionnée. Par exemple, la configuration de build, le dossier de sortie et le runtime. Les arguments dépendent de la commande sélectionnée.

Actuellement, cette entrée accepte uniquement les arguments pour build, publish, run, testet custom. Si vous souhaitez ajouter des arguments pour une commande non répertoriée, utilisez custom.

restoreArguments - arguments
string. Optionnel. Utilisez quand command = restore.

Écrit les arguments supplémentaires à passer à la commande restore.

publishTestResults - Publier les résultats des tests et la couverture du code
boolean. Optionnel. Utilisez quand command = test. Valeur par défaut : true.

L’activation de cette option génère un fichier TRX test results dans $(Agent.TempDirectory), et les résultats seront publiés sur le serveur.

Cette option ajoute --logger trx --results-directory $(Agent.TempDirectory) aux arguments de ligne de commande.

La couverture du code peut être collectée en ajoutant l’option --collect "Code coverage" aux arguments de ligne de commande.

testRunTitle - titre d’exécution de test
string. Optionnel. Utilisez quand command = test.

Fournit un nom pour l’exécution de test.

zipAfterPublish - projets zip publiés
boolean. Optionnel. Utilisez quand command = publish. Valeur par défaut : true.

Si cette entrée est définie sur true, les dossiers créés par la commande de publication sont compressés et supprimés.

modifyOutputPath - Ajouter le nom du dossier du projet pour publier le chemin d’accès
boolean. Optionnel. Utilisez quand command = publish. Valeur par défaut : true.

Si cette entrée est définie sur true, les dossiers créés par la commande de publication ont le nom du fichier projet précédé de leurs noms de dossiers lorsque le chemin de sortie est spécifié explicitement dans les arguments. Cela est utile si vous souhaitez publier plusieurs projets dans le même dossier.

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

Vous pouvez sélectionner un flux à partir d’Azure Artifacts et/ou NuGet.org ici, ou vous pouvez valider un fichier nuget.config dans votre référentiel de code source et définir son chemin à l’aide de l’entrée nugetConfigPath.

vstsFeed - Utiliser des packages à partir de ce flux Azure Artifacts. Sélectionnez dans la liste déroulante ou entrez le nom du flux [nom du projet/].
Alias d’entrée : feedRestore. string. Optionnel. Utilisez quand selectOrConfig = select && command = restore.

Inclut le flux sélectionné dans le NuGet.configgénéré. La gestion des packages doit être installée et concédée sous licence pour sélectionner un flux ici. projectName / feedName sont utilisés pour les flux délimités par le projet. Seule FeedName est utilisée pour les flux délimités par l’organisation. Remarque : Cela n’est pas pris en charge pour la commande test.

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

Inclut NuGet.org dans le NuGet.configgénéré.

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

Le NuGet.config dans votre référentiel qui spécifie les flux à partir desquels restaurer des packages.

externalFeedCredentials - Credentials for feeds outside this organization/collection
Alias d’entrée : externalEndpoints. string. Optionnel. Utilisez quand selectOrConfig = config && command = restore.

Informations d’identification à utiliser pour les registres externes situés dans la NuGet.configsélectionnée. Pour les flux de cette organisation/collection, laissez cette entrée vide ; les informations d’identification de la build sont utilisées automatiquement.

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

Empêche NuGet d’utiliser des packages à partir de caches d’ordinateurs locaux.

restoreDirectory - répertoire de destination
Alias d’entrée : packagesDirectory. string. Optionnel. 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 le cache de package NuGet par défaut.

verbosityRestore - verbosity
string. Optionnel. Utilisez quand command = restore. Valeurs autorisées : -, Quiet, Minimal, Normal, Detailed, Diagnostic. Valeur par défaut : Normal.

Spécifie la quantité de détails affichée dans la sortie de la commande restore.

packagesToPush - Chemin d’accès aux packages NuGet pour publier des
Alias d’entrée : searchPatternPush. string. Obligatoire lorsque command = push. Valeur par défaut : $(Build.ArtifactStagingDirectory)/*.nupkg.

Modèle à mettre en correspondance ou chemin d’accès à nupkg fichiers à charger. Plusieurs modèles peuvent être séparés par un point-virgule, et vous pouvez créer un modèle négatif en le préfixant avec !. Exemple : **/*.nupkg;!**/*.Tests.nupkg.

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

Spécifie si le flux cible est interne ou externe.

publishVstsFeed - de flux cible
Alias d’entrée : feedPublish. string. Obligatoire lorsque command = push && nuGetFeedType = internal.

Spécifie un flux hébergé dans cette organisation. La gestion des packages doit être installée et concédée sous licence pour sélectionner un flux ici.

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

Associe les métadonnées de ce pipeline de build/mise en production (exécuter #, informations de code source) au package.

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

La connexion de service NuGet qui contient les informations d’identification du serveur NuGet externe.

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

Modèle à rechercher .csproj ou .nuspec fichiers à empaqueter.

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

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

Lorsque vous utilisez un fichier .csproj, cette entrée spécifie la configuration à empaqueter.

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

Dossier dans lequel les packages seront créés. Si ce dossier est vide, les packages sont créés en même temps que le fichier csproj.

nobuild - Ne pas générer de
boolean. Optionnel. Utilisez quand command = pack. Valeur par défaut : false.

Spécifie que la tâche ne génère pas le projet avant l’empaquetage. Cette tâche correspond au paramètre --no-build de la commande build.

includesymbols - inclure des symboles
boolean. Optionnel. Utilisez quand command = pack. Valeur par défaut : false.

Crée des packages NuGet de symboles. Cette tâche correspond au paramètre de ligne de commande --include-symbols.

includesource - inclure source
boolean. Optionnel. Utilisez quand command = pack. Valeur par défaut : false.

Inclut le code source dans le package. Cette tâche correspond au paramètre de ligne de commande --include-source.

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

Cette tâche ne peut pas être utilisée avec des projets référencés inclus. Si vous choisissez Use the date and time, cela génère une version SemVer-conforme mise en forme comme X.Y.Z-ci-datetime où vous choisissez X, Yet Z.

Si vous choisissez Use an environment variable, vous devez sélectionner une variable d’environnement et vous assurer qu’elle contient le numéro de version que vous souhaitez utiliser.

Si vous choisissez Use the build number, utilisez le numéro de build pour versionner votre package. Remarque : Sous Options, définissez le format du numéro de build sur $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r).

versionEnvVar - de variable d’environnement
string. Obligatoire lorsque versioningScheme = byEnvVar && command = pack.

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

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

La X dans la version X.Y.Z.

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

La Y dans la version X.Y.Z.

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

La Z dans la version X.Y.Z.

buildProperties - propriétés de build supplémentaires
string. Optionnel. 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 fichier .nuspec sera remplacée par la valeur donnée. Les valeurs peuvent être des chaînes entre guillemets.

verbosityPack - verbosity
string. Optionnel. Utilisez quand command = pack. Valeurs autorisées : -, Quiet, Minimal, Normal, Detailed, Diagnostic. Valeur par défaut : Normal.

Spécifie la quantité de détails affichée dans la sortie de la commande pack.

workingDirectory - répertoire de travail
string. Optionnel. Utilisez quand command != restore && command != push && command != pack && command != pack && command != push && command != restore.

Répertoire de travail actuel où le script est exécuté. Empty est la racine du dépôt (build) ou des artefacts (version), qui est $(System.DefaultWorkingDirectory).

requestTimeout - Définir le délai d’expiration de la demande de téléchargement de package
string. Valeur par défaut : 300000.

Fournissez une valeur de délai d’expiration pour les requêtes HTTP effectuées par la tâche pour obtenir le package .NET. La valeur est en millisecondes. La valeur par défaut est de 3 0000 millisecondes (5 minutes). Ne peut pas être supérieur à 6 0000 millisecondes (10 minutes).

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

Important

La tâche l’authentification NuGet est la nouvelle méthode recommandée pour s’authentifier auprès d’Azure Artifacts et d’autres référentiels NuGet. Les commandes restore et push de cette tâche CLI .NET Core ne prennent plus de nouvelles fonctionnalités et seuls les bogues critiques sont résolus.

Utiliser AzurePipelinesCredential dans les tests d’intégration

Les bibliothèques d’identités Azure pour .NET, C++, Go, Java, JavaScript et Python prennent en charge lesde fédération d’identité de charge de travail. Par conséquent, le code exécuté à partir de la AzureCLI@2 et AzurePowerShell@5 tâches peuvent s’authentifier avec Microsoft Entra ID (par exemple, pour accéder à Azure) à l’aide de la classe AzurePipelinesCredential.

De nombreux clients utilisent des bibliothèques clientes du Kit de développement logiciel (SDK) Azure dans les tests d’intégration appelés à partir d’autres tâches. Les tâches DotNetCoreCLI@2, Maven@4 et VSTest@3 peuvent accéder aux ressources Azure à l’aide de la classe AzurePipelinesCredential.

Vous pouvez définir la propriété connectedServiceName sur une connexion de service Azure configurée avec la fédération des identités de charge de travail. La AzurePipelinesCredential nécessite SYSTEM_ACCESSTOKEN être définie.

L’exemple suivant montre l’entrée connectedServiceName sur la tâche de DotNetCoreCLI@2. VSTest@3 et Maven@4 utilisation est similaire.

- task: DotNetCoreCLI@2
  inputs:
    command: 'run'
    connectedServiceName: <Azure service connection configured with workload identity federation>
  env:
    SYSTEM_ACCESSTOKEN: $(System.AccessToken)

Pour plus d’informations sur AzurePipelinesCredential, consultez Améliorer la posture de sécurité dans les connexions de service Azure avec AzurePipelinesCredential.

Pourquoi l’étape de génération, de publication ou de test échoue-t-elle à restaurer des packages ?

La plupart des commandes dotnet, notamment build, publishet test incluent une étape de restore implicite. Cela échoue sur les flux authentifiés, même si vous avez exécuté une dotnet restore réussie dans une étape antérieure, car l’étape précédente aura nettoyé les informations d’identification qu’elle a utilisées.

Pour résoudre ce problème, ajoutez l’indicateur --no-restore à la zone de texte Arguments.

En outre, la commande test ne reconnaît pas les arguments feedRestore ou vstsFeed, et les flux spécifiés de cette manière ne seront pas inclus dans le fichier NuGet.config généré lorsque l’étape de restore implicite s’exécute. Il est recommandé d’utiliser une étape de dotnet restore explicite pour restaurer des packages. La commande restore respecte les arguments feedRestore et vstsFeed.

Pourquoi est-ce que je reçois des avertissements NU1507 avec mappage de source de package même si, lors de la génération sur mon ordinateur, il n’a pas d’avertissements ?

Les différentes commandes qui effectuent une restauration NuGet ou accèdent à un flux NuGet créent un fichier de NuGet.config temporaire spécial qui ajoute l’authentification NuGet pour les flux NuGet d’artefacts Azure. La façon dont cette opération est effectuée est en conflit avec le schéma utilisé par le mappage de source de package pour mapper les packages aux sources et interrompt la configuration mappin de source de package dans le fichier NuGet.config de votre référentiel. Pour contourner ce conflit, vous pouvez utiliser la tâche d’authentification NuGet pour authentifier et ensuite la commande personnalisée pour appeler la commande dotnet souhaitée sans modification .

# Authenticate Azure DevOps NuGet feed
- task: NuGetAuthenticate@1
  displayName: 'Authenticate Azure DevOps NuGet feed'

# Restore project
- task: DotNetCoreCLI@2
  inputs:
    command: 'custom'
    custom: 'restore'

# Build project
- task: DotNetCoreCLI@2
  inputs:
    command: 'custom'
    custom: 'build'
    arguments: '--no-restore'

Pourquoi dois-je vérifier un NuGet.config?

La vérification d’un NuGet.config dans le contrôle de code source garantit qu’une partie clé des informations nécessaires pour générer votre projet ( l’emplacement de ses packages) est disponible pour chaque développeur qui extrait votre code.

Toutefois, pour les situations où une équipe de développeurs travaille sur un large éventail de projets, il est également possible d’ajouter un flux Azure Artifacts au NuGet.config global sur la machine de chaque développeur. Dans ces situations, l’utilisation de l’option Feeds I select here dans la tâche NuGet réplique cette configuration.

Dépannage

Project using Entity Framework a cessé de fonctionner sur des agents hébergés

.NET Core ne dispose pas d’Entity Framework(EF) intégré. Vous devrez installer EF avant de commencer l’exécution ou ajouter global.json au projet avec la version requise du Kit de développement logiciel (SDK) .NET Core. Cela garantit que le sdk correct est utilisé pour générer un projet EF. Si la version requise n’est pas présente sur l’ordinateur, ajoutez la tâche UseDotNetV2 à votre pipeline pour installer la version requise. Pour plus d’informations, consultez Obtenir le runtime Entity Framework Core.

Exemples

• exemples de build
• exemples push
• exemples push
• exemples Pack
• Publier des exemples
• exemples de restauration
• exemples de test

Exemples de build

Générer un projet

# Build project
- task: DotNetCoreCLI@2
  inputs:
    command: 'build'

Générer plusieurs projets

# Build multiple projects
- task: DotNetCoreCLI@2
  inputs:
    command: 'build'
    projects: |
      src/proj1/proj1.csproj 
      src/proj2/proj2.csproj 
      src/other/other.sln    # Pass a solution instead of a csproj.

Exemples d’envoi (push)

Envoyer (push) des packages NuGet vers un flux interne

# Push non test NuGet packages from a build to internal organization Feed
- task: DotNetCoreCLI@2
  inputs:
    command: 'push'
    searchPatternPush: '$(Build.ArtifactStagingDirectory)/*.nupkg;!$(Build.ArtifactStagingDirectory)/*.Tests.nupkg'
    feedPublish: 'FabrikamFeed'

Envoyer des packages NuGet vers un flux externe

# Push all NuGet packages from a build to external Feed
- task: DotNetCoreCLI@2
  inputs:
    command: 'push'
    nugetFeedType: 'external'
    externalEndPoint: 'MyNuGetServiceConnection'

Exemples de pack

Empaquetez un NuGetPackage dans un répertoire de sortie spécifique

# Pack a NuGet package to a test directory
- task: DotNetCoreCLI@2
  inputs: 
    command: 'pack'
    outputDir: '$(Build.ArtifactStagingDirectory)/TestDir'

Empaqueter un package de symboles

# Pack a symbol package along with NuGet package
- task: DotNetCoreCLI@2
  inputs: 
    command: 'pack'
    includesymbols: true

Exemples de publication

Publier des projets dans le dossier spécifié

# Publish projects to specified folder.
- task: DotNetCoreCLI@2
  displayName: 'dotnet publish'
  inputs:
    command: 'publish'
    publishWebProjects: false
    projects: '**/*.csproj'
    arguments: '-o $(Build.ArtifactStagingDirectory)/Output'
    zipAfterPublish: true
    modifyOutputPath: true

Exemples de restauration

#Restore packages with the .NET Core CLI task
- task: DotNetCoreCLI@2
  displayName: 'dotnet restore'
  inputs:
    command: 'restore'
    feedsToUse: 'select'
    feedRestore: 'projectName/feedName'
    projects: '**/*.csproj'
    includeNuGetOrg: true

Exemples de test

Exécuter des tests dans votre référentiel

# Run tests and auto publish test results.
- task: DotNetCoreCLI@2
  inputs:
    command: 'test'

Exigences

Exigence	Description
Types de pipelines	YAML, Build Classique, Version Classique
Exécutions sur	Agent
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	Construire