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
et1
.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
et1
.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 true
sur , 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 true
sur , 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 |