DotNetCoreInstaller@1 - Tâche du programme d’installation du runtime/du kit sdk .NET Core v1

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 au chemin d’accès.

Important

Cette tâche est déconseillée et sera mise hors service le 31 janvier 2024. Utilisez UseDotNet@2.

Syntax

# .NET Core SDK/runtime installer v1
# Acquire a specific version of the .NET Core SDK from the internet or local cache and add it to the PATH.
- task: DotNetCoreInstaller@1
  inputs:
    packageType: 'sdk' # 'runtime' | 'sdk'. Required. Package to install. Default: sdk.
    version: '2.2.x' # string. Required. Version. Default: 2.2.x.
    #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. Obligatoire. Valeurs autorisées : runtime (Runtime uniquement), sdk (SDK (contient le runtime)). Valeur par défaut : sdk.

Spécifie s’il faut installer uniquement Runtime ou le KIT de développement logiciel (SDK) complet.

version - Version
string. Obligatoire. Valeur par défaut : 2.2.x.

Spécifie la version du Kit de développement logiciel (SDK) .NET Core ou du runtime à installer.

Utilisez le format suivant pour spécifier la version :

• 2.x : installe la dernière version de la version principale.
• 2.2.x : installe la dernière version de la version principale et secondaire.
• 2.2.104 : installe la version exacte.

Recherchez la valeur de pour l’installation du version SDK/runtime dans le fichier releases-index.

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

Spécifie si vous souhaitez inclure des versions préliminaires lors de la recherche des versions les plus récentes. 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 où le sdk/runtime .NET Core doit être installé. Différents chemins peuvent avoir l’impact suivant sur . Comportement de NET :

• $(Agent.ToolsDirectory) : détermine la version à mettre en cache sur l’agent, car ce répertoire n’est pas nettoyé entre les pipelines. Tous les pipelines s’exécutant sur l’agent auraient accès aux versions installées précédemment en utilisant l’agent.
• $(Agent.TempDirectory) : cela peut garantir qu’un pipeline n’utilise aucune version mise en cache de .NET Core, car ce dossier est nettoyé après chaque pipeline.
• Tout autre chemin : vous pouvez configurer n’importe quel autre chemin, étant donné que le processus de l’agent a accès au chemin. Ceci va modifier l’état de la machine et impacter tous les processus qui s’y exécutent.

Vous pouvez également configurer le paramètre Recherche à plusieurs niveaux. Ce paramètre peut configurer l’hôte .NET pour qu’il sonde une version appropriée.

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

Cette entrée s’applique uniquement aux agents Windows. Cette entrée configure le comportement des processus hôtes .NET pour la recherche d’une infrastructure partagée appropriée. False signifie que seules les versions présentes dans le dossier spécifié dans cette tâche sont examinées par le processus hôte. True signifie que l’hôte tente de rechercher dans des emplacements globaux prédéfinis à l’aide de la recherche à plusieurs niveaux.

Pour Windows, les emplacements globaux par défaut sont les suivants :

• C:\Program Files\dotnet (processus 64 bits)
• C:\Program Files (x86)\dotnet (processus 32 bits)

Pour plus d’informations, consultez Recherche SharedFX multiniveau.

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

Cette tâche est dépréciée. Utilisez @UseDotNet2.

Nouveautés de cette version de tâche.

• Prise en charge de l’installation de plusieurs versions côte à côte.
• Prise en charge des modèles dans la version pour extraire la dernière version dans la version mineure/majeure.
• Restreindre la recherche à plusieurs niveaux.

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 commande	Quelconque
Variables paramétrables	Quelconque
Version de l’agent	Toutes les versions d’agent prises en charge.
Catégorie de la tâche	Outil