Partager via

Installer .NET sur Linux à l’aide d’un script d’installation ou en extrayant des fichiers binaires

Cet article montre comment installer le SDK .NET ou le runtime .NET sur Linux à l’aide du script d’installation ou en extrayant les fichiers binaires. Pour obtenir la liste des distributions qui prennent en charge le gestionnaire de package intégré, consultez Installer .NET sur Linux.

Installez le SDK (qui inclut le runtime) si vous souhaitez développer des applications .NET. Ou, si vous avez uniquement besoin d’exécuter des applications, installez le runtime. Si vous installez le runtime, nous vous suggérons d’installer le runtime ASP.NET Core, car il inclut à la fois les runtimes .NET et ASP.NET Core.

Utilisez les commandes dotnet --list-sdks et dotnet --list-runtimes pour voir quelles versions sont installées. Pour plus d’informations, consultez Comment vérifier que .NET est déjà installé.

Versions de .NET

Il existe deux types de versions prises en charge, le support à long terme (LTS) et le support à terme standard (STS). La qualité de toutes les versions est la même. La seule différence est la longueur de la prise en charge. Les versions LTS bénéficient d’un support gratuit et de correctifs pendant trois ans. Les versions STS bénéficient d’un support gratuit et de correctifs pendant deux ans. Pour plus d’informations, consultez la stratégie de prise en charge .NET.

Le tableau suivant répertorie l’état de prise en charge de chaque version de .NET (et .NET Core) :

✔️ Pris en charge ❌ Plus pris en charge
10 (LTS) 7
9 (STS) 6
8 (LTS) 5
3.1
3.0
2,2
2.1
2,0
1.1
1,0

Les dépendances

Il est possible que lorsque vous installez .NET, des dépendances spécifiques ne soient pas installées, par exemple lorsque vous installez manuellement. La liste suivante détaille les distributions Linux prises en charge par Microsoft et qui ont des dépendances que vous devrez peut-être installer. Consultez la page distribution pour plus d’informations :

Pour des informations génériques sur les dépendances, consultez Applications Linux autonomes (en anglais).

Dépendances RPM

Si votre distribution n’a pas été répertoriée précédemment et est basée sur RPM, vous pourriez avoir besoin des dépendances suivantes.

  • glibc
  • libgcc
  • certificats CA
  • openssl-libs
  • libstdc++
  • libicu
  • tzdata
  • krb5-libs

Dépendances DEB

Si votre distribution n’a pas été répertoriée précédemment et qu’elle est basée sur debian, vous devrez peut-être utiliser les dépendances suivantes :

  • libc6
  • libgcc1
  • libgssapi-krb5-2
  • libicu70
  • libssl3
  • libstdc++6
  • zlib1g

Installation par script

Les scripts dotnet-install sont utilisés pour l’automatisation et les installations par un non-administrateur du SDK et du runtime. Vous pouvez télécharger le script depuis https://dot.net/v1/dotnet-install.sh. Lorsque .NET est installé de cette manière, vous devez installer les dépendances requises par votre distribution Linux. Utilisez les liens de l’article Installer .NET sur Linux correspondant à votre distribution Linux.

Importante

Bash est requis pour exécuter le script.

Vous pouvez télécharger le script avec wget :

wget https://dot.net/v1/dotnet-install.sh -O dotnet-install.sh

Ou, avec curl:

curl -L https://dot.net/v1/dotnet-install.sh -o dotnet-install.sh

Avant d’exécuter ce script, assurez-vous d’octroyer une autorisation pour que ce script s’exécute en tant qu’exécutable :

chmod +x ./dotnet-install.sh

Par défaut, le script installe la dernière version du SDK de prise en charge à long terme (LTS), qui est .NET 10. Pour installer la dernière version, qui n’est pas nécessairement une version LTS, utilisez le paramètre --version latest.

./dotnet-install.sh --version latest

Pour installer .NET Runtime au lieu du SDK, utilisez le paramètre --runtime.

./dotnet-install.sh --version latest --runtime aspnetcore

Vous pouvez installer une version majeure spécifique avec le paramètre --channel pour indiquer la version spécifique. La commande suivante installe le Kit de développement logiciel (SDK) .NET 9.0.

./dotnet-install.sh --channel 9.0

Pour plus d’informations, consultez Informations de référence sur les scripts dotnet-install.

Pour activer .NET sur la ligne de commande, consultez Définir des variables d’environnement à l’échelle du système.

Pour apprendre à utiliser CLI .NET, consultez Vue d’ensemble de CLI .NET.

Installation manuelle

En guise d’alternative aux gestionnaires de package, vous pouvez télécharger et installer manuellement le SDK et le runtime. L’installation manuelle est couramment utilisée dans le cadre de tests d’intégration continue ou sur une distribution Linux non prise en charge. Pour un développeur ou un utilisateur, il est préférable d’utiliser un gestionnaire de package.

Téléchargez une version binaire pour le SDK ou le runtime à partir de l’un des sites suivants. Le SDK .NET inclut le runtime correspondant :

Extrayez le fichier téléchargé et utilisez la commande export pour définir DOTNET_ROOT sur l’emplacement du dossier extrait, puis vérifiez que .NET figure dans PATH. L’exportation de DOTNET_ROOT rend les commandes CLI .NET disponibles dans le terminal. Pour plus d’informations sur les variables d’environnement NET, consultez Variables d’environnement du SDK .NET et de l’interface CLI .NET.

Différentes versions de .NET peuvent être extraites dans le même dossier, et coexister côte à côte.

Exemple

Les commandes suivantes utilisent Bash pour définir la variable d’environnement DOTNET_ROOT sur le répertoire de travail actuel suivi de .dotnet. Ce répertoire est créé s’il n’existe pas. La variable d’environnement DOTNET_FILE est le nom de fichier de la version binaire de .NET que vous souhaitez installer. Ce fichier est extrait dans le répertoire DOTNET_ROOT. Le répertoire DOTNET_ROOT et son sous-répertoire tools sont ajoutés à la variable d’environnement PATH.

Importante

Si vous exécutez ces commandes, n’oubliez pas de remplacer la valeur DOTNET_FILE par le nom du fichier binaire .NET que vous avez téléchargé.

DOTNET_FILE=dotnet-sdk-9.0.306-linux-x64.tar.gz
export DOTNET_ROOT=$(pwd)/.dotnet

mkdir -p "$DOTNET_ROOT" && tar zxf "$DOTNET_FILE" -C "$DOTNET_ROOT"

export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools

Vous pouvez installer plusieurs versions de .NET dans le même dossier.

Vous pouvez également installer .NET dans le répertoire de base identifié par la variable HOME ou le chemin d’accès ~ :

export DOTNET_ROOT=$HOME/.dotnet

Pour apprendre à utiliser CLI .NET, consultez Vue d’ensemble de CLI .NET.

Vérifier les fichiers binaires téléchargés

Après avoir téléchargé un programme d’installation ou une version binaire, vérifiez-le pour vous assurer que le fichier n’a pas été modifié ou corrompu. Vous pouvez vérifier la somme de contrôle sur votre ordinateur, puis la comparer à ce qui a été signalé sur le site web de téléchargement.

Lorsque vous téléchargez le fichier depuis une page de téléchargement officielle, la somme de contrôle du fichier est affichée dans une zone de texte. Sélectionnez le bouton Copier pour copier la valeur de la somme de contrôle dans votre presse-papiers.

Page de téléchargement de .NET avec la somme de contrôle

Utilisez la commande sha512sum pour imprimer la somme de contrôle du fichier que vous avez téléchargé. Par exemple, la commande suivante signale la somme de contrôle du fichier dotnet-sdk-9.0.306-linux-x64.tar.gz :

$ sha512sum dotnet-sdk-9.0.306-linux-x64.tar.gz
bbb6bdc3c8048e7cc189759b406257839e7d4bd6b8b1ba4bcdaeea8f92340e6855231043dd73f902130ca5357af72b810bb51a4da4d1315a2927ff85f831f1d5  dotnet-sdk-9.0.306-linux-x64.tar.gz

Comparez la somme de contrôle avec la valeur fournie par le site de téléchargement.

Utiliser un fichier de somme de contrôle pour validation

Les notes de publication de .NET contiennent un lien vers un fichier de somme de contrôle que vous pouvez utiliser pour valider votre fichier téléchargé. Les étapes suivantes décrivent comment télécharger le fichier de somme de contrôle et valider un fichier binaire d’installation .NET :

  1. La page notes de publication de .NET 9 sur GitHub https://github.com/dotnet/core/tree/main/release-notes/9.0#releases contient une section nommée Versions. Le tableau de cette section est lié aux fichiers de téléchargement et de somme de contrôle pour chaque version de .NET 9. L’image suivante montre la table de mise en production .NET 8 comme référence :

    Tableau des versions de notes de publication github pour .NET

  2. Sélectionnez le lien correspondant à la version de .NET que vous avez téléchargée.

    La section précédente utilisait le Kit de développement logiciel (SDK) .NET 9.0.306, qui se trouve dans la version .NET 9.0.10.

  3. Dans la page de publication, vous pouvez voir la version du Runtime .NET et du Kit de développement logiciel (SDK) .NET, ainsi qu’un lien vers le fichier de somme de contrôle. L’image suivante montre la table de mise en production .NET 8 comme référence :

    Tableau de téléchargement avec les sommes de contrôle de .NET

  4. Cliquez avec le bouton droit sur le lien Checksum et copiez-le dans le Presse-Papiers.

  5. Ouvrez un terminal.

  6. Utilisez curl -O {link} pour télécharger le fichier de somme de contrôle.

    Remplacez le lien dans la commande suivante par le lien que vous avez copié.

    curl -O https://builds.dotnet.microsoft.com/dotnet/checksums/9.0.10-sha.txt

  7. Avec le fichier de somme de contrôle et le fichier de mise en production .NET téléchargés dans le même répertoire, utilisez la commande sha512sum -c {file} --ignore-missing pour valider le fichier téléchargé.

    Lorsque la validation réussit, vous voyez le fichier marqué avec l’état OK :

    $ sha512sum -c 9.0.10-sha.txt --ignore-missing
dotnet-sdk-9.0.306-linux-x64.tar.gz: OK

    Si vous voyez le fichier marqué comme ÉCHEC, le fichier que vous avez téléchargé n’est pas valide et ne doit pas être utilisé.

    $ sha512sum -c 9.0.10-sha.txt --ignore-missing
dotnet-sdk-9.0.306-linux-x64.tar.gz: FAILED
sha512sum: WARNING: 1 computed checksum did NOT match
sha512sum: 9.0.10-sha.txt: no file was verified

Définir des variables d’environnement à l’échelle du système

Si vous avez utilisé le script d’installation précédent, les variables définies s’appliquent uniquement à votre session de terminal actuelle. Ajoutez-les à votre profil d’interpréteur de commandes. De nombreux interpréteurs de commandes sont disponibles pour Linux et chacun présente un profil différent. Par exemple :

  • Interpréteur de commandes Bash : ~/.bash_profile, ~/.bashrc
  • Interpréteur de commandes Korn : ~/.kshrc ou .profile
  • Shell Z : ~/.zshrc ou .zprofile

Définissez les deux variables d’environnement suivantes dans votre profil d’interpréteur de commandes :

  • DOTNET_ROOT

    Cette variable est définie sur le dossier sur lequel .NET a été installé, par exemple $HOME/.dotnet :

    export DOTNET_ROOT=$HOME/.dotnet

  • PATH

    Cette variable doit inclure à la fois le dossier DOTNET_ROOT et le dossier DOTNET_ROOT/tools :

    export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools

Étapes suivantes

  • Last updated on