Partager via


UseDotNet@2 - Utiliser la tâche dotnet v2

Utilisez cette tâche pour acquérir une version spécifique du Kit de développement logiciel (SDK) .NET Core à partir d’Internet ou du cache local et l’ajouter à PATH. Utilisez cette tâche pour modifier la version de .NET Core utilisée dans les tâches suivantes. Cette tâche fournit également la prise en charge du proxy.

Syntaxe

# Use .NET Core v2
# Acquires a specific version of the .NET Core SDK from the internet or the local cache and adds it to the PATH. Use this task to change the version of .NET Core used in subsequent tasks. Additionally provides proxy support.
- task: UseDotNet@2
  inputs:
    #packageType: 'sdk' # 'runtime' | 'sdk'. Package to install. Default: sdk.
    #useGlobalJson: false # boolean. Optional. Use when packageType = sdk. Use global json. Default: false.
    #workingDirectory: # string. Optional. Use when useGlobalJson = true. Working Directory. 
    #version: # string. Optional. Use when useGlobalJson = false || packageType = runtime. Version. 
    #includePreviewVersions: false # boolean. Optional. Use when useGlobalJson = false  || packageType = runtime. Include Preview Versions. Default: false.
  # Advanced
    #vsVersion: # string. Compatible Visual Studio version. 
    #installationPath: '$(Agent.ToolsDirectory)/dotnet' # string. Path To Install .Net Core. Default: $(Agent.ToolsDirectory)/dotnet.
    #performMultiLevelLookup: false # boolean. Perform Multi Level Lookup. Default: false.
# Use .NET Core v2
# Acquires a specific version of the .NET Core SDK from the internet or the local cache and adds it to the PATH. Use this task to change the version of .NET Core used in subsequent tasks. Additionally provides proxy support.
- task: UseDotNet@2
  inputs:
    #packageType: 'sdk' # 'runtime' | 'sdk'. Package to install. Default: sdk.
    #useGlobalJson: false # boolean. Optional. Use when packageType = sdk. Use global json. Default: false.
    #workingDirectory: # string. Optional. Use when useGlobalJson = true. Working Directory. 
    #version: # string. Optional. Use when useGlobalJson = false || packageType = runtime. Version. 
    #includePreviewVersions: false # boolean. Optional. Use when useGlobalJson = false  || packageType = runtime. Include Preview Versions. Default: false.
  # Advanced
    #installationPath: '$(Agent.ToolsDirectory)/dotnet' # string. Path To Install .Net Core. Default: $(Agent.ToolsDirectory)/dotnet.
    #performMultiLevelLookup: false # boolean. Perform Multi Level Lookup. Default: false.
# Use dotnet v2
# Acquires a specific version of the .NET Core SDK from the internet or the local cache and adds it to the PATH. Use this task to change the version of .NET Core used in subsequent tasks. Additionally provides proxy support.
- task: UseDotNet@2
  inputs:
    #packageType: 'sdk' # 'runtime' | 'sdk'. Package to install. Default: sdk.
    #version: # string. Version. 
    #includePreviewVersions: false # boolean. Include Preview Versions. Default: false.
  # Advanced
    #installationPath: '$(Agent.ToolsDirectory)/dotnet' # string. Path To Install .Net Core. Default: $(Agent.ToolsDirectory)/dotnet.
    #performMultiLevelLookup: false # boolean. Perform Multi Level Lookup. Default: false.

Entrées

packageType - Package à installer
string. Valeurs autorisées : runtime, sdk (SDK (contient le runtime)). Valeur par défaut : sdk.

Spécifie s’il faut installer uniquement le runtime .NET ou le Kit de développement logiciel (SDK).


useGlobalJson - Utiliser json global
boolean. facultatif. Utilisez quand packageType = sdk. Valeur par défaut : false.

Installe tous les kits SDK à partir de global.json fichiers. Ces fichiers sont recherchés à partir de system.DefaultWorkingDirectory. Vous pouvez modifier le chemin d’accès racine de recherche en définissant l’entrée du répertoire de travail.

Le 6.x format et 6.1.x (à l’aide .x d’un caractère générique) décrit dans l’entrée UseDotNet@2.version est destiné à être utilisé dans l’entrée version de la tâche, et non dans le sdk.version paramètre dans global.json.

Si vous recevez un message d’erreur comme et que ##[error]Version 6.0.x is not allowed. Allowed version types are: majorVersion.x, majorVersion.minorVersion.x, majorVersion.minorVersion.patchVersion. More details: Only explicit versions and accepted, such as: 2.2.301. Version: 6.0.x is not valid. vous utilisez global.json, vérifiez dans sdk.version votre global.json.

Pour plus d’informations sur global.json, consultez Sélectionner la version de .NET à utiliser.


workingDirectory - Répertoire de travail
string. facultatif. Utilisez quand useGlobalJson = true.

Spécifie le chemin d’accès à partir duquel global.json les fichiers doivent être recherchés lors de l’utilisation de useGlobalJson. Si la valeur est vide, system.DefaultWorkingDirectory est considéré comme le chemin racine.


version - Version
string. facultatif. Utilisez quand useGlobalJson = false || packageType = runtime.

Spécifie la version du runtime ou du sdk .NET Core à installer. Les formats de valeur de version sont présentés avec des exemples :

  • 2.x: installe la dernière version du KIT de développement logiciel (SDK) ou du runtime avec la version principale spécifiée, 2.
  • 3.1.x: installe la dernière version du KIT de développement logiciel (SDK) ou du runtime avec les versions principales et mineures spécifiées, 3 et 1.
  • 3.1.402: installe le KIT de développement logiciel (SDK) ou la version du runtime spécifié, 3.1.402.

Les valeurs de version pour les installations du SDK ou du runtime se trouvent dans le releases.json fichier . Le lien vers le releases.json d’une version majeure/mineure se trouve dans le fichier releases-index . Par exemple, le lien vers le fichier releases.json pour la version 3.1.


version - Version
string.

Spécifie la version du runtime ou du sdk .NET Core à installer. Les formats de valeur de version sont présentés avec des exemples :

  • 2.x: installe la dernière version du KIT de développement logiciel (SDK) ou du runtime avec la version principale spécifiée, 2.
  • 3.1.x: installe la dernière version du KIT de développement logiciel (SDK) ou du runtime avec les versions principales et mineures spécifiées, 3 et 1.
  • 3.1.402: installe le KIT de développement logiciel (SDK) ou la version du runtime spécifié, 3.1.402.

Les valeurs de version pour les installations du SDK ou du runtime se trouvent dans le releases.json fichier . Le lien vers le releases.json d’une version majeure/mineure se trouve dans le fichier releases-index . Par exemple, le lien vers le fichier releases.json pour la version 3.1.


vsVersion - Version compatible de Visual Studio
string.

Spécifie une version compatible de Visual Studio pour une installation correspondante du Kit de développement logiciel (SDK) .NET Core. La valeur doit être un numéro de version complet, tel que 16.6.4, qui contient une version principale, une version mineure et un numéro de correctif.

Les valeurs de version pour les installations du SDK ou du runtime, qui sont utilisées pour la version chaîne, se trouvent dans le releases.json fichier . Le lien vers le releases.json d’une version majeure/mineure se trouve dans le fichier releases-index . Par exemple, le lien vers le fichier releases.json pour la version 3.1.


includePreviewVersions - Inclure les versions préliminaires
boolean. facultatif. Utilisez quand useGlobalJson = false || packageType = runtime. Valeur par défaut : false.

Si la valeur est définie truesur , inclut les versions préliminaires lorsque la tâche recherche les dernières versions du runtime/SDK, comme la recherche 2.2.x de ou 3.1.x. Ce paramètre est ignoré si vous spécifiez une version exacte, telle que 3.0.100-preview3-010431.


includePreviewVersions - Inclure les versions préliminaires
boolean. Valeur par défaut : false.

Si la valeur est définie truesur , inclut les versions préliminaires lorsque la tâche recherche les dernières versions du runtime/SDK, comme la recherche 2.2.x de ou 3.1.x. Ce paramètre est ignoré si vous spécifiez une version exacte, telle que 3.0.100-preview3-010431.


installationPath - Chemin d’accès à l’installation de .Net Core
string. Valeur par défaut : $(Agent.ToolsDirectory)/dotnet.

Spécifie l’emplacement d’installation du sdk/runtime .NET Core. Différents chemins peuvent avoir l’impact suivant sur . Comportement de NET.

  • $(Agent.ToolsDirectory): l’utilisation de ce chemin met en cache l’installation sur l’agent, car ce répertoire n’est pas nettoyé entre les pipelines. Tous les pipelines en cours d’exécution sur l’agent ont accès aux versions installées précédemment.
  • $(Agent.TempDirectory): l’utilisation de ce chemin garantit qu’un pipeline n’utilise pas une version mise en cache de .NET Core, car ce dossier est nettoyé après chaque pipeline.
  • Autre chemin : vous pouvez utiliser n’importe quel chemin si le processus de l’agent a accès au chemin. Cela modifiera l’état de la machine et aura un impact sur tous les processus en cours d’exécution.

Notes

Vous pouvez utiliser le paramètre Recherche à plusieurs niveaux , performMultiLevelLookup, pour configurer la façon dont l’hôte .NET recherche des versions.


performMultiLevelLookup - Effectuer une recherche à plusieurs niveaux
boolean. Valeur par défaut : false.

Configure le comportement du processus hôte .NET lorsqu’il recherche une infrastructure partagée appropriée. Les valeurs sont :

  • false: le processus hôte recherche uniquement les versions présentes dans le dossier spécifié par la tâche.
  • true: le processus hôte effectue une recherche dans des emplacements globaux prédéfinis à l’aide d’une recherche à plusieurs niveaux. Les emplacements globaux par défaut sont les suivants :
    • C:\Program Files\dotnet (processus 64 bits)
    • C:\Program Files (x86)\dotnet (processus 32 bits)

En savoir plus sur la recherche SharedFX à plusieurs niveaux.

Notes

performMultiLevelLookup s’applique uniquement aux agents Windows.


Options de contrôle des tâches

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

La tâche Utiliser .NET Core acquiert une version spécifique de .NET Core à partir d’Internet ou du cache des outils et l’ajoute au chemin d’accès de l’agent Azure Pipelines (hébergé ou privé). Utilisez cette tâche pour modifier la version de .NET Core utilisée dans les tâches suivantes, comme DotNetCoreCLI@2. L’ajout de cette tâche avant la DotNetCoreCLI@2 dans une définition de build garantit que la version est disponible au moment de la création, du test et de la publication de votre application.

L’approche du programme d’installation de l’outil vous permet également de dissocier des cycles de mise à jour de l’agent. Si la version .NET Core que vous recherchez est manquante dans l’agent Azure Pipelines (hébergé ou privé), vous pouvez utiliser cette tâche pour installer la version appropriée sur l’agent.

Configuration requise

Condition requise Description
Types de pipelines YAML, build classique, version classique
S’exécute sur Agent, DeploymentGroup
Demandes None
Capabilities L’exécution de cette tâche répond aux exigences suivantes pour toutes les tâches suivantes dans le même travail : DotNetCore
Restrictions de commandes Quelconque
Variables settables Quelconque
Version de l’agent 2.144.0 ou supérieur
Catégorie de la tâche Outil
Condition requise Description
Types de pipelines YAML, build classique, version classique
S’exécute sur Agent, DeploymentGroup
Demandes None
Capabilities L’exécution de cette tâche répond aux exigences suivantes pour toutes les tâches suivantes dans le même travail : DotNetCore
Restrictions de commandes Quelconque
Variables settables Quelconque
Version de l’agent Toutes les versions d’agent prises en charge.
Catégorie de la tâche Outil