✎ wsl [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

-----
{{ http://i.imgur.com/rV7ScCV.png?80|}}

====== Sous-système Windows pour Linux : Ubuntu sur Windows ======
<note important>La version WSL2 est maintenant disponible. Elle est annoncée comme étant aussi performante qu'une installation standard.   Voir documentation  [[https://wiki.ubuntu.com/WSL|anglaise]]</note>

//Ubuntu sur Windows// est une variante d'Ubuntu proposée officiellement par Microsoft et [[:Canonical]], et qui se déploie nativement sur **Windows 10** (uniquement) au moyen de la couche de compatibilité **//WSL//**.

Le //Windows Subsystem for Linux// (WSL), en français "Sous-système Windows pour Linux", parfois grossièrement appelé "Bash sur Windows" est une **couche de compatibilité** permettant d'exécuter des fichiers ELF (binaires exécutables) pour Linux à partir d'un système Windows.\\ 
Le principe est le même que [[:Wine]], mais "dans l'autre sens".

<note>Le but de cette distribution est de simplifier le travail des développeurs (en particulier dans le domaine du web) en rendant possible la mise en place d'une structure et d'outils Linux sous Windows, et ainsi d'harmoniser les environnements de développement Windows avec les environnements GNU/Linux qu'on trouve couramment sur les serveurs de production.

Cet outil n'est donc **pas destiné au grand public** et son intérêt n'est pas de déployer "nativement" un environnement de bureau GNU/Linux sous Windows, même si c'est techniquement envisageable.</note>

Le WSL ne permet pas de faire fonctionner n'importe quelle distribution : seules les [[:lts|versions LTS]] d'Ubuntu sont supportées. La première distribution Linux concernée fut [[:Trusty]] (14.04), puis [[:Xenial]] (16.04) et maintenant [[:Bionic]] (18.04).\\ 
D'autres distributions GNU/Linux sont également proposées : [[wpfr>Debian]], [[wpfr>openSUSE]], [[wpfr>SUSE Linux Enterprise]] et [[wpfr>Kali Linux]].

Les applications graphiques ne fonctionnent pas aussi facilement que les applications en ligne de commande, car elles nécessitent un [[:Xorg|serveur d'affichage X]] externe, et les applications utilisant certaines fonctionnalités très spécifiques du noyau [[:Linux]] risquent aussi de rencontrer des problèmes.

===== Pré-requis =====

* Une copie à jour de Windows 10 de type 64 bits.

* Une session Windows avec les droits d'administrateur.

Pour savoir si votre système est compatible, allez dans les **Paramètres -> Système -> Informations Système**. Regardez la //build// du système ("Version du système d'exploitation") et son type ("Type du système").

===== Installation =====

==== Installer le système principal ====

Autoriser [[https://docs.microsoft.com/fr-fr/windows/wsl/install-win10|l'application]] à fonctionner.
         
Ubuntu sur Windows s'installe depuis le [[https://www.microsoft.com/fr-fr/p/ubuntu/9nblggh4msv6|Microsoft Store]].

Sur le Microsoft Store vous avez le choix entre plusieurs version d'Ubuntu (et également d'autres variantes de Linux).
  * L'application //Ubuntu// (tout court) installe la dernière version [[:LTS]] et pourra être mise à niveau d'une version LTS à la suivante via la commande ''do-release-upgrade''.
  * //Ubuntu 16.04// installe [[:Xenial]].
  * //Ubuntu 18.04// installe [[:Bionic]].
  * //Ubuntu 20.04// installe [[:Focal]]

Il n'est pas indispensable de créer un compte Microsoft ni de s'identifier pour télécharger ces applications.

Il est possible d'utiliser plusieurs de ces applications simultanément. Vous trouverez de l'aide pour les faire cohabiter (ou sélectionner la distribution par défaut) sur la [[https://docs.microsoft.com/fr-fr/windows/wsl/wsl-config#managing-multiple-linux-distributions|documentation officielle]].

Une fois l'application installée, lancez-la.  Son nom est **Ubuntu** , et vous devriez voir apparaître un message //Installing, this may take a few minutes...//\\  
( Compter 5 minutes sur un SSD et  15 minutes sur un disque dur.)
Après quoi vous devriez être invité·e à entrer un identifiant et un mot de passe.
==== Installer les logiciels voulus ====

Le système installé permet d'utiliser des applications en ligne de commande ([[:nano]], [[:vim]], [[:ssh]], [[:git]], [[:nodejs|npm]], [[:ruby|gem]], ...), des applications sans interface graphique ([[:apache]], [[:nginx]], [[:mysql]], [[:nodejs]], [[:ruby]], ...) et d'exécuter des scripts bash.

La gestion des paquets en ligne de commande se fait comme sur un système Ubuntu normal, au moyen de la commande ''[[:apt-cli|apt]]'', par exemple.

Dans le terminal //Ubuntu//, tapez tout d'abord : 
<code>sudo apt update</code>
<code>sudo apt upgrade</code>

Puis, par exemple si on veut utiliser l'éditeur de texte [[:vim]] :
<code>sudo apt install vim</code>

==== Installer un serveur X ====

Pour pouvoir lancer des applications graphiques, il faut installer un serveur X externe pour Windows, comme [[https://en.wikipedia.org/wiki/Xming|Xming]] ou [[https://sourceforge.net/projects/vcxsrv/|VcXsrv]].

Installez par exemple la dernière version de **VcXsrv** depuis sa [[https://sourceforge.net/projects/vcxsrv/|page SourceForge]], c'est le serveur d'affichage qui sera utilisé dans la suite de cet article.

===== Paramétrage de base =====

Les paramétrages applicables au shell [[:bash]] devraient être valables ici (prompt, couleurs, etc.).

==== Paramétrage du serveur X ====

Cliquez sur XLaunch, qui a du apparaître dans votre menu démarrer suite à l'installation de VcXsrv.

Le mode "multiple windows" permet d'utiliser chaque application graphique Linux dans une fenêtre différente du bureau Windows 10, alors que les autres modes permettent de réunir toutes les applications graphiques Linux dans une seule fenêtre (avec ou sans barre de titre, voire en plein écran). \\
Faites attention à bien régler "0" dans le champ en bas.

<note>Les autres paramètres (après avoir cliqué sur //Suivant//) ont des valeurs par défaut normalement correctes.

Un message d'erreur suggérant qu'il manque des fichiers .log peut apparaître après avoir cliqué sur //Terminer//, il ne m'a personnellement pas gêné pour la suite.</note>

<note tip>Lorsque cette application va se lancer, le parefeu Windows va s'activer et dire qu'il empêche les communications. Il faudra autoriser</note>

==== Paramétrages divers ====
Ensuite, éditez le fichier ''~/.bashrc'' (dans le terminal //Ubuntu//) :

<code>nano .bashrc</code>

À la fin du fichier, ajoutez la ligne
<code>export DISPLAY=localhost:0.0</code>

<note>Pour WSL 2, rajouter cette ligne ([[https://github.com/microsoft/WSL/issues/4106#issuecomment-511264459|source]]) :
<code>export DISPLAY=$(grep -oP "(?<=nameserver ).+" /etc/resolv.conf):0</code></note>

<note>Pour WSL2 et Ubuntu 20.04  le même lien donne la bonne commande
<code bash>  export WSL_HOST=$(dig +noall +answer $(hostname -s) | tail -1 | cut -f 6)
 export DISPLAY=$WSL_HOST:0.0</code></note>

Fermez [[:nano]] en enregistrant. Fermez la fenêtre Ubuntu, et relancez-la depuis le menu démarrer. Il devrait normalement être possible de lancer des applications graphiques, mais des erreurs peuvent subsister :

==== Paramétrage de DBus ====
<note warning>A ne pas prendre en compte avec WSL 2 !</note>

Le WSL n'a pas vraiment été conçu pour les applications //desktop// : un message d'erreur devrait vite vous indiquer des problèmes avec DBus.

Avec la commande
<code>sudo nano /usr/share/dbus-1/session.conf</code>

éditez le fichier de configuration de DBus et changez-y
<file><listen>unix:tmpdir=/tmp</listen></file>

par
<file><listen>tcp:host=localhost,port=0</listen></file>

Enregistrez le fichier. \\
Fermez puis ré-ouvrez "Bash sur Ubuntu sur Windows" afin que les modifications prennent effet.

===== Utilisation =====

==== Vérification du mode graphique ====

Il est possible d'installer un éditeur de fichier en mode graphique, par exemple **vim** avec une commande de ce style:
<code>sudo apt install vim-gtk</code>
Puis de vérifier le bon fonctionnement,par exemple avec ces commandes:
<code>echo essai > ESSAI.txt
gvim ESSAI.txt</code>

==== Installation d'un bureau graphique ====
Malgré beaucoup de bugs, le bureau Unity peut techniquement être lancé via le WSL (avec énormément d'efforts).

{{https://cloud.githubusercontent.com/assets/9023392/16705685/69455030-454e-11e6-8ae3-cb210354c660.png?400|Malgré beaucoup de bugs, le bureau Unity peut techniquement être lancé via le WSL (avec énormément d'efforts)}}

<note important>Si la commande    gnome-session se termine prématurément, c'est probablement lié a ce  [[https://bugs.dogfood.paddev.net/ubuntu/+source/gnome-session/+bug/1251281|bug]]
    sudo service dbus restart
          * Stopping system message bus dbus                                                                              [ OK ]
          * Starting system message bus dbus                                                                              [ OK ]
   gnome-session
          gnome-session-is-accelerated: No hardware 3D support.
          gnome-session-check-accelerated: GL Helper exited with code 256
          (gnome-session-check-accelerated-gles-helper:2164): WARNING **: 15:30:56.092: eglGetDisplay() failed
          gnome-session-check-accelerated: GLES Helper exited with code 256
          gnome-session-is-accelerated: No hardware 3D support.
          gnome-session-check-accelerated: GL Helper exited with code 256
          (gnome-session-check-accelerated-gles-helper:2167): WARNING **: 15:31:01.530: eglGetDisplay() failed
          gnome-session-check-accelerated: GLES Helper exited with code 256
          gnome-session-binary[2142]: WARNING: software acceleration check failed: Child process exited with code 1
          gnome-session-binary[2142]: CRITICAL: We failed, but the fail whale is dead. Sorry....

</note>

==== Généralités ====

Ouvrez **Ubuntu sur Windows**, et lancez-y vos commandes ou vos applications. Remarquez que rien n’empêche le lancement de plusieurs terminaux.

Le serveur X, si il s'avère nécessaire, doit être lancé depuis le menu démarrer (**VcXsrv**) avant le lancement de la commande dans le terminal "Ubuntu".

Des environnements de bureau complets peuvent en pratique être installés et lancés, mais remarquez tout de même que le WSL n'a pas été premièrement conçu pour faire ce genre de choses, et des bugs peuvent survenir.

Pour expérimenter ce genre de manipulation, des environnements légers, avec un [[gestionnaire de fenêtres]] sans composition graphique avancée, sont à privilégier ([[Xfce]], [[LXDE]], [[OpenBox]], ...).

<note tip>Pour avoir un système plus convivial, l'installation de polices de caractères plus modernes sera sans doute nécessaire.</note>

Pour quitter le WSL, fermez le serveur d'affichage et le terminal.

==== Accès aux fichiers Windows depuis Linux ====

Le disque ''C:'' est automatiquement monté par Ubuntu au chemin ''/mnt/c'', et il en est de même pour les autres lecteurs (''/mnt/d/'', ...) du système Windows.

Tous ces chemins sont accessibles avec les séparateurs Unix (''/'' au lieu de ''\'' pour Windows).

Par défaut, tous les fichiers du système Windows appartiennent à l'utilisateur courant avec toutes les permissions (777) et on ne peut pas modifier ces permissions. Il est possible de changer ce comportement, mais avec quelques limitations, en suivant [[https://blogs.msdn.microsoft.com/commandline/2018/01/12/chmod-chown-wsl-improvements/|cette documentation]] (en anglais).

==== Accès aux fichiers Linux depuis Windows ====

Pour information, la racine du système de fichiers Linux est\\ 
''C:\Users\%USERNAME%\AppData\Local\Packages\CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc\LocalState\rootfs''

Si vous avez choisi une version spécifique dans le Windows Store, le chemin sera légèrement différent :\\ 
''C:\Users\%USERNAME%\AppData\Local\Packages\CanonicalGroupLimited.Ubuntu18.04onWindows_79rhkp1fndgsc\LocalState\rootfs''

Si vous avez choisi de nommer votre instance ubuntu, le chemin sera aussi légèrement différent :\\ 
''C:\Users\TEMP.%USERNAME%\AppData\Local\Packages\CanonicalGroupLimited.Ubuntu18.04onWindows_79rhkp1fndgsc\LocalState\rootfs''

<note warning>Ne modifiez jamais ces fichiers directement depuis Windows.

Les systèmes de fichiers n'étant pas les mêmes entre Windows et Linux, les programmes Windows ne savent pas les gérer et les fichiers seraient corrompus à coup sûr.</note>

==== Utiliser des commandes Linux dans l'invite de commande Windows ====

Pour utiliser une commande Linux depuis l'invite de commande Windows, faites-la précéder de ''ubuntu run''.

Si vous avez installé une version spécifique d'Ubuntu sur Windows, la commande est légèrement différente : ''ubuntu1604 run'' ou ''ubuntu1804 run'' par exemple.

Par exemple pour faire ''ls -al'' depuis l'invite de commande Windows, tapez :
<code>ubuntu run ls -al</code>

==== Utiliser des programmes Windows depuis Linux ====

Il est aussi possible d'exécuter des programmes Windows depuis la console Ubuntu. Il suffit d'appeler les commandes avec leurs extensions Windows (couramment ''.exe'', ''.bat'' ou ''.cmd'') :
<code>notepad.exe</code>

==== Désinstallation ====
Pour supprimer le logiciel installé en conservant les données de l'utilisateur, effectuer la commande windows
<code> lxrun /uninstall </code>
Pour tout supprimer, effectuer la commande windows
<code>lxrun /uninstall /full </code>
Pour réinstaller facilement, effectuer la commande windows
<code>lxrun /install </code>
===== Accès aux autres partitions =====
Il devrait bientôt être possible d'accéder de façon standard aux répertoires "linux"  stockés  par wsl dans la partition C:  sans avoir besoin de l'utiliser.

Cela serait possible avec la version ** [[https://www.developpez.com/actu/246534/La-MaJ-WSL-dans-Windows-10-build-1903-vous-donne-acces-aux-fichiers-Linux-depuis-Windows-les-outils-en-ligne-de-commande-sont-egalement-ameliores/|19h1]]** qui sera diffusée en [[https://devblogs.microsoft.com/commandline/whats-new-for-wsl-in-windows-10-version-1903/|avril 2019]]

Les partitions  formatées EXT4  ne sont toujours pas montables manuellement. Seules les partitions FAT32 le deviennent.
  
===== Voir aussi =====

* **(en)** [[wp>Windows Subsystem for Linux]]
  * [[:Cygwin]]
  * [[:Xorg]]
  * [[:bash]]
  * [[http://www.numerama.com/tech/158150-le-shell-bash-sous-windows-10-ce-quil-faut-savoir.html|Tutoriel de Numerama]]
  * **(en)** [[https://aka.ms/wsldocs|Documentation officielle]]
  * **(en)** [[https://news.thewindowsclub.com/bash-on-windows-10-v1809-93469/|Les nouveautés de la version 18.09]]
  * **(en)** [[https://github.com/Microsoft/BashOnWindows/issues/|La page GitHub de Microsoft]] où beaucoup d'utilisateurs discutent des problèmes rencontrés et des astuces pour les régler, notamment [[https://github.com/Microsoft/BashOnWindows/issues/637|cette discussion]].
  * **(en)** [[https://blog.ubuntu.com/2019/05/06/canonical-announces-support-for-ubuntu-on-windows-subsystem-for-linux-2|les évolutions en 2019]]
  * [[https://www.developpez.com/actu/246534/La-MaJ-WSL-dans-Windows-10-build-1903-vous-donne-acces-aux-fichiers-Linux-depuis-Windows-les-outils-en-ligne-de-commande-sont-egalement-ameliores/|évolutions]]

-----

//Contributeurs : [[utilisateurs/roschan]], [[utilisateurs/Revoxandco]], [[:utilisateurs:krodelabestiole]]//

Merci de recopier le code ci-contre pour prouver que vous êtes humain : E J Q W B Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported