Configurer un environnement de développement WSL

Un guide pas à pas des bonnes pratiques de configuration d’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 qui peut être configuré pour installer d’autres distributions Linux, utiliser des commandes WSL de base, configurer Visual Studio Code ou Visual Studio, Git, le Gestionnaire d’informations d’identification Windows, des bases de données comme MongoDB, Postgres ou MySQL, configurer l’accélération de GPU, exécuter des applications de GUI et plus encore.

Prise en main

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

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

wsl --install

La --install commande 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 Linux Ubuntu (un redémarrage peut être nécessaire)

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

Consultez l’article sur la résolution des problèmes d’installation si vous rencontrez des problèmes.

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

Une fois le processus d’installation de votre distribution Linux avec WSL terminé, ouvrez la distribution (Ubuntu par défaut) avec le menu Démarrer. Il vous sera demandé de 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 rien ne s’affiche à l’écran quand vous entrez le mot de passe. Cela s’appelle la saisie à l’aveugle. Vous ne verrez pas ce que vous tapez, ce qui est tout à fait 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 sera considéré comme le compte administrateur Linux et pourra exécuter des commandes d’administration sudo (Super User Do).

• Chaque distribution Linux exécutée sur WSL a 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.

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 accédez à la racine de votre distribution WSL par défaut à l’aide de la commande : wsl -u root

   Si vous devez réinitialiser le mot de passe oublié sur une distribution qui n’est pas votre distribution par défaut, utilisez la commande : wsl -d <DistroName> -u root, en remplaçant <DistroName> par le nom de votre distribution cible.

2. Une fois votre distribution WSL ouverte à la racine dans PowerShell, vous pouvez utiliser cette commande pour réinitialiser votre mot de passe : passwd <username>, où <username> est 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 qu’il vous est indiqué que le mot de passe a bien été mis à jour, fermez WSL dans PowerShell à l’aide de la commande : exit

Mettre à jour et mettre à niveau des packages

Nous vous recommandons de mettre régulièrement à jour et à niveau 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 les installer via le Microsoft Store, via la commande --import, ou en chargeant manuellement votre propre distribution personnalisée. Vous pouvez également configurer des images WSL personnalisées à distribuer au sein de votre entreprise.

Configurer Windows Terminal

Windows Terminal peut exécuter n’importe quelle application dotée d’une interface en 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 Linux pour WSL est installée, une nouvelle instance est créée pour celle-ci dans le Windows Terminal, et peut être personnalisée selon vos préférences.

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

• Installer Windows Terminal ou Windows Terminal (préversion) depuis le 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, schémas de couleurs, nom et répertoire de démarrage, 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être ou onglets
• En savoir plus sur la fonctionnalité de recherche
• Découvrir conseils et astuces, par exemple comment renommer un onglet ou lui attribuer une couleur, utiliser la souris ou activer le « mode Quake »
• Découvrez des tutoriels pour configurer une invite de commandes personnalisée, des profils SSH ou des titres d’onglet
• Rechercher une galerie de terminaux personnalisées et un guide de résolution des problèmes

Stockage Fichier

• Pour ouvrir votre projet WSL dans l’Explorateur de fichiers Windows, entrez : explorer.exe .

  Veillez à ajouter le point à la fin de la commande pour ouvrir le répertoire actuel.

• Stocker vos fichiers de projet sur le même système d’exploitation que celui utilisé par les outils que vous comptez utiliser.

  Pour des performances de vitesse optimales, stockez vos fichiers dans le système de fichiers WSL si vous travaillez dessus avec des outils Linux dans une ligne de commande Linux (Ubuntu, OpenSUSE, etc.). Si vous utilisez une ligne de commande Windows (PowerShell, invite de commandes) avec des outils Windows, stockez vos fichiers dans le système de fichiers Windows. Les fichiers sont accessibles à travers tous les systèmes d’exploitation, mais cela peut 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
• Pas 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 préféré

Nous vous recommandons d’utiliser Visual Studio Code ou Visual Studio, car ils prennent directement en charge le développement et le débogage à distance avec WSL. Visual Studio Code vous permet d’utiliser WSL en tant qu’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 étape par étape pour commencer à utiliser Visual Studio Code avec WSL, qui inclut l'installation de l'extension WSL. Cette extension vous permet d’utiliser WSL comme environnement de développement complet directement à partir de VS Code. Échangez rapidement entre différents environnements de développement distincts et effectuez des mises à jour sans vous soucier de l’impact sur votre ordinateur local.

Une fois VS Code installé et configuré, vous pouvez ouvrir votre projet WSL à l’aide d’un serveur distant VS Code en entrant : code .

Veillez à ajouter le point à la fin de la commande pour ouvrir le répertoire actuel.

Utiliser Visual Studio

Suivez ce guide pas à pas pour bien démarrer avec Visual Studio avec WSL pour le développement multiplateforme C++. Visual Studio 2022 vous permet de créer et déboguer des projets CMake sur Windows, sur des distributions WSL et sur 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, connecter votre projet au système de contrôle de version Git, utiliser le gestionnaire d’identifiants pour l’authentification, les fichiers .gitignore, comprendre les fins de ligne dans Git et utiliser les commandes Git intégrées à VS Code.

Configuration de conteneurs de développement distants avec Docker

Suivez ce guide pas à pas pour la prise en main des conteneurs distants Docker sur WSL 2 et connectez votre projet à un conteneur de développement distant à l’aide de Docker Desktop pour Windows.

Configurer une base de données

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

Configurer l’accélération par GPU pour des performances plus rapides

Suivez ce guide pas à pas pour configurer l’entraînement de modèles de machine learning accéléré par GPU dans WSL et exploiter le GPU (processeur graphique) de votre ordinateur afin d’accélérer les charges de travail très exigeantes en calcul.

Commandes WSL basiques

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 consulter une liste des commandes de base à connaître lors de l’utilisation de WSL.

En outre, de nombreuses commandes peuvent être utilisées à la fois sur Windows et sur Linux. Voici quelques exemples :

• Exécuter des outils Linux depuis une ligne de commande Windows : ouvrez PowerShell et affichez le contenu du répertoire de C:\temp> à l’aide de la commande Linux ls -la en entrant : wsl ls -la

• Mélanger des commandes Linux et Windows : dans cet exemple, la commande Linux ls -la est utilisée pour répertorier les fichiers dans le répertoire, puis la commande PowerShell findstr est utilisée pour ne conserver que les mots contenant « git » : wsl ls -la | findstr "git". Cela peut également se faire en combinant la commande Windows dir avec la commande Linux grep : dir | wsl grep git.

• Exécuter un outil Windows directement depuis 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 démarre), entrez : notepad.exe .bashrc

• Exécutez l’outil Windows ipconfig.exe avec l’outil Linux grep : depuis Bash, entrez la commande ipconfig.exe | grep IPv4 | cut -d: -f2 ou, depuis PowerShell, entrez ipconfig.exe | wsl grep IPv4 | wsl cut -d: -f2 Cet exemple montre l’outil ipconfig du système de fichiers Windows utilisé pour afficher les valeurs actuelles de configuration réseau TCP/IP, puis filtré avec grep, un outil Linux, afin de ne conserver que le résultat IPv4.

Monter un lecteur externe ou un périphérique USB

Suivez ce guide étape par étape pour commencer à monter un disque Linux dans WSL 2.

Exécuter des applications GUI Linux

Suivez ce tutoriel pour apprendre à configurer et à exécuter des applications Linux avec interface graphique sur WSL.

Ressources supplémentaires

• Configurer votre environnement de développement sur Windows : découvrez comment configurer votre environnement de développement pour votre langage ou framework préféré, comme React, Python, NodeJS, Vue, etc.
• Résolution des problèmes : trouvez les problèmes courants, où signaler les bogues, où demander de nouvelles fonctionnalités et comment contribuer à la documentation.
• FAQ : Consultez une liste de questions fréquemment posées.
• Notes de publication : consultez les notes de publication de WSL pour consulter l’historique des mises à jour des versions précédentes. Vous pouvez également consulter les notes de version du noyau Linux de WSL.