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.
    #requestTimeout: '300000' # string. Set timeout for package download request. Default: 300000.
  # 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
    #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

package packageType - pour 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 des json globaux
boolean. Optionnel. 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 racine de recherche en définissant l’entrée du répertoire de travail.

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

Si vous recevez un message d’erreur tel 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. et que vous utilisez global.json, vérifiez l'sdk.version dans votre global.json.

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


workingDirectory - répertoire de travail
string. Optionnel. Utilisez quand useGlobalJson = true.

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


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

Spécifie la version du Kit de développement logiciel (SDK) ou du runtime .NET Core à installer. Les formats de valeur de version sont présentés avec des exemples :

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

Les valeurs de version pour les installations du Kit de développement logiciel (SDK) ou du runtime se trouvent dans le fichier releases.json. Le lien vers la 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 Kit de développement logiciel (SDK) ou du runtime .NET Core à installer. Les formats de valeur de version sont présentés avec des exemples :

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

Les valeurs de version pour les installations du Kit de développement logiciel (SDK) ou du runtime se trouvent dans le fichier releases.json. Le lien vers la 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 de Visual Studio compatible
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 majeure, une version mineure et un numéro de correctif.

Les valeurs de version pour les installations du Kit de développement logiciel (SDK) ou du runtime, utilisées pour la chaîne version, se trouvent dans le fichier releases.json. Le lien vers la 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 des versions préliminaires
boolean. Optionnel. Utilisez quand useGlobalJson = false || packageType = runtime. Valeur par défaut : false.

S’il est défini sur true, inclut des versions d’aperçu lorsque la tâche recherche les dernières versions runtime/SDK, telles que la recherche de 2.2.x ou de 3.1.x. Ce paramètre est ignoré si vous spécifiez une version exacte, telle que 3.0.100-preview3-010431.


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

S’il est défini sur true, inclut des versions d’aperçu lorsque la tâche recherche les dernières versions runtime/SDK, telles que la recherche de 2.2.x ou de 3.1.x. Ce paramètre est ignoré si vous spécifiez une version exacte, telle que 3.0.100-preview3-010431.


chemin d’accès installationPath - pour installer le .Net Core
string. Valeur par défaut : $(Agent.ToolsDirectory)/dotnet.

Spécifie l’emplacement où le Kit de développement logiciel (SDK)/Runtime .NET Core doit être installé. Différents chemins d’accès 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é sur les pipelines. Tous les pipelines s’exécutant sur l’agent ont accès aux versions précédemment installées.
  • $(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.
  • un autre chemin d’accès: vous pouvez utiliser n’importe quel chemin si le processus de l’agent a accès au chemin d’accès. Cela modifie l’état de la machine et affecte tous les processus en cours d’exécution.

Note

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


performMultiLevelLookup - effectuer une recherche multinive
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 les suivantes :

  • 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 multiniveaux. 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 recherche SharedFX à plusieurs niveaux.

Note

performMultiLevelLookup s’applique uniquement aux agents Windows.


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

La tâche Use .NET Core acquiert une version spécifique de .NET Core à partir d’Internet ou du cache d’outils et l’ajoute au PATH 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 telles que DotNetCoreCLI@2. L’ajout de cette tâche avant le DotNetCoreCLI@2 dans une définition de build garantit que la version sera disponible au moment de la génération, du test et de la publication de votre application.

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

Exigences

Exigence Description
Types de pipelines YAML, Build Classique, Version Classique
Exécutions sur Agent, DeploymentGroup
demandes Aucun
fonctionnalités de L’exécution de cette tâche répond aux exigences de suivantes pour toutes les tâches suivantes dans le même travail : DotNetCore
restrictions de commande Quelconque
variables settables Quelconque
Version de l’agent 2.144.0 ou version ultérieure
Catégorie de tâche Outil
Exigence Description
Types de pipelines YAML, Build Classique, Version Classique
Exécutions sur Agent, DeploymentGroup
demandes Aucun
fonctionnalités de L’exécution de cette tâche répond aux exigences de suivantes pour toutes les tâches suivantes dans le même travail : DotNetCore
restrictions de commande Quelconque
variables settables Quelconque
Version de l’agent Toutes les versions de l’agent prises en charge.
Catégorie de tâche Outil