Dev-containers instellen op Windows

Met een Dev-container kunt u een Docker-container gebruiken als een volledige ontwikkelomgeving, gedefinieerd door een devcontainer.json bestand dat is ingecheckt in uw opslagplaats. Iedereen die het project opent, krijgt dezelfde hulpprogramma's, extensies en instellingen, ongeacht wat op hun lokale computer is geïnstalleerd.

Op deze pagina wordt de Windows-specifieke installatie beschreven. Voor een volledige inleiding tot wat Dev Containers zijn en hoe ze werken, raadpleegt u de documentatie van Dev Containers op de website van VS Code.

Vereiste voorwaarden

Dev Containers op Windows vereist:

• WSL 2 — Windows-subsysteem voor Linux, versie 2. Installeer WSL als u dat nog niet hebt gedaan.
• Docker Desktop voor Windows waarvoor de back-end WSL 2 is ingeschakeld. Download Docker Desktop en volg het installatieprogramma. Zorg er tijdens de installatie voor dat de WSL 2-engine gebruiken is geselecteerd in de Docker Desktop-instellingen (Instellingen>algemeen).
• Visual Studio Code — Download VS Code.
• Dev Containers-extensie : installeer de Dev Containers-extensie vanuit de VS Code Marketplace.

Waar u uw bestanden opslaat, is belangrijk

Wanneer uw bestanden zich in het Windows bestandssysteem bevinden (C:\), opent Docker deze via een cross-OS-bestandsshare, wat aanzienlijk langzamer is. Wanneer uw bestanden zich in het WSL 2-bestandssysteem bevinden, maakt Docker gebruik van systeemeigen Linux I/O en zijn de prestaties aanzienlijk beter, met name voor builds en hulpprogramma's voor het controleren van bestanden.

Als u wilt klonen in het WSL 2-bestandssysteem, opent u uw WSL-distributie (bijvoorbeeld Ubuntu) in het menu Start of Windows Terminal en kloont u daar:

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

Open vervolgens die map in VS Code vanuit WSL:

code your-repo

VS Code maakt verbinding met WSL en detecteert de aanwezigheid van devcontainer.json als die er is.

Een project openen in een Dev-container

Zodra uw project is geopend in VS Code (verbonden met WSL):

1. Druk op F1 en selecteer Dev Containers: Opnieuw openen in container.
2. VS Code maakt de containerafbeeldingen die zijn gedefinieerd in .devcontainer/devcontainer.json (of vraagt u er een toe te voegen als er geen bestaat).
3. Wanneer de build is voltooid, maakt VS Code opnieuw verbinding in de container met alle geconfigureerde hulpprogramma's en extensies die beschikbaar zijn.

Als u wilt terugkeren naar uw lokale omgeving, drukt u op F1 en selecteert u Dev Containers: Map lokaal opnieuw openen.

Een Dev-container toevoegen aan een bestaand project

Als uw project nog geen devcontainer.json heeft:

1. Druk op F1 en selecteer Dev Containers: Dev Container Configuration Files toevoegen.
2. Kies een basisinstallatiekopie (bijvoorbeeld Node.js, Python of een algemene Debian/Ubuntu-installatiekopie).
3. VS Code maakt een .devcontainer/devcontainer.json bestand dat u kunt inchecken bij broncodebeheer.

Zie voor de volledige verwijzing naar devcontainer.json opties de devcontainer.json-referentie op de Dev Container Specification-site.

Troubleshooting

Container wordt gestart, maar bestandswijzigingen worden niet gedetecteerd Uw project wordt waarschijnlijk opgeslagen in het Windows bestandssysteem. Verplaats deze naar WSL (zie waar u uw bestanden hierboven opslaat ).

Docker Desktop wordt niet gestart of WSL-integratie ontbreekt Open Docker Desktop, ga naarInstellingenresources>>WSL-integratie en schakel integratie in voor uw geïnstalleerde WSL-distributies.

VS Code kan geen verbinding maken met de container Zorg ervoor dat Docker Desktop wordt uitgevoerd voordat u VS Code opent. Controleer het pictogram van het systeemvak van Docker Desktop.

Volgende stappen 

• Documentatie voor Dev Containers - volledige naslaginformatie van het VS Code-team
• devcontainer.json referentie — alle configuratieopties
• Aan de slag met Externe Docker-containers op WSL 2 - bredere installatiehandleiding voor WSL + Docker
• WSL installeren : als u WSL nog niet hebt ingesteld