Nastavení Dev Containers na Windows

Vývojový kontejner umožňuje používat kontejner Dockeru jako úplné vývojové prostředí definované souborem devcontainer.json vráceným do úložiště. Každý, kdo projekt otevře, získá stejné nástroje, rozšíření a nastavení – bez ohledu na to, co je nainstalované na místním počítači.

Tato stránka popisuje nastavení specifické pro Windows. Úplný úvod k tomu, co jsou Dev Containers a jak fungují, najdete v dokumentaci ke službě Dev Containers na webu VS Code.

Předpoklady

Dev Containers v Windows vyžaduje:

  • WSL 2 – Subsystém Windows pro Linux verze 2. Nainstalujte WSL , pokud jste to ještě neudělali.
  • Docker Desktop pro Windows s povoleným back-endem WSL 2. Stáhněte Si Docker Desktop a postupujte podle instalačního programu. Během instalace se ujistěte, že je v nastavení Docker Desktopu vybrán modul založený na WSL 2 (Obecné>).
  • Visual Studio Code — Download VS Code.
  • Rozšíření Dev Containers – Nainstalujte rozšíření Dev Containers z VS Code Marketplace.

Záleží na tom, kde ukládáte soubory

Důležité

Na Windows závisí výkon vývojového kontejneru silně na tom, kde jsou vaše soubory projektu aktivní. Uložte projekt do systému souborů WSL 2 (například /home/yourname/projects/), ne v systému souborů Windows (například C:\Users\yourname\projects\).

Pokud jsou vaše soubory v systému souborů Windows (C:\), Docker k nim přistupuje prostřednictvím sdílené složky mezi operačními systémy, což je výrazně pomalejší. Pokud jsou vaše soubory v systému souborů WSL 2, Docker používá nativní vstupně-výstupní operace Linuxu a výkon je podstatně lepší – zejména pro sestavení a nástroje pro sledování souborů.

Pokud chcete klonovat do systému souborů WSL 2, otevřete distribuci WSL (například Ubuntu) z nabídky Start nebo Terminál Windows a naklonujte ji tam:

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

Pak otevřete složku ve VS Code z WSL:

code your-repo

VS Code se připojí k WSL a zjistí devcontainer.json, pokud je přítomen.

Otevření projektu v vývojovém kontejneru

Po otevření projektu ve VS Code (připojeném k WSL):

  1. Stiskněte klávesu F1 a vyberte Dev Containers: Znovu otevřít v kontejneru.
  2. VS Code sestaví image kontejneru definovanou v .devcontainer/devcontainer.json (nebo vás vyzve k jeho přidání, pokud žádná neexistuje).
  3. Po dokončení sestavení se VS Code znovu připojí uvnitř kontejneru se všemi nakonfigurovanými nástroji a dostupnými rozšířeními.

Pokud se chcete vrátit do místního prostředí, stiskněte klávesu F1 a vyberte Dev Containers: Znovu otevřít složku místně.

Přidání vývojového kontejneru do existujícího projektu

Pokud váš projekt ještě nemá devcontainer.json :

  1. Stiskněte klávesu F1 a vyberte Dev Containers: Přidat konfigurační soubory vývojového kontejneru.
  2. Zvolte základní image (například Node.js, Python nebo obecnou image Debian/Ubuntu).
  3. VS Code vytvoří .devcontainer/devcontainer.json soubor, který můžete zkontrolovat ve správě zdrojového kódu.

Pro úplný přehled možností devcontainer.json najděte odkaz devcontainer.json na stránkách Specifikace vývojového kontejneru.

Troubleshooting

Container se spustí, ale změny souborů se nezjistí Váš projekt je pravděpodobně uložený v systému souborů Windows. Přesuňte ho do WSL (viz Místo, kde ukládáte soubory výše).

Docker Desktop se nespustí nebo chybí integrace WSL Otevřete Docker Desktop, přejděte do Nastavení>, Prostředky>, Integrace WSL a povolte integraci pro nainstalované distribuce WSL.

VS Code se nemůže připojit ke kontejneru Před otevřením nástroje VS Code se ujistěte, že je Spuštěná desktopová aplikace Docker. Zkontrolujte ikonu na hlavním panelu systému Dockeru.

Další kroky

  • Last updated on