====== Docker Desktop na Windows ======

[[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.

===== 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]]