Configurer un environnement de développement WSL

Guide pas à pas sur les meilleures pratiques pour configurer un environnement de développement WSL. Découvrez comment exécuter la commande pour installer l’interpréteur de commandes Bash par défaut qui utilise Ubuntu ou peut être défini pour installer d’autres distributions Linux, utiliser des commandes WSL de base, configurer Visual Studio Code ou Visual Studio, Git, Windows Credential Manager, bases de données telles que MongoDB, Postgres ou MySQL, configurer l’accélération GPU, exécuter des applications GUI, etc.

Bien démarrer

Sous-système Windows pour Linux est fourni avec le système d’exploitation Windows, mais vous devez l’activer et installer une distribution Linux avant de pouvoir commencer à l’utiliser.

Pour utiliser la commande simplifiée --install, vous devez exécuter une version récente de Windows (build 20262+). Pour vérifier votre numéro de version et de build, sélectionnez la touche Windows + R, tapez winver et sélectionnez OK. Vous pouvez effectuer une mise à jour à l’aide du menu Paramètres ou de l’Assistant Windows Update.

Si vous préférez installer une distribution Linux autre que Ubuntu, ou préférez effectuer ces étapes manuellement, consultez la page d’installation de WSL pour plus d’informations.

Ouvrez PowerShell (ou invite de commandes Windows) et entrez :

wsl --install

La commande --install effectue les actions suivantes :

  • Active les composants facultatifs de WSL et de la plateforme de machine virtuelle
  • Télécharge et installe le dernier noyau Linux
  • Définit WSL 2 comme valeur par défaut
  • Télécharge et installe la distribution Ubuntu Linux (le redémarrage peut être nécessaire)

Vous devez redémarrer votre ordinateur pendant ce processus d’installation.

Ligne de commande PowerShell exécutant wsl --install

Vérifiez l’article d’installation de résolution des problèmes si vous rencontrez des problèmes.

Configurer votre nom d’utilisateur et votre mot de passe Linux

Une fois que le processus d’installation de votre distribution Linux avec WSL est terminé, ouvrez la distribution (Ubuntu par défaut) à l’aide du menu Démarrer. Vous êtes invité à créer un nom d’utilisateur et un mot de passe pour votre distribution Linux.

  • Ce nom d’utilisateur et ce mot de passe sont propres à chaque distribution Linux distincte que vous installez et n’ont aucune incidence sur votre nom d’utilisateur Windows.

  • Notez que lorsque vous entrez le mot de passe, rien n’apparaît à l’écran. Ceci est appelé tapage aveugle. Vous ne verrez pas ce que vous tapez, c’est complètement normal.

  • Une fois que vous avez créé un nom d’utilisateur et un mot de passe, le compte devient votre utilisateur par défaut pour la distribution et se connecte automatiquement au démarrage.

  • Ce compte est considéré comme l’administrateur Linux, avec la capacité d’exécuter des commandes d’administration sudo (Super User Do).

  • Chaque distribution Linux exécutée sur WSL possède ses propres comptes d’utilisateur et mots de passe Linux. Vous devez configurer un compte d’utilisateur Linux chaque fois que vous ajoutez, réinstallez ou réinitialisez une distribution.

Notes

Les distributions Linux installées avec WSL correspondent à une installation par utilisateur et ne peuvent pas être partagées avec d’autres comptes d’utilisateur Windows. Rencontrez une erreur de nom d’utilisateur ? StackExchange : Quels caractères dois-je utiliser ou non dans les noms d’utilisateur sur Linux ?

La ligne de commande Ubuntu entrez le nom d’utilisateur UNIX

Pour modifier ou réinitialiser votre mot de passe, ouvrez la distribution Linux et entrez la commande : passwd Vous êtes invité à entrer votre mot de passe actuel, à entrer votre nouveau mot de passe, puis à confirmer votre nouveau mot de passe.

Si vous avez oublié le mot de passe de votre distribution Linux :

  1. Ouvrez PowerShell et entrez la racine de votre distribution WSL par défaut en utilisant la commande : wsl -u root

    Si vous devez mettre à jour le mot de passe oublié sur une distribution qui n’est pas celle par défaut, utilisez la commande : wsl -d Debian -u root en remplaçant Debian par le nom de votre distribution ciblée.

  2. Une fois que votre distribution WSL a été ouverte au niveau racine à l’intérieur de PowerShell, vous pouvez utiliser cette commande pour mettre à jour votre mot de passe : passwd <username><username> se trouve le nom d’utilisateur du compte dans la distribution dont vous avez oublié le mot de passe.

  3. Vous serez invité à entrer un nouveau mot de passe UNIX, puis à confirmer ce mot de passe. Une fois que vous avez dit que le mot de passe a été mis à jour, fermez WSL à l’intérieur de PowerShell à l’aide de la commande : exit

Mettre à jour et mettre à niveau des packages

Nous vous recommandons de mettre à jour et de mettre à niveau régulièrement vos packages à l’aide du gestionnaire de package préféré pour la distribution. Pour Ubuntu ou Debian, utilisez la commande :

sudo apt update && sudo apt upgrade

Windows ne met pas automatiquement à jour ou à niveau vos distributions Linux. Il s’agit d’une tâche que la plupart des utilisateurs Linux préfèrent contrôler eux-mêmes.

Ajouter des distributions supplémentaires

Pour ajouter des distributions Linux supplémentaires, vous pouvez installer via le Microsoft Store, via la commande --import ou en chargeant votre propre distribution personnalisée. Vous pouvez également configurer des images WSL personnalisées pour la distribution dans votre entreprise.

Configurer Windows Terminal

Windows Terminal peut exécuter n’importe quelle application avec une interface de ligne de commande. Ses principales fonctionnalités comprennent un affichage multi-onglet, des volets, une prise en charge des caractères Unicode et UTF-8, un moteur de rendu de texte accéléré par GPU, ainsi que la possibilité de créer vos propres thèmes et de personnaliser le texte, les couleurs, les arrière-plans et les touches de raccourci.

Chaque fois qu’une nouvelle distribution WSL Linux est installée, une nouvelle instance est créée pour celle-ci dans Windows Terminal qui peut être personnalisée à vos préférences.

Nous vous recommandons d’utiliser WSL avec Windows Terminal, en particulier si vous envisagez d’utiliser plusieurs lignes de commande. Consultez les documents Windows Terminal pour obtenir de l’aide sur la configuration et la personnalisation de vos préférences, notamment :

Capture d’écran Windows Terminal

Stockage Fichier

  • Pour ouvrir votre projet WSL dans Windows Explorateur de fichiers, entrez :explorer.exe .
    Veillez à ajouter la période à la fin de la commande pour ouvrir le répertoire actif.

  • Stockez vos fichiers projet sur le même système d’exploitation que les outils que vous envisagez d’utiliser.
    Pour obtenir la vitesse de performances la plus rapide, stockez vos fichiers dans le système de fichiers WSL si vous travaillez sur eux avec des outils Linux dans une ligne de commande Linux (Ubuntu, OpenSUSE, etc.). Si vous travaillez dans une ligne de commande Windows (PowerShell, Invite de commandes) avec les outils Windows, stockez vos fichiers dans le système de fichiers Windows. Les fichiers sont accessibles sur les systèmes d’exploitation, mais ils peuvent ralentir considérablement les performances.

Par exemple, lors du stockage de vos fichiers de projet WSL :

  • Utilisez le répertoire racine du système de fichiers Linux : \\wsl$\<DistroName>\home\<UserName>\Project
  • Et non le répertoire racine du système de fichiers Windows : C:\Users\<UserName>\Project ou /mnt/c/Users/<UserName>/Project$

Windows Explorateur de fichiers affichant le stockage Linux

Configurer votre éditeur de code favori

Nous vous recommandons d’utiliser Visual Studio Code ou Visual Studio, car ils prennent directement en charge le développement à distance et le débogage avec WSL. Visual Studio Code vous permet d’utiliser WSL comme environnement de développement complet. Visual Studio offre une prise en charge native de WSL pour le développement multiplateforme C++.

Utiliser Visual Studio Code

Suivez ce guide pas à pas pour commencer à utiliser Visual Studio Code avec WSL, qui inclut l’installation du pack d’extension développement à distance. Cette extension vous permet d’exécuter WSL, SSH ou un conteneur distant pour la modification et le débogage avec l’ensemble complet des fonctionnalités de Visual Studio Code. Échangez rapidement entre différents environnements de développement distincts et effectuez des mises à jour sans vous soucier de l’impact de votre ordinateur local.

Une fois VS Code installé et configuré, vous pouvez ouvrir votre projet WSL avec un serveur distant VS Code en entrant : code .

Veillez à ajouter la période à la fin de la commande pour ouvrir le répertoire actif.

VS Code avec des extensions WSL affichées

Utiliser Visual Studio

Suivez ce guide pas à pas pour commencer à utiliser Visual Studio avec WSL pour le développement multiplateforme C++. Visual Studio 2022 vous permet de générer et de déboguer des projets CMake sur Windows, des distributions WSL et des connexions SSH à partir de la même instance de Visual Studio.

Sélectionner un système cible dans Visual Studio 2022

Configurer la gestion des versions avec Git

Suivez ce guide pas à pas pour commencer à utiliser Git sur WSL et connecter votre projet au système de contrôle de version Git, ainsi qu’à l’aide du gestionnaire d’informations d’identification pour l’authentification, à l’aide de fichiers Git Ignore, comprendre les terminaisons de ligne Git et utiliser les commandes Git intégrées à VS Code.

Affichage de la version git dans la ligne de commande

Configurer des conteneurs de développement à distance avec Docker

Suivez ce guide pas à pas pour bien démarrer avec les conteneurs distants Docker sur WSL 2 et connecter votre projet à un conteneur de développement distant avec Docker Desktop pour Windows.

Capture d’écran de Docker Desktop

Configurer une base de données

Suivez ce guide pas à pas pour bien démarrer avec les bases de données sur WSL et connecter votre projet à une base de données dans l’environnement WSL. Prise en main de MySQL, PostgreSQL, MongoDB, Redis, Microsoft SQL Server ou SQLite.

Exécution de MongoDB dans Ubuntu via WSL

Configurer l’accélération GPU pour accélérer les performances

Suivez ce guide pas à pas pour configurer l’entraînement Machine Learning accéléré par GPU dans WSL et tirer parti du GPU de votre ordinateur (unité de traitement graphique) pour accélérer les charges de travail lourdes en termes de performances.

Exécution de l’accélération GPU avec WSL

Commandes WSL de base

Les distributions Linux que vous installez via WSL sont mieux gérées à l’aide de PowerShell ou de l’invite de commandes Windows (CMD). Consultez le guide de référence des commandes WSL pour obtenir la liste des commandes de base à connaître lors de l’utilisation de WSL.

De plus, de nombreuses commandes sont interopérables entre Windows et Linux. Voici quelques exemples :

Monter un lecteur externe ou usb

Suivez ce guide pas à pas pour commencer à monter un disque Linux dans WSL 2.

Capture d’écran de la commande de montage wsl

Exécuter des applications GUI Linux

Suivez ce tutoriel pour découvrir comment configurer et exécuter des applications GUI Linux sur WSL.

Ressources supplémentaires