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.

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 ?

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> où <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 :

• Installer Windows ou Windows TerminalTerminal (préversion) à partir du Microsoft Store
• Utiliser la palette de commandes
• Configurer des actions personnalisées comme les raccourcis clavier pour rendre le terminal naturel à vos préférences
• Configurer le profil de démarrage par défaut
• Personnalisez l’apparence : thème, jeux de couleurs, nom et répertoire de départ, image d’arrière-plan, etc.
• Découvrez comment utiliser des arguments de ligne de commande comme l’ouverture d’un terminal avec plusieurs lignes de commande divisées en volets de fenêtres ou onglets
• En savoir plus sur la fonctionnalité de recherche
• Trouver des conseils et des astuces, comme comment renommer ou colorer un onglet, utiliser des interactions de souris ou activer le « mode Quake »
• Rechercher des tutoriels sur la configuration d’une invite de commandes personnalisée, de profils SSH ou de titres d’onglet
• Rechercher une galerie de terminaux personnalisée et un guide de résolution des problèmes

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$

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 de développement 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.

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.

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.

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.

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.

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

Suivez ce guide pas à pas pour configurer l’apprentissage machine learning accéléré gpu dans WSL et tirer parti du GPU (unité de traitement graphique) de votre ordinateur pour accélérer les charges de travail lourdes de performances.

Commandes WSL de base

Les distributions Linux que vous installez via WSL sont les 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 :

• Exécutez des outils Linux à partir d’une ligne de commande Windows : Ouvrez PowerShell et affichez le contenu du répertoire de l’utilisation de C:\temp> la commande Linux ls -la en entrant : wsl ls -la

• Mélanger des commandes Linux et Windows : dans cet exemple, la commande ls -la Linux est utilisée pour répertorier les fichiers dans le répertoire, puis la commande findstr PowerShell permet de filtrer les résultats pour les mots contenant « git » : wsl ls -la | findstr "git". Cela peut également être effectué en mélangeant la commande Windows dir avec la commande Linux grep : dir | wsl grep git.

• Exécutez un outil Windows directement à partir de la ligne de commande WSL : <tool-name>.exe par exemple, pour ouvrir votre fichier .bashrc (le script shell qui s’exécute chaque fois que votre ligne de commande Linux est démarrée), entrez : notepad.exe .bashrc

• Exécutez l’outil Windows ipconfig.exe avec l’outil Linux Grep : ipconfig.exe | grep IPv4 | cut -d: -f2 cet exemple montre l’outil ipconfig sur le système de fichiers Windows utilisé pour afficher les valeurs de configuration réseau TCP/IP actuelles, puis filtré sur le résultat IPv4 uniquement avec grep, un outil Linux.

Monter un lecteur externe ou usb

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

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

• Configurez votre environnement de développement sur Windows : apprenez-en davantage sur la configuration de votre environnement de développement pour votre langage ou infrastructure préféré, comme React, Python, NodeJS, Vue, etc.
• Résolution des problèmes : recherchez des problèmes courants, où signaler des bogues, où demander de nouvelles fonctionnalités et comment contribuer aux documents.
• FAQ : Recherchez une liste de questions fréquentes.
• Notes de publication : passez en revue les notes de publication WSL pour obtenir un historique des mises à jour de build précédentes. Vous trouverez également les notes de publication du noyau Linux WSL.