Docker Desktop na Windows [Wiki]

Tato stránka je pouze pro čtení. Můžete si pouze prohlédnout zdrojový kód, ale ne ho měnit. Zeptejte se správce, pokud si myslíte, že něco není v pořádku.
====== Docker Desktop na Windows ======

//Vytvořeno: **** | Aktualizováno: **~~LASTMOD~~**//

[[https://docs.docker.com/desktop/setup/install/windows-install/|Docker Desktop]] je nejjednodušší způsob, jak na Windows rozchodit Docker pro běh Linux kontejnerů. Pro běžné použití a pro otevření připraveného projektu ve [[https://code.visualstudio.com/|Visual Studio Code]] se na Windows typicky používá [[https://docs.docker.com/desktop/features/wsl/|WSL 2 backend]].

===== Co je potřeba =====

  * Windows 10 nebo 11
  * práva správce pro instalaci
  * stažený instalátor Docker Desktop
  * [[https://code.visualstudio.com/|Visual Studio Code]]

Pro běžné použití není potřeba ručně nastavovat Ubuntu ve WSL. Důležité je hlavně to, aby Docker Desktop měl funkční WSL 2 backend.

===== Instalace Docker Desktop =====

  - Stáhnout Docker Desktop z oficiální stránky.
  - Spustit instalátor.
  - Dokončit instalaci podle průvodce.
  - Spustit Docker Desktop.
  - Pokud Docker naběhne bez chyby, není potřeba nic dalšího řešit.

===== Kdy je potřeba WSL =====

Pokud Docker Desktop při instalaci nebo při prvním spuštění hlásí, že chybí WSL 2 nebo že je potřeba WSL aktualizovat, je potřeba otevřít PowerShell jako správce a spustit tyto příkazy:

<code powershell>
wsl --install
wsl --update
</code>

Po dokončení je vhodné restartovat Windows a znovu spustit Docker Desktop.

Pokud příkaz ''wsl --install'' nahlásí, že už je WSL nainstalované, je to v pořádku. V takovém případě obvykle stačí ''wsl --update'' a restart systému.

===== Instalace Visual Studio Code =====

[[https://code.visualstudio.com/|Visual Studio Code]] stačí stáhnout z oficiální stránky, spustit instalátor a editor otevřít. Pro tento návod není potřeba nic složitě nastavovat navíc.

===== Instalace pluginu Dev Containers =====

Ve [[https://code.visualstudio.com/docs/devcontainers/containers|Visual Studio Code Dev Containers]] otevřít záložku rozšíření klávesovou zkratkou ''Ctrl+Shift+X'', vyhledat ''Dev Containers'' od autora ''Anysphere'' a rozšíření nainstalovat. Pokud místo VS Code používáš Cursor nebo jiný podobný editor, princip je stejný: do editoru se nainstaluje rozšíření ''Dev Containers'' od autora ''Anysphere''.

===== Jak otevřít připravený projekt =====

  - Otevřít složku projektu ve Visual Studio Code.
  - Stisknout ''F1''.
  - Spustit příkaz ''Dev Containers: Reopen in Container''.

Editor pak vytvoří a spustí kontejner podle připraveného ''.devcontainer'' nastavení.

===== Jak ověřit, že Docker běží =====

Po úspěšné instalaci lze v PowerShellu spustit tyto příkazy:

<code powershell>
docker version
docker ps
</code>

Pokud příkazy nevrátí chybu, Docker běží správně a je připravený pro otevření projektu.

===== Pomalé diskové operace v devcontaineru =====

Pokud jsou operace jako ''git status'', otevírání souborů nebo instalace závislostí v devcontaineru extrémně pomalé, problém může být v tom, že projekt leží na Windows filesystemu a do kontejneru je připojený přes bind mount. Praktický postup je popsaný v samostatném návodu [[infrastruktura:kontejnery:zrychleni-docker-devcontaineru-na-windows-pres-wsl2|Zrychlení Docker devcontaineru na Windows přes WSL2]].

===== Co není potřeba řešit =====

  * není potřeba ručně otevírat Ubuntu a něco v něm nastavovat
  * není potřeba ručně vytvářet kontejnery předem
  * není potřeba ručně upravovat ''.devcontainer'', pokud je už připravený v projektu

===== Zdroje =====

  * [[https://docs.docker.com/desktop/setup/install/windows-install/|Docker Desktop on Windows - oficiální dokumentace]]
  * [[https://docs.docker.com/desktop/features/wsl/|Docker Desktop WSL 2 backend - oficiální dokumentace]]
  * [[https://code.visualstudio.com/|Visual Studio Code]]
  * [[https://code.visualstudio.com/docs/devcontainers/containers|Visual Studio Code Dev Containers - oficiální dokumentace]]