Configurer des conteneurs de développement sur Windows

Un conteneur de développement vous permet d’utiliser un conteneur Docker comme environnement de développement complet, défini par un devcontainer.json fichier archivé dans votre référentiel. Tout le monde qui ouvre le projet obtient les mêmes outils, extensions et paramètres, indépendamment des éléments installés sur leur ordinateur local.

Cette page couvre la configuration spécifique aux Windows. Pour une présentation complète des conteneurs de développement et de leur fonctionnement, consultez la documentation des conteneurs de développement sur le site web VS Code.

Prerequisites

Les conteneurs de développement sur Windows nécessitent :

  • WSL 2 — Sous-système Windows pour Linux, version 2. Installez WSL si vous ne l’avez pas déjà fait.
  • Docker Desktop pour Windows avec le serveur principal WSL 2 activé. Téléchargez Docker Desktop et suivez le programme d’installation. Pendant l’installation, vérifiez que le moteur basé sur WSL 2 est sélectionné dans les paramètres Docker Desktop (Paramètres>généraux).
  • Visual Studio Code — Download VS Code.
  • Extension Dev Containers : installez l’extension Dev Containers à partir de la Place de marché VS Code.

Où vous stockez vos fichiers compte

Important

Sur Windows, les performances du conteneur de développement dépendent fortement de l’emplacement de vie de vos fichiers projet. Stockez votre projet dans le système de fichiers WSL 2 (par exemple, /home/yourname/projects/), et non dans le système de fichiers Windows (par exemple, C:\Users\yourname\projects\).

Lorsque vos fichiers se trouvent sur le système de fichiers Windows (C:\), Docker les accède via un partage de fichiers inter-système d’exploitation, ce qui est beaucoup plus lent. Lorsque vos fichiers se trouvent dans le système de fichiers WSL 2, Docker utilise les E/S Linux natives et les performances sont considérablement meilleures, en particulier pour les builds et les outils de surveillance de fichiers.

Pour cloner dans le système de fichiers WSL 2, ouvrez votre distribution WSL (par exemple, Ubuntu) à partir du menu Démarrer ou Terminal Windows, puis clonez-y :

cd ~
mkdir projects && cd projects
git clone https://github.com/your-org/your-repo.git

Ouvrez ensuite ce dossier dans VS Code à partir de WSL :

code your-repo

VS Code se connecte à WSL et détecte le devcontainer.json cas échéant.

Ouvrir un projet dans un conteneur de développement

Une fois votre projet ouvert dans VS Code (connecté à WSL) :

  1. Appuyez sur F1 et sélectionnez Dev Containers : Rouvrir dans un conteneur.
  2. VS Code génère l’image conteneur définie dans .devcontainer/devcontainer.json (ou vous invite à en ajouter un s’il n’en existe aucun).
  3. Une fois la build terminée, VS Code se reconnecte à l’intérieur du conteneur avec tous les outils et extensions configurés disponibles.

Pour revenir à votre environnement local, appuyez sur F1 et sélectionnez Conteneurs de développement : Rouvrir le dossier localement.

Ajouter un conteneur de développement à un projet existant

Si votre projet n’a devcontainer.json pas encore :

  1. Appuyez sur F1 et sélectionnez Conteneurs de développement : Ajouter des fichiers de configuration de conteneur de développement.
  2. Choisissez une image de base (par exemple, Node.js, Python ou une image Debian/Ubuntu générique).
  3. VS Code crée un .devcontainer/devcontainer.json fichier que vous pouvez vérifier dans le contrôle de code source.

Pour obtenir la référence complète des devcontainer.json options, consultez devcontainer.json référence sur le site Dev Container Specification.

Résolution des problèmes

Container démarre, mais les modifications de fichier ne sont pas détectées Votre projet est probablement stocké sur le système de fichiers Windows. Déplacez-le dans WSL (voir Où vous stockez vos fichiers ci-dessus ).

Docker Desktop ne démarre pas ou l’intégration WSL est manquante Ouvrez Docker Desktop, accédez àl’intégration WSL des>> et activez l’intégration pour vos distributions WSL installées.

VS Code ne peut pas se connecter au conteneur Vérifiez que Docker Desktop est en cours d’exécution avant d’ouvrir VS Code. Vérifiez l’icône de la barre d’état du système Docker Desktop.

Étapes suivantes

  • Last updated on