Tutoriel ⚔ Automatisation de la configuration des environnements avec WSL2 et Docker Compose

[Sylvain*]

⚔ Automatisation de la configuration des environnements de développement avec WSL2 et Docker Compose sous Windows


Introduction

Ce tutoriel vous guidera pour configurer un environnement de développement automatisé sous Windows en utilisant WSL2 (Windows Subsystem for Linux) et Docker Compose. Cela permet de développer dans un environnement Linux natif tout en profitant des outils disponibles sous Windows.

---

Prérequis

• Windows 10 ou 11 avec WSL2 activé

• Docker Desktop installé et configuré avec WSL2

• Droits administratifs pour configurer WSL et Docker

• Connexion internet pour télécharger les outils nécessaires

---

Méthodologie

Activation de WSL2

• Activez WSL et installez une distribution Linux :

wsl --install

• Vérifiez la version de WSL installée :

wsl --list --verbose

• Si nécessaire, mettez à jour vers WSL2 :

wsl --set-version <Distribution> 2

• Microsoft Learn

---

Installation de Docker Desktop et intégration WSL2

• Téléchargez Docker Desktop :

Docker Desktop

• Configurez Docker Desktop pour utiliser WSL2 comme moteur de conteneur :


Ouvrez Docker Desktop.
Allez dans Paramètres > Resources > WSL Integration.
Activez l'intégration pour votre distribution WSL.

• Testez l'installation avec :

docker run hello-world

---

Installation et utilisation de Docker Compose

• Installez Docker Compose :

Docker Desktop inclut Docker Compose. Vérifiez avec :

docker-compose --version

• Exemple de fichier docker-compose.yml pour un projet multi-conteneurs :

version: '3.8'
services:
web:
image: nginx:latest
ports:
"8080:80"
db:
image: mysql:5.7
environment:
MYSQL_ROOT_PASSWORD: example

• Lancez la configuration avec :

docker-compose up -d

• Arrêtez les conteneurs :

docker-compose down

---

Astuce

Configurez un alias dans WSL pour simplifier les commandes Docker :

alias dc="docker-compose"

---

Avertissement

Vérifiez que vos fichiers projet sont stockés dans le système de fichiers Linux (/home), car les performances sont dégradées si vous utilisez le système de fichiers Windows (C:\).

---

Conseil

Utilisez NTFS Permission Tools pour résoudre d'éventuels conflits de permissions entre Windows et WSL.

---

Solution alternative

Si Docker Desktop pose des problèmes, essayez Rancher Desktop pour une alternative légère.

---

Conclusion

Avec WSL2 et Docker Compose, vous pouvez automatiser la configuration des environnements de développement tout en bénéficiant des avantages des deux mondes : Linux pour le développement et Windows pour les outils.