WSL Containers — des conteneurs Linux sans Docker Desktop

1Pourquoi ce chapitre existe

Il n'a pas été demandé par un professeur. Il est là parce qu'un outil est sorti il y a quelques semaines et qu'il répond à une gêne bien réelle du chapitre précédent : sous Windows, faire tourner un conteneur demandait d'installer Docker Desktop — un logiciel lourd, qui démarre une machine virtuelle, qui tourne en permanence, et dont la licence n'est gratuite que pour les petites structures et l'usage personnel.

Le revers, et il faut le dire : un outil de trois semaines n'a pas la documentation, les tutoriels ni les réponses de forum d'un outil de douze ans. Docker reste ce qu'on apprend ; wslc est ce qu'on surveille.

2Ce que wslc remplace

D'abord, WSL en une phrase

WSL — Windows Subsystem for Linux — permet d'exécuter Linux sur Windows. Dans sa version 2, ce n'est pas une émulation : c'est un vrai noyau Linux qui tourne dans une machine virtuelle légère gérée par Windows, avec les fichiers et le réseau partagés entre les deux mondes.

Or un conteneur Linux a besoin d'exactement une chose : un noyau Linux. Windows en a désormais un sous la main en permanence. Il ne manquait plus que le moteur et la commande — c'est ce que Microsoft a ajouté.

Et ce n'est pas que la ligne de commande

Microsoft livre aussi une interface de programmation (le paquet NuGet Microsoft.WSL.Containers) qui permet à une application Windows écrite en C# ou en C++ de télécharger une image, de lancer un conteneur et de lire sa sortie depuis son propre code. Autrement dit : le conteneur devient une brique qu'un logiciel Windows peut employer, et plus seulement un outil de développeur.

3Installer et vérifier

Trois cas, et aucun ne demande de télécharger un logiciel de conteneurs.

Vous avez déjà WSL

wsl --version        # ce que vous avez
wsl --update         # la dernière version

Il faut WSL 2.9.3 au minimum. Redémarrez le PC après la mise à jour.

Vous n'avez jamais installé WSL

wsl --install        # dans une console OUVERTE EN ADMINISTRATEUR

Une seule commande — mais elle suppose que la virtualisation est activée dans le BIOS/UEFI de la machine, puisque WSL 2 s'appuie dessus. C'est le point qui bloque le plus souvent en salle de TP, et il ne se règle pas depuis Windows.

Vérifier que wslc répond

wslc version         # la version du moteur
wslc --help          # toutes les commandes
wslc run --help      # le détail d'une commande

wslc --help est la source la plus à jour qui existe : plus récente que ce cours, plus récente que n'importe quel tutoriel. Sur un outil de quelques semaines, prenez-en l'habitude.

4Le premier conteneur

Le rite de passage est le même que sous Docker : une image minuscule dont le seul rôle est d'afficher un message et de s'arrêter.

wslc run --rm hello-world

Il se passe quatre choses, dans cet ordre, et il faut savoir les nommer :

1. l'image hello-world n'est pas sur la machine, donc elle est téléchargée depuis le registre ;
2. un conteneur est créé à partir d'elle ;
3. il est démarré, affiche son message, et son processus se termine ;
4. --rm le fait détruire dans la foulée.

Un conteneur qui fait quelque chose

wslc run --rm -it ubuntu:latest bash -c "echo Hello world from WSL container!"

-it est l'habitude de Docker, et elle se garde : les deux lettres vont presque toujours ensemble, parce qu'un terminal sans entrée ne sert à rien.

5Les images et leurs registres

Une image porte un nom et un tag, séparés par deux points : ubuntu:latest, nginx:1.27, python:3. Sans tag, c'est latest qui est pris.

D'où viennent les images

C'est le point qui surprend : wslc va chercher dans les registres de Docker. Il n'y a pas de catalogue Microsoft séparé, pas de format propriétaire. Une image construite pour Docker tourne sous wslc, et l'inverse aussi.

• Docker Hub — le registre par défaut, celui des images officielles ;
• GitHub Container Registry — celui des projets hébergés sur GitHub ;
• Azure Container Registry — les registres privés d'entreprise.

Les commandes des images

wslc image list              # ce qui est sur la machine
wslc image inspect nginx     # tout ce qu'on sait d'une image
wslc image prune             # effacer celles qui ne servent à aucun conteneur

La documentation de Microsoft emploie aussi les formes courtes wslc image ls et wslc container ps, héritées de Docker. Les deux écritures apparaissent dans ses propres pages ; wslc --help dit laquelle votre version accepte.

6Faire tourner, entrer, arrêter

wslc container list          # ce qui tourne
wslc container list --all    # y compris ce qui est arrêté
wslc container logs web      # ce que le conteneur a écrit
wslc container inspect web   # son état complet, en détail
wslc container stop web      # l'arrêter
wslc container prune         # effacer tous les conteneurs arrêtés

Entrer dans un conteneur qui tourne

wslc exec web cat /etc/os-release    # une commande, et on ressort
wslc exec -it web bash               # un shell, et on reste

Ce que fait le conteneur quand sa commande se termine

Un conteneur vit exactement aussi longtemps que son processus principal. Une image qui lance bash sans terminal s'arrête immédiatement : bash n'a rien à lire, il sort, le conteneur sort. Ce n'est pas une panne, c'est la règle.

7Publier un port

Un conteneur a son propre réseau. Pour atteindre depuis Windows un serveur qui tourne dedans, il faut publier un port.

wslc run -d --rm -p 8080:80 --name web nginx
curl localhost:8080
wslc container stop web

Comme le conteneur a été lancé avec --rm, il disparaît tout seul à l'arrêt : rien à nettoyer.

8Construire sa propre image

Jusqu'ici on a employé des images écrites par d'autres. Pour empaqueter son propre programme, on décrit sa construction dans un fichier et on lance wslc build.

Microsoft nomme ce fichier Containerfile dans son tutoriel. Son contenu est la syntaxe que vous connaissez déjà du chapitre 18 :

FROM python:3
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
EXPOSE 8000
CMD ["python", "manage.py", "runserver", "0.0.0.0:8000"]

wslc build -t helloworld-django .          # le point : le dossier courant
wslc image list
wslc run -d --rm -p 8000:8000 --name django helloworld-django
wslc container logs django
wslc exec django uname                     # doit répondre « Linux »
wslc container stop django

9Surveiller et nettoyer

wslc events          # le journal en direct : création, réseau, démarrage, arrêt
wslc stats           # processeur et mémoire des conteneurs qui tournent
wslc system info     # l'état de l'environnement de conteneurs

wslc events mérite un essai dès le premier TP : on l'ouvre dans une console, on travaille dans une autre, et on voit en direct ce que fait vraiment chaque commande. Un run --rm y écrit la séquence complète — création, connexion au réseau, démarrage, arrêt, déconnexion, destruction — et cette liste vaut mieux qu'un paragraphe d'explication.

Reprendre de la place

wslc container prune    # les conteneurs arrêtés
wslc image prune        # les images que plus personne n'emploie

Les images sont ce qui pèse. Une dizaine d'essais avec ubuntu, python et nginx occupent déjà tranquillement un gigaoctet.

Autres commandes annoncées à la version stable

10wslc et docker, côte à côte

C'est la table à garder sous les yeux pendant le premier TP. À gauche ce que vous savez déjà, à droite ce que vous taperez.

11Ce qui n'est pas encore là

Un outil de quelques semaines n'est pas un outil de douze ans, et le dire fait partie du cours.

• Pas d'interface graphique. Docker Desktop montre les conteneurs, les images et leur consommation dans une fenêtre. Ici, tout passe par la console.
• Windows seulement. wslc fait tourner des conteneurs Linux, mais depuis Windows. Sur un Mac ou un serveur Linux, c'est Docker ou Podman.
• L'écosystème. Les tutoriels, les réponses de forum, les fichiers d'intégration continue, les extensions d'éditeur parlent tous docker. Cela se traduit, mais cela se traduit à la main.
• La virtualisation reste nécessaire. Le noyau Linux tourne dans une machine virtuelle gérée par Windows : si la virtualisation est désactivée dans le BIOS, rien ne démarre — exactement comme pour WSL.

La bonne position en BTS : apprendre Docker, parce que c'est lui qui est au programme, qui est partout et qui est demandé. Savoir que wslc existe, ce qu'il remplace et comment le lancer — parce que c'est ce qui vous distinguera le jour où un poste Windows doit faire tourner un conteneur sans qu'on achète de licence.

12L'aide-mémoire

# ── mise en place ────────────────────────────────────────────────
wsl --version                                 # la version de WSL (mini 2.9.3)
wsl --update                                  # mettre à jour, puis redemarrer
wsl --install                                 # si WSL n'est pas installe (admin)
wslc version                                  # le moteur de conteneurs
wslc --help                                   # toutes les commandes

# ── premiers pas ─────────────────────────────────────────────────
wslc run --rm hello-world
wslc run --rm -it ubuntu:latest bash -c "echo coucou"

# ── images ───────────────────────────────────────────────────────
wslc pull nginx                               # telecharger sans lancer
wslc image list                               # ce qu'on a
wslc image inspect nginx                      # le detail
wslc image prune                              # le menage

# ── conteneurs ───────────────────────────────────────────────────
wslc run -d --rm -p 8080:80 --name web nginx  # hote:conteneur
wslc container list                           # ce qui tourne
wslc container list --all                     # + ce qui est arrete
wslc exec -it web bash                        # entrer dedans
wslc container logs web                       # ce qu'il a ecrit
wslc container inspect web                    # son etat complet
wslc container stop web                       # l'arreter
wslc container prune                          # le menage

# ── construire ───────────────────────────────────────────────────
wslc build -t monimage .                      # avec un Containerfile ici

# ── surveiller ───────────────────────────────────────────────────
wslc events                                   # le journal en direct
wslc stats                                    # processeur et memoire
wslc system info                              # l'etat general