Windows Dev konténerek beállítása

A Dev Container lehetővé teszi, hogy egy Docker-tárolót teljes fejlesztési környezetként használjon, amelyet az devcontainer.json adattárba beadott fájl határoz meg. Mindenki, aki megnyitja a projektet, ugyanazokat az eszközöket, bővítményeket és beállításokat kapja – függetlenül attól, hogy mi van telepítve a helyi gépen.

Ez a lap a Windows-specifikus beállításokat ismerteti. A Dev Containers funkcióinak és működésének teljes ismertetését a Dev Containers dokumentációjában találja a VS Code webhelyén.

Előfeltételek

A Windows fejlesztői tárolóinak használatához a következőre van szükség:

  • WSL 2 – Linuxos Windows-alrendszer, 2- es verzió. Ha még nem tette meg, telepítse a WSL-t.
  • Docker Desktop for Windows a WSL 2 háttérrendszer engedélyezve van. Töltse le a Docker Desktopot , és kövesse a telepítőt. A telepítés során győződjön meg arról, hogy a WSL 2-alapú motor használata ki van választva a Docker Desktop beállításai között (Általános beállítások>).
  • Visual Studio CodeLetöltés VS Code.
  • Dev Containers-bővítmény – Telepítse a Dev Containers bővítményt a VS Code Marketplace-ről.

Fontos, hogy hol tárolja a fájlokat

Fontos

A Windows a Dev Container teljesítménye nagymértékben függ attól, hogy hol találhatók a projektfájlok. A projektet a WSL 2 fájlrendszerben (például /home/yourname/projects/) tárolja, ne a Windows fájlrendszerben (például C:\Users\yourname\projects\).

Ha a fájlok a Windows fájlrendszerben vannak (C:\), a Docker egy operációsrendszer-alapú fájlmegosztáson keresztül éri el őket, ami jelentősen lassabb. Ha a fájlok a WSL 2 fájlrendszerben vannak, a Docker natív Linux I/O-t használ, és a teljesítmény lényegesen jobb – különösen buildekhez és fájlfigyelő eszközökhöz.

A WSL 2 fájlrendszerbe való klónozáshoz nyissa meg a WSL-disztribúciót (például Ubuntu) a Start menüből vagy Windows terminál, és klónozza ott:

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

Ezután nyissa meg a mappát a VS Code-ban a WSL-ből:

code your-repo

A VS Code csatlakozik a WSL-hez, és észleli, ha devcontainer.json jelen van.

Projekt megnyitása fejlesztői tárolóban

Ha a projekt meg van nyitva a VS Code-ban (WSL-hez csatlakoztatva):

  1. Nyomja le az F1 billentyűt, és válassza a Fejlesztői tárolók: Újranyitás a tárolóban lehetőséget.
  2. A VS Code létrehozza a konténerképet, amelyet a .devcontainer/devcontainer.json alatt határoztak meg (vagy kéri, hogy adjon hozzá egyet, ha nincs ilyen).
  3. A build befejezése után a VS Code újracsatlakozik a tárolón belül az összes elérhető konfigurált eszközzel és bővítménysel.

A helyi környezetbe való visszatéréshez nyomja le az F1 billentyűt, és válassza a Dev Containers: Folder Local (Mappa helyi megnyitása) lehetőséget.

Dev Container hozzáadása meglévő projekthez

Ha a projekt még nem rendelkezik ilyennel devcontainer.json :

  1. Nyomja le az F1 billentyűt, és válassza a Dev Containers: Dev Container konfigurációs fájlok hozzáadása lehetőséget.
  2. Válasszon egy alaprendszerképet (például Node.js, Python vagy általános Debian/Ubuntu rendszerképet).
  3. A VS Code létrehoz egy .devcontainer/devcontainer.json fájlt, amelybe be lehet jelentkezni a forrásvezérlőben.

A lehetőségek teljes referenciáját devcontainer.json a Dev Container Specification webhelyén devcontainer.json hivatkozásban talál.

Hibaelhárítás

Container elindul, de a fájlmódosítások nem észlelhetők A projekt valószínűleg a Windows fájlrendszerben van tárolva. Helyezze át a WSL-be (lásd fent: A fájlok tárolási helye számít).

A Docker Desktop nem indul el, vagy hiányzik a WSL-integráció Nyissa meg a Docker Desktopot, nyissa meg a Beállítások>erőforrások>WSL-integrációját, és engedélyezze a telepített WSL-disztribúciók integrációját.

A VS Code nem tud csatlakozni a tárolóhoz A VS Code megnyitása előtt győződjön meg arról, hogy a Docker Desktop fut. Ellenőrizze a Docker Desktop rendszertálca ikont.

Következő lépések