DotNetCoreInstaller@1 - Tâche du kit de développement logiciel (SDK) .NET Core/runtime installer 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 à path.

Important

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

Syntaxe

# .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

package packageType - pour 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) ou runtime .NET Core à installer.

Utilisez le format suivant pour spécifier la version :

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

Recherchez la valeur de version pour l’installation du Kit de développement logiciel (SDK)/Runtime dans le fichier releases-index.

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

Spécifie si vous souhaitez inclure des versions préliminaires lors de la recherche de versions les plus récentes. 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 d’installation du Kit de développement logiciel (SDK)/Runtime .NET Core. Différents chemins d’accès 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é sur les pipelines. Tous les pipelines s’exécutant sur l’agent auraient accès aux versions installées précédemment à l’aide de 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 d’accès: vous pouvez configurer n’importe quel autre chemin, étant donné que 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.

Vous pouvez également configurer le paramètre de recherche multiniveur. Ce paramètre peut configurer l’hôte .NET pour qu’il sonde une version appropriée.

performMultiLevelLookup - effectuer une recherche multinive
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 rechercher une infrastructure partagée appropriée. False signifie que seules les versions présentes dans le dossier spécifié dans cette tâche seraient 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 multiniveaux.

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 multiniveux.

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.

Remarques

Cette tâche est déconseillé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 mineure/majeure.
• Restreindre la recherche multiniveux.

Spécifications

Besoin	Descriptif
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	N'importe quel
variables settables	N'importe quel
Version de l’agent	Toutes les versions de l’agent prises en charge.
Catégorie de tâche	Outil