Partager via

Vue d’ensemble de .NET sur Ubuntu

  • Article

Cet article explique comment installer .NET sur Ubuntu. À partir d’Ubuntu 22.04, la plupart des versions de .NET prises en charge sont disponibles dans le flux Ubuntu intégré. Le référentiel de package backports Ubuntu .NET contient les versions .NET restantes prises en charge. Pour plus d’informations sur les versions disponibles, consultez la section Distributions prises en charge.

Canonical a repris la publication de .NET sur Ubuntu. À compter d’Ubuntu 22.04, Microsoft ne distribue plus .NET pour Ubuntu au dépôt de package Microsoft.

Avertissement

Nous vous recommandons de choisir entre Ubuntu et les flux Microsoft pour trouver les packages .NET. Ne mélangez pas des packages .NET à partir de plusieurs référentiels de package. Cela entraîne en effet des problèmes lorsque des applications tentent de résoudre une version spécifique de .NET.

Méthode Avantages Inconvénients
Gestionnaire de package
(flux
Ubuntu intégré)
  • Généralement, la dernière version est disponible.
  • Les correctifs sont disponibles immédiatement.
  • Les dépendances sont incluses.
  • Suppression facile.
  • Les versions .NET disponibles sont prises en charge pendant la période de support de la version Ubuntu concernée.
  • Prise en charge de la plateforme IBM System Z pour .NET 8 sur Ubuntu 24.04.
  • Non disponible pour Ubuntu 16.04, 18.04 et 20.04.
  • Les versions .NET disponibles varient selon la version d’Ubuntu.
  • Les préversions ne sont pas disponibles.
Gestionnaire de package
(flux
Ubuntu intégré)
  • Contient toute les versions prises en charge, qui ne sont pas contenues dans le flux Ubuntu intégré.
  • Les correctifs sont disponibles immédiatement.
  • Les dépendances sont incluses.
  • Suppression facile.
  • Compatible avec le flux Ubuntu intégré.
  • Non disponible pour Ubuntu 16.04, 18.04 et 20.04.
  • Nécessite l’inscription du dépôt des packages de rétroports .NET d’Ubuntu.
  • Les préversions ne sont pas disponibles.
Gestionnaire de package
(Flux Microsoft)
  • Les versions prises en charge sont toujours disponibles.
  • Les correctifs sont disponibles immédiatement.
  • Les dépendances sont incluses.
  • Suppression facile.
  • Non disponible pour Ubuntu 24.04 et les versions ultérieures.
  • Nécessite l’inscription du dépôt de packages Microsoft.
  • Les préversions ne sont pas disponibles.
  • Prend uniquement en charge Ubuntu x64.
Script/extraction manuelle
  • Contrôlez l’emplacement où .NET est installé.
  • Les préversions sont disponibles.
  • Installez manuellement les mises à jour.
  • Installez manuellement les dépendances.
  • Suppression manuelle.

Considérations relatives à la mise à niveau d’Ubuntu

Mise à niveau d’Ubuntu vers 22.04 ou version ultérieure ? Envisagez d’abord de désinstaller .NET.

Si vous avez utilisé un gestionnaire de package pour installer .NET à partir du référentiel de packages Microsoft, vous rencontrerez un problème de combinaison de packages après la mise à niveau d’Ubuntu. Maintenant que Canonical publie .NET sur les flux de package pour Ubuntu 22.04 (et versions ultérieures), le gestionnaire de package ne connaîtra pas la version .NET précédemment installée. Les packages ne peuvent pas être mis à niveau vers la dernière version de .NET. Tout d’abord, désinstallez-les, puis réinstallez-les à partir du [référentiel de package Ubuntu].

Décider comment installer .NET

Lorsque votre version d’Ubuntu prend en charge .NET par le biais du flux Ubuntu intégré ou des rétroports .NET, la prise en charge de ces versions de .NET est assurée par Canonical et les versions peuvent être optimisées pour des charges de travail différentes. Microsoft fournit la prise en charge des packages dans le flux du dépôt de packages Microsoft.

Utilisez les sections suivantes pour déterminer comment installer .NET :

J’utilise Ubuntu 22.04 ou version ultérieure et j’ai uniquement besoin de .NET

Installez .NET par le biais du flux Ubuntu. Pour plus d'informations, consultez les pages suivantes :

Important

Si vous utilisez le Kit de développement logiciel (SDK) .NET 8 et Ubuntu 22.04, comprenez que les versions du SDK proposées par Canonical sont toujours dans la bande de fonctionnalités .1xx. Si vous souhaitez utiliser une version plus récente de la bande de fonctionnalités, utilisez le flux Microsoft pour installer le SDK. Veillez à consulter les informations de l’article Mélanges de packages .NET sur Linux pour comprendre les implications du basculement entre les flux de dépôt.

Si vous prévoyez d’installer le référentiel Microsoft pour utiliser d’autres packages Microsoft, comme powershell, mdatp ou mssql, vous devez déprioriser les packages .NET fournis par le référentiel Microsoft. Pour obtenir des instructions sur la façon de déprioriser les packages, consultez Ma distribution Linux fournit des packages .NET et je souhaite les utiliser.

J’utilise une version d’Ubuntu antérieure à 22.04

Utilisez les instructions de la page Ubuntu spécifique à la version.

Consultez la section Distributions prises en charge pour plus d’informations sur les versions de .NET prises en charge pour votre version d’Ubuntu. Si vous installez une version qui n’est pas prise en charge, consultez Inscrire le dépôt de packages Microsoft.

J’utilise d’autres packages Microsoft, tels que powershell, mdatp ou mssql

Si votre version d’Ubuntu prend en charge .NET par le biais d’un flux Ubuntu, vous devez décider quel flux doit installer .NET. La section Distributions prises en charge fournit un tableau qui répertorie les versions de .NET disponibles dans les flux de packages.

Si vous souhaitez approvisionner les packages .NET à partir d’un flux Ubuntu, vous devez donner la priorité aux packages .NET fournis par le dépôt Microsoft. Pour obtenir des instructions sur la façon de déprioriser les packages, consultez Ma distribution Linux fournit des packages .NET et je souhaite les utiliser.

Je souhaite créer une application .NET

Utilisez les mêmes sources de package pour le SDK que pour le runtime. Nous vous recommandons d’installer .NET via un flux Ubuntu. Si, toutefois, vous souhaitez installer .NET à partir d’une autre source (par exemple, le Dépôt de packages Microsoft pour accéder à des bandes de fonctionnalités SDK plus élevées), vous devez désinstaller .NET, configurer votre gestionnaire de packages pour qu’il ignore les packages .NET provenant du flux Ubuntu et le réinstaller à partir de l’autre source.

Passez en revue les autres suggestions de la section Décider comment installer .NET.

Je souhaite exécuter une application .NET dans un scénario de conteneur, de cloud ou d’intégration continue

Si votre version d’Ubuntu fournit la version de .NET dont vous avez besoin, installez-la à partir d’un flux Ubuntu. Sinon, inscrivez le dépôt de packages Microsoft et installez .NET à partir de ce dépôt. Passez en revue les informations de la section Distributions prises en charge.

Si la version de .NET souhaitée n’est pas disponible, essayez d’utiliser le script dotnet-install.

Ma distribution Ubuntu n’inclut pas la version .NET souhaitée, ou j’ai besoin d’une version .NET sans prise en charge

Nous vous recommandons d’utiliser APT et le dépôt de packages Microsoft. Pour plus d’informations, consultez la section Inscrire le dépôt de packages Microsoft et effectuer l’installation avec ce dernier.

Je souhaite installer une préversion

Utilisez l’une des méthodes suivantes pour installer .NET :

Je ne veux pas utiliser APT

Si vous souhaitez une installation automatisée, utilisez le script d’installation Linux.

Si vous souhaitez un contrôle total sur l’expérience d’installation de .NET, téléchargez un tarball et installez .NET manuellement. Pour plus d’informations, consultez Installation manuelle.

J’utilise un processeur ARM

Si votre version Ubuntu fournit la version .NET dont vous avez besoin, installez-la à partir du flux intégré. Passez en revue les informations de la section Distributions prises en charge.

Si la version de .NET que vous souhaitez n’est pas disponible, essayez d’utiliser l’une des méthodes suivantes pour installer .NET :

J’utilise la plate-forme IBM System Z

À partir de .NET 8 sur Ubuntu 24.04, Canonical prend en charge .NET pour la plateforme IBM System Z. Canonical prépare actuellement l’extension de la prise en charge à d’autres versions de .NET et d’Ubuntu.

Installez .NET par le biais du flux Ubuntu intégré. Pour plus d’informations, rendez-vous sur la page suivante :

Distributions prises en charge

Le tableau suivant répertorie les versions .NET actuellement prises en charge et les versions d’Ubuntu sur lesquelles elles sont prises en charge. Cliquez sur le lien correspondant à une version d’Ubuntu afin de savoir comment installer .NET pour cette version.

Ubuntu Versions .NET prises en charge Disponible dans
flux Ubuntu intégré		 Disponible dans
Rétroports .NET
Flux Ubuntu		 Disponible dans
Flux Microsoft
24.10 9.0, 8.0 9.0, 8.0 None None
24.04 (LTS) 9.0, 8.0, 6.0 8.0 9.0, 7.0, 6.0 Aucune
22.04 (LTS) 9.0, 8.0, 6.0 8.0, 7.0, 6.0 9.0 8.0, 7.0, 6.0, 3.1
20.04 (LTS) 8.0, 6.0 None None 8.0, 7.0. 6.0, 5.0, 3.1, 2.1

Important

.NET 9 est actuellement en préversion.

Lorsqu’une version d’Ubuntu atteint la fin de sa période de prise en charge, .NET n’est plus pris en charge avec cette version d’Ubuntu.

Canonical prend en charge les versions .NET dans le flux Ubuntu intégré pendant toute la durée de vie de cette version d’Ubuntu, et ce même au-delà de la durée de vie du support fourni par Microsoft. Canonical fournit un support de meilleure qualité pour les versions .NET dans le dépôt des packages de rétroports .NET, qui ne s’étend pas au-delà de la durée de vie du support fourni par Microsoft.

Les versions suivantes de .NET ne sont ❌ plus prises en charge :

  • .NET 7
  • .NET 6 (à compter du 12 novembre 2024)
  • .NET 5
  • .NET Core 3.1
  • .NET Core 3.0
  • .NET Core 2.2
  • .NET Core 2.1
  • .NET Core 2.0

Dépôt des packages de rétroports .NET d’Ubuntu

Le dépôt des packages de rétroports .NET d’Ubuntu fournit des versions de .NET, qui ne sont pas disponibles dans le flux Ubuntu intégré. La section Distributions prises en charge fournit un tableau qui répertorie les versions de .NET disponibles dans les flux de packages. Canonical assure la maintenance des packages contenus dans ce dépôt de packages et fournit un support de meilleure qualité, qui ne dépasse pas la durée de vie du support fourni par Microsoft ou la période de support de la version particulière d’Ubuntu.

Pour obtenir plus de détails, consultez la vue web du référentiel des packages de rétroports .NET d’Ubuntu.

Inscrire le dépôt des packages de rétroports .NET d’Ubuntu

Ouvrez un terminal et exécutez la commande suivante :

sudo add-apt-repository ppa:dotnet/backports

Conseil

Il n’est pas nécessaire d’appeler apt update. La commande add-apt-repository effectue cette opération par défaut.

Remarque

Le dépôt des packages de rétroports .NET d’Ubuntu est compatible avec le flux Ubuntu intégré. Vous n’avez donc pas besoin de configurer votre gestionnaire de packages pour ignorer les packages .NET dans le flux Ubuntu intégré.

Annuler l’inscription du dépôt des packages de rétroports .NET d’Ubuntu

Si vous ne souhaitez plus consommer de packages à partir du dépôt des packages de rétroports .NET d’Ubuntu, vous pouvez l’annuler. Ouvrez un terminal et exécutez la commande suivante :

sudo add-apt-repository --remove ppa:dotnet/backports

Important

L’annulation de l’inscription du dépôt des packages de rétroports .NET d’Ubuntu ne désinstalle aucun package.

La commande add-apt-repository n’a pas été trouvée

L’utilitaire add-apt-repository(1) est préinstallé sur la plupart des installations Ubuntu.

Si vous recevez un message d’erreur indiquant que la commande add-apt-repository n’a pas été trouvée, vous devez installer le package software-properties-common, qui fournit cette commande. Ouvrez un terminal et exécutez les commandes suivantes :

sudo apt update
sudo apt install software-properties-common

Inscrire le dépôt de packages Microsoft

Important

Cela s’applique uniquement aux versions Ubuntu antérieures à la version 24.04. À compter d’Ubuntu 24.04, Microsoft ne publie plus de packages dans le référentiel de packages Microsoft. Utilisez la table de distributions prises en charge pour déterminer la meilleure façon d’installer .NET.

Le référentiel de packages Microsoft contient toutes les versions de .NET qui sont, ou ont été, prises en charge avec votre version d’Ubuntu. Si votre version d’Ubuntu fournit des packages .NET, vous devez déprioriser les packages Ubuntu et utiliser le référentiel Microsoft. Pour obtenir des instructions sur la façon de déprioriser les packages, consultez J’ai besoin d’une version de .NET qui n’est pas fournie par ma distribution Linux.

Important

Le référentiel de packages Microsoft prend en charge seulement les packages .NET qui ciblent l’architecture x64. D’autres architectures, telles que Arm, doivent installer .NET par d’autres moyens, tels que le script d’installation ou par le biais d’une installation manuelle.

Les préversions ne sont pas disponibles dans le dépôt de packages Microsoft. Pour plus d’informations, consultez Installer les préversions.

Attention

Nous vous recommandons d’utiliser un seul dépôt pour gérer toutes vos installations de .NET. Si vous avez déjà installé .NET avec le dépôt Ubuntu, vous devez nettoyer le système des packages .NET et configurer APT pour qu’il ignore les flux Ubuntu. Pour plus d’informations sur la procédure à suivre, consultez J’ai besoin d’une version de .NET qui n’est pas fournie par ma distribution Linux.

L’installation avec APT peut se faire à l’aide de quelques commandes. Avant d’installer .NET, exécutez les commandes suivantes pour ajouter la clé de signature du package Microsoft à votre liste de clés approuvées et ajouter le référentiel de packages.

Ouvrez un terminal et exécutez les commandes suivantes :

# Get OS version info which adds the $ID and $VERSION_ID variables
source /etc/os-release

# Download Microsoft signing key and repository
wget https://packages.microsoft.com/config/$ID/$VERSION_ID/packages-microsoft-prod.deb -O packages-microsoft-prod.deb

# Install Microsoft signing key and repository
sudo dpkg -i packages-microsoft-prod.deb

# Clean up
rm packages-microsoft-prod.deb

# Update packages
sudo apt update

Conseil

Le script précédent a été écrit pour Ubuntu et peut ne pas fonctionner si vous utilisez une distribution dérivée, telle que Linux Mint. Il est probable que les variables et $VERSION_ID les $ID variables ne reçoivent pas les valeurs correctes, ce qui rend l’URI pour la wget commande non valide. Correspond $ID à la distribution (par exemple, ubuntu), tandis que $VERSION_ID les mappages à la version spécifique d’Ubuntu pour laquelle vous souhaitez obtenir des packages, tels que 22.04 ou 23.10.

Par exemple, sur Ubuntu 22.04 $ID serait ubuntu et $VERSION_ID serait 22.04. L’URL se présente comme suit :
https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb.

Vous pouvez utiliser un navigateur web et accéder à https://packages.microsoft.com/config/ubuntu/ pour voir quelles versions d’Ubuntu peuvent être utilisées comme valeur $repo_version.

Installer .NET

Installez .NET via le gestionnaire de package avec la sudo apt install <package-name> commande. Remplacez <package-name> par le nom du package .NET que vous souhaitez installer. Par exemple, pour installer le SDK .NET 8.0, utilisez la commande sudo apt install dotnet-sdk-8.0. Le tableau suivant répertorie les packages .NET actuellement pris en charge (qui peuvent varier selon votre version Ubuntu) :

Produit Type Package
8.0 ASP.NET Core Runtime aspnetcore-runtime-8.0
8.0 .NET Runtime dotnet-runtime-8.0
8.0 .NET Kit SDK dotnet-sdk-8.0
6.0 ASP.NET Core Runtime aspnetcore-runtime-6.0
6.0 .NET Runtime dotnet-runtime-6.0
6.0 .NET Kit SDK dotnet-sdk-6.0

Conseil

Si vous ne créez pas d’applications .NET, installez le runtime ASP.NET Core, car il inclut le runtime .NET et prend également en charge les applications ASP.NET Core.

Certaines variables d’environnement affectent la façon dont .NET est exécuté après son installation. Pour plus d’informations, consultez Variables d’environnement du Kit de développement logiciel (SDK) .NET et de l’interface CLI .NET.

Désinstallation de .NET

Si vous avez installé .NET par le biais d’un gestionnaire de package, procédez de même pour la désinstallation en utilisant la commande apt-get remove :

sudo apt-get remove dotnet-sdk-6.0

Pour plus d’informations, consultez Désinstaller .NET.

Installer des préversions

Les préversions et les versions finales de .NET ne sont pas disponibles dans les dépôts de packages. Vous pouvez installer les préversions et les versions finales de .NET de l’une des manières suivantes :

Supprimer des préversions

Lorsque vous utilisez un gestionnaire de package pour gérer votre installation de .NET, vous pouvez rencontrer un conflit si vous avez déjà installé une préversion. Le gestionnaire de package peut interpréter la version qui ne correspond pas à la préversion comme une version antérieure de .NET. Pour installer la version qui ne correspond pas à la préversion, désinstallez d’abord les préversions. Pour plus d’informations sur la désinstallation de .NET, consultez Comment supprimer le runtime et le kit de développement logiciel (SDK) .NET.

Utiliser APT pour mettre à jour .NET

Si vous avez installé .NET par le biais d’un gestionnaire de package, vous pouvez mettre à niveau le package avec la commande apt upgrade. Par exemple, les commandes suivantes mettent à niveau le package dotnet-sdk-8.0 avec la dernière version :

sudo apt update
sudo apt upgrade dotnet-sdk-8.0

Conseil

Si vous avez mis à niveau votre distribution Linux depuis l’installation de .NET, vous devrez peut-être reconfigurer le référentiel de packages Microsoft. Exécutez les instructions d’installation de votre version de distribution actuelle pour effectuer une mise à niveau vers le référentiel de packages approprié pour les mises à jour .NET.

Résolution des problèmes

À compter d’Ubuntu 22.04, vous pourriez rencontrer une situation où il semble que seul un élément de .NET soit disponible. Par exemple, vous avez installé le runtime et le SDK, mais lors de l’exécution de dotnet --info, seul le runtime est listé. Cette situation peut être liée à l’utilisation de deux sources de package différentes. Les flux de package Ubuntu 22.04 et Ubuntu 22.10 intégrés incluent certaines versions de .NET, mais pas toutes, et vous avez peut-être également installé .NET à partir des flux Microsoft. Pour plus d’informations sur la résolution de ce problème, consultez Résoudre les erreurs .NET liées à des fichiers manquants sur Linux.

Problèmes liés à APT

Cette section fournit des informations sur les erreurs courantes que vous pourriez rencontrer lorsque vous utilisez APT pour installer .NET.

Le package est introuvable

Important

L’utilisation d’un gestionnaire de package pour installer .NET à partir du flux de package Microsoft prend uniquement en charge l’architecture x64. Les autres architectures, comme Arm, ne sont pas prises en charge par le flux de package Microsoft.

Pour plus d’informations sur l’installation de .NET sans gestionnaire de package, consultez l’un des articles suivants :

Package introuvable\Certains packages n’ont pas pu être installés

Notes

Ces informations s’appliquent uniquement lorsque .NET est installé à partir du flux de package Microsoft.

Si vous recevez un message d’erreur semblable à Le package {dotnet-package} est introuvable ou Certains packages n’ont pas pu être installés, exécutez les commandes suivantes.

Il existe deux espaces réservés dans l’ensemble de commandes suivant.

  • {dotnet-package}
    Celui-ci représente le package .NET que vous installez (par exemple, aspnetcore-runtime-8.0). Il est utilisé dans la commande sudo apt-get install suivante.

Commencez par essayer de vider la liste des packages :

sudo dpkg --purge packages-microsoft-prod && sudo dpkg -i packages-microsoft-prod.deb
sudo apt-get update

Réessayez ensuite d’installer .NET. Si cela ne fonctionne pas, vous pouvez effectuer une installation manuelle avec les commandes suivantes :

Si vous utilisez Ubuntu 23.10 ou ultérieur, essayez les commandes suivantes :

# Get OS version info which adds the $ID and $VERSION_ID variables
source /etc/os-release

# Download the Microsoft keys
sudo apt-get install -y gpg wget
wget https://packages.microsoft.com/keys/microsoft.asc
cat microsoft.asc | gpg --dearmor -o microsoft.asc.gpg

# Add the Microsoft repository to the system's sources list
wget https://packages.microsoft.com/config/$ID/$VERSION_ID/prod.list
sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list

# Move the key to the appropriate place
sudo mv microsoft.asc.gpg $(cat /etc/apt/sources.list.d/microsoft-prod.list | grep -oP "(?<=signed-by=).*(?=\])")

# Update packages and install .NET
sudo apt-get update && \
  sudo apt-get install -y {dotnet-package}

Si vous utilisez une version d’Ubuntu antérieure à 23.10, essayez les commandes suivantes :

# Define the OS version, name, and codename
source /etc/os-release

# Download the Microsoft keys
sudo apt-get install -y gpg wget
wget https://packages.microsoft.com/keys/microsoft.asc
cat microsoft.asc | gpg --dearmor -o microsoft.asc.gpg
sudo mv microsoft.asc.gpg /etc/apt/trusted.gpg.d/

# Add the Microsoft repository to the system's sources list
wget https://packages.microsoft.com/config/$ID/$VERSION_ID/prod.list
sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list

# Set ownership
sudo chown root:root /etc/apt/trusted.gpg.d/microsoft.asc.gpg
sudo chown root:root /etc/apt/sources.list.d/microsoft-prod.list

# Update packages and install .NET
sudo apt-get update && \
  sudo apt-get install -y {dotnet-package}

Extraction impossible

Lors de l’installation du package .NET, vous pouvez voir une erreur semblable à Failed to fetch ... File has unexpected size ... Mirror sync in progress?. Celle-ci peut signifier que le flux de package pour .NET est en cours de mise à niveau avec des versions plus récentes du package, et que vous devez réessayer ultérieurement. Pendant une mise à niveau, le flux de package ne doit pas être indisponible pendant plus de 30 minutes. Si vous recevez continuellement cette erreur pendant plus de 30 minutes, veuillez signaler le problème à l’adresse https://github.com/dotnet/core/issues.

Les dépendances

Lorsque vous effectuez une installation avec un gestionnaire de package, ces bibliothèques sont installées pour vous. Toutefois, si vous installez manuellement .NET ou que vous publiez une application autonome, vous devez installer ces dépendances pour exécuter votre application :

  • ca-certificates
  • libc6
  • libgcc1 (pour 16.x et 18.x)
  • libgcc-s1 (pour 20.x ou ultérieure)
  • libgssapi-krb5-2
  • libicu55 (pour 16.x)
  • libicu60 (pour 18.x)
  • libicu66 (pour 20.x)
  • libicu70 (pour 22.04)
  • libicu72 (pour la version 23.10)
  • libicu74 (pour la version 24.04 ou ultérieure)
  • liblttng-ust1 (pour 22.x ou ultérieur)
  • libssl1.0.0 (pour 16.x)
  • libssl1.1 (pour 18.x, 20.x)
  • libssl3 (pour 22.x ou ultérieur)
  • libstdc++6
  • libunwind8 (pour 22.x ou ultérieur)
  • zlib1g

Les dépendances peuvent être installées avec la commande apt install. L’extrait de code suivant illustre l’installation de la bibliothèque zlib1g :

sudo apt install zlib1g

Si l’application .NET utilise l’assembly System.Drawing.Common, libgdiplus doit également être installé. Étant donné que System.Drawing.Common n’est plus pris en charge sur Linux, cela fonctionne uniquement sur .NET 6 et nécessite de définir le commutateur de configuration du runtime System.Drawing.EnableUnixSupport.

Vous pouvez installer une version récente de libgdiplus en ajoutant le référentiel Mono à votre système.

Étapes suivantes