Installation de Docker sur WSL 2 - Première configuration du conteneur

Vérifiez d'abord votre PC

Docker Desktop avec le backend WSL 2 a besoin de trois choses, et sauter cette vérification de deux minutes est la façon dont les gens perdent une soirée. Tout d'abord, la version Windows : vous avez besoin de Windows 10 version 2004 ou ultérieure, ou de Windows 11. Appuyez sur Win + R, tapez winver et appuyez sur Entrée pour voir votre version exacte.

winver

Deuxièmement, la virtualisation doit être activée dans le BIOS ou l'UEFI. Ouvrez le Gestionnaire des tâches, accédez à Performances, puis à CPU et recherchez Virtualisation : activée. S'il indique Désactivé, aucun paramètre logiciel ne vous sauvera – activez d'abord Intel VT-x ou AMD SVM dans le BIOS. Troisièmement, conservez environ 4 Go de RAM libre et quelques Go de disque disponible : WSL 2 et Docker partagent votre machine, ils ne la remplacent pas.

Installez WSL 2 avant toute chose

La plupart des installations Docker ayant échoué sur Windows échouent pour une raison ennuyeuse : l'ordre était erroné. Docker Desktop s'attend à un WSL 2 fonctionnel en dessous, alors construisez d'abord les fondations. Ouvrez PowerShell en tant qu'administrateur et exécutez une commande :

wsl --install

Laissez terminer, puis redémarrez le PC — le redémarrage n'est pas facultatif, il charge les composants de virtualisation. Après le redémarrage, Ubuntu (la distribution par défaut) termine sa propre configuration et vous demande de créer un nom d'utilisateur et un mot de passe Linux.

Vérifiez que WSL 2 est vraiment prêt

Avant que Docker ne s'approche de la machine, confirmez la fondation avec deux commandes :

wsl --status
wsl -l -v

Votre distribution devrait afficher VERSION 2 dans la liste. S'il affiche 1, définissez la version par défaut et convertissez la distribution comme le suggère le résultat de la commande :

wsl --set-default-version 2

Chaque couche est testée avant la suivante, donc si quelque chose échoue plus tard, vous savez exactement quelle couche est à l'origine du problème.

Installer Docker Desktop sur le dessus

Téléchargez Docker Desktop uniquement à partir de docker.com : les sites de téléchargement tiers regroupent les fichiers indésirables avec les installateurs populaires. Exécutez le programme d'installation et laissez l'option Utiliser WSL 2 au lieu d'Hyper-V cochée ; sur la plupart des PC, elle est cochée par défaut.

Lorsque le programme d'installation vous le demande, laissez-le se fermer et déconnectez-vous ou redémarrez si vous y êtes invité. Docker ajoute votre compte Windows au groupe docker-users local, et l'adhésion au groupe ne prend effet que lors d'une nouvelle connexion - c'est la vérification honnête que la plupart des guides ignorent, et c'est pourquoi Docker refuse parfois de démarrer jusqu'à ce que vous vous déconnectiez et vous reconnectiez.

Démarrez Docker Desktop et attendez que l'icône de baleine dans la barre d'état système se stabilise et que le tableau de bord signale Moteur en cours d'exécution. Le premier démarrage est lent ; donnez-lui quelques minutes. Acceptez honnêtement l’écran du contrat de service d’abonnement Docker : il s’agit d’une véritable licence.

Exécutez votre premier conteneur — Hello World

Ouvrez une nouvelle fenêtre PowerShell ou Terminal et exécutez les deux commandes qui prouvent que toute la chaîne fonctionne :

docker --version
docker run hello-world

docker --version prouve que le client est installé et sur votre PATH. docker run hello-world prouve tout le reste : Docker ne peut pas trouver l'image localement, la télécharge depuis Docker Hub, crée un conteneur à partir de celle-ci, l'exécute et imprime son message Bonjour de Docker !. Si ce message apparaît, votre chaîne fonctionne de bout en bout : terminal, client, moteur dans WSL 2, réseau et registre.