Prérequis techniques

Pourquoi ce module existe

Ce parcours n'a pas de formateur en direct. Si un outil manque ou est mal configuré au module 3 ou au module 5, vous vous retrouvez seul face à une erreur sans contexte pour la résoudre. Ce module existe uniquement pour éviter ça : c'est une checklist à dérouler avant d'aller plus loin, pas une leçon.

Prenez 10 minutes, vérifiez chaque point avec la commande indiquée, et ne passez au module 2 que lorsque tout est vert.

1. Docker installé et lancé

Vous avez besoin de Docker Desktop (Windows/macOS) ou de Docker Engine + un runtime de conteneurs (Linux). C'est ce qui va réellement construire et exécuter les Dev Containers des modules suivants.

Vérification :

docker --version

Sortie saine attendue (la version exacte n'a pas d'importance) :

Docker version 27.3.1, build ce12230

Ça ne suffit pas : cette commande vérifie que le client Docker est installé, pas que Docker tourne. Vérifiez ensuite que le moteur répond réellement :

docker ps

Sortie saine attendue : un tableau vide (ou avec des conteneurs existants), avec des en-têtes de colonnes du type CONTAINER ID IMAGE COMMAND ....

Si vous obtenez une erreur du type Cannot connect to the Docker daemon : Docker Desktop n'est pas lancé (ouvrez l'application et attendez que l'icône indique qu'il est prêt), ou le service Docker Engine n'est pas démarré sur Linux.

Si l'erreur mentionne plutôt permission denied en essayant d'accéder au socket Docker : le démon tourne, mais votre utilisateur n'est pas dans le groupe docker. Sur Linux : sudo usermod -aG docker $USER, puis déconnectez-vous et reconnectez-vous (ou redémarrez) pour que le changement prenne effet.

2. VS Code installé, avec l'extension Dev Containers

Vérification de VS Code :

code --version

Sortie saine attendue : trois lignes — un numéro de version, un hash de commit, et une architecture, par exemple :

1.94.2
cd4ee3b1c348a13bafd8f9ad8060705f6d4b9cba
x64

Si la commande code est introuvable, VS Code n'a probablement pas ajouté son exécutable au PATH lors de l'installation — relancez l'installateur ou ajoutez-le manuellement.

Vérification de l'extension Dev Containers (éditée par Microsoft) :

code --list-extensions | grep ms-vscode-remote.remote-containers

Sortie saine attendue : la ligne ms-vscode-remote.remote-containers s'affiche. Si rien ne s'affiche, ouvrez VS Code, allez dans le panneau Extensions (icône de blocs empilés dans la barre latérale, ou Ctrl+Shift+X / Cmd+Shift+X), cherchez « Dev Containers » et installez celle publiée par Microsoft.

3. git installé et configuré

Vérification de l'installation :

git --version

Sortie saine attendue :

git version 2.43.0

Vérification de la configuration — c'est ce qui sera attaché à chacun de vos commits, y compris ceux du module 5 :

git config --get user.name
git config --get user.email

Sortie saine attendue : votre nom, puis votre adresse email, chacun sur sa propre ligne — pas de sortie vide.

Si l'une des deux commandes ne renvoie rien, configurez-les :

git config --global user.name "Votre Nom"
git config --global user.email "vous@exemple.com"

4. Assez d'espace disque

Les images de base utilisées par les Dev Containers (module 3) pèsent en général entre 500 Mo et 2 Go une fois décompressées, et Docker en garde plusieurs en cache. Comptez au moins 5 à 10 Go de libre avant de commencer.

Vérification (Linux/macOS) :

df -h .

Regardez la colonne Avail (espace disponible) sur la ligne correspondant à votre disque.

Sur Windows, vérifiez l'espace libre du disque via l'Explorateur de fichiers (clic droit sur le disque → Propriétés), ou dans Paramètres → Système → Stockage.

Si quelque chose échoue

Si un seul de ces quatre points n'est pas vert, arrêtez-vous ici et corrigez-le avant de continuer. Les modules 3 et 5 supposent que Docker tourne, que VS Code peut ouvrir un Dev Container, et que git est configuré — sans ça, vous bloquerez sur une erreur sans indice pour la résoudre. Mieux vaut 10 minutes de vérification maintenant qu'une session entière bloquée plus tard.