{"id":166,"date":"2022-07-05T12:22:54","date_gmt":"2022-07-05T11:22:54","guid":{"rendered":"https:\/\/spinczyk.net\/blog\/?p=166"},"modified":"2022-07-05T12:22:54","modified_gmt":"2022-07-05T11:22:54","slug":"docker-mit-wsl-auf-windows-einrichten","status":"publish","type":"post","link":"https:\/\/spinczyk.net\/blog\/2022\/07\/05\/docker-mit-wsl-auf-windows-einrichten\/","title":{"rendered":"Docker mit WSL auf Windows einrichten"},"content":{"rendered":"\n

Insbesondere bei der Einrichtung lokaler Entwicklungsumgebungen in der Linux-basierten Web-Welt eignet sich Docker hervorragend zur Entwicklung. Wer seine apache oder nginx-basierten Container baut oder vorkonfigurierte Varianten nutzt, wird schnell feststellen, dass diese nicht allzu performant laufen. Zumindest bei der einfachen Nutzung von Docker-Desktop unter Windows ohne WSL Integration. Da kann ein Seitenaufruf schon mal mehrere Minuten dauern, zumindest bei entsprechendem applikationsseitigem Workload.<\/p>\n\n\n\n

Installation von WSL \u2013 Windows-Subsystem f\u00fcr Linux<\/h2>\n\n\n\n

Abhilfe schafft hier WSL, das Windows-Subsystem f\u00fcr Linux (siehe https:\/\/de.wikipedia.org\/wiki\/Windows-Subsystem_f%C3%BCr_Linux<\/a>). Dieses steht seit Windows 10 (Version 1903) in der Version WSL 2 zur Verf\u00fcgung. Im Grunde stellt Windows hiermit eine Kompatibilit\u00e4tsschicht zur Verf\u00fcgung, mit deren Hilfe Linux-Executables ausgef\u00fchrt werden k\u00f6nnen. So l\u00e4sst sich eine Linux-Distribution wie Ubuntu mehr oder weniger nativ in Windows ausf\u00fchren. Mehr Details zu den technischen Hintergr\u00fcnden von WSL kann man im o.g. Wikipedia-Artikel oder direkt bei Microsoft unter folgendem Link erfahren: https:\/\/docs.microsoft.com\/de-de\/windows\/wsl\/about<\/a><\/p>\n\n\n\n

Docker und WSL unter Windows<\/h2>\n\n\n\n

Docker wiederum unterst\u00fctzt die WSL2-Integration von Windows, sprich die Docker-Container inklusive m\u00f6glicher Mounts oder Volumes kann innerhalb der Linux-Distribution abgelegt werden, die wiederum nativ als Windows-App laufen wird.<\/p>\n\n\n\n

Unser Vorgehen<\/strong> sieht also so aus:<\/p>\n\n\n\n

  1. Aktivierung der WSL Komponenten unter Windows<\/li>
  2. Installation einer alternativen Linux-Distribution unter Windows (optional)<\/li>
  3. Installation von Docker-Desktop und Aktivierung von WSL2<\/li>
  4. Ausf\u00fchren eines Containers mit deutlich gestiegener Geschwindigkeit<\/li>
  5. Fertig<\/li><\/ol>\n\n\n\n

    Das Ganze ist fairly easy. Linux-Kenntnisse sind nicht wirklich erforderlich, der ganze Vorgang dauert im Grunde auch nur ein paar Minuten, allerdings nimmt das Herunterladen und Installieren der Software je nach Internetleitung und Rechnerleistung zus\u00e4tzlich Zeit in Anspruch.<\/p>\n\n\n\n

    Achtung<\/u><\/strong>: Der Vorgang erfordert den zwischenzeitlichen Neustart des Rechners, man sollte also entsprechend darauf eingestellt sein!<\/p>\n\n\n\n

    Aktivierung der WSL Komponenten unter Windows<\/h2>\n\n\n\n

    Der einfachste Weg hierf\u00fcr f\u00fchrt \u00fcber die Power-Shell, die aber in jedem Fall mit Administrator-Rechten ausgef\u00fchrt werden muss. Daf\u00fcr einfach die Windows-Taste dr\u00fccken, dann \u201ePowershell\u201c eintippen und mit der rechten Maustaste auf das PowerShell Symbol im Menu klicken und \u201eAls Administrator ausf\u00fchren\u201c ausw\u00e4hlen.<\/p>\n\n\n\n

    \"\"<\/a><\/figure>\n\n\n\n

    Anschlie\u00dfend wird in der PowerShell folgender Befehl ausgef\u00fchrt:<\/p>\n\n\n\n

    wsl \u2013-install<\/code><\/pre>\n\n\n\n
    Nach erfolgreicher Installation sieht das Ganze so aus:<\/p>\n\n\n\n
    \"\"<\/a><\/figure>\n\n\n\n
    Der Installationsvorgang von WSL meldet ja schon, dass ein Neustart erforderlich ist. Dieser m\u00fcsste dann jetzt einmal durchgef\u00fchrt werden. Nach dem Neustart startet Ubuntu in einer Konsole automatisch und setzt den Installationsprozess fort. Nach ggf. ein paar Minuten Wartezeit sollen Benutzername und Passwort vergeben werden. Das Passwort ist wichtig, um sp\u00e4ter ggf. Software innerhalb der Disitribution nachzuinstallieren. Daher nicht einfach irgendwas vergeben (das habe ich nun schon ein paar Mal im Netz gelesen). Passwort als im Idealfall via Password Manager generieren und speichern 😉<\/p>\n\n\n\n
    \"\"<\/a>
    Nach der Installation m\u00fcssen Benutzername und Passwort festgelegt werden.<\/figcaption><\/figure>\n\n\n\n
    Installation einer alternativen Linux-Distribution unter Windows<\/h2>\n\n\n\n
    Stand heute (Juli 2022) steht bei der Installation von WSL via PowerShell nur Ubuntu 20.04 zur Verf\u00fcgung. Diese Distribution wird auch standardm\u00e4\u00dfig mitinstalliert. Man hat zwar die M\u00f6glichkeit andere Distributionen zu installieren (Kommando \u201ewsl -l -o\u201c listet die verf\u00fcgbaren auf), allerdings ist Ubuntu 22.04 LTS aktuell keine davon.<\/p>\n\n\n\n
    Da ich gerne auf aktuellere Paketquellen zugreifen m\u00f6chte (unter anderem um bsw. > php-8.X zu installieren), werde ich Ubuntu 22.04 als meine Standard-Distribution nachinstallieren. Dieser Vorgang ist allerdings optional. Wer mit Ubuntu 20.04 zurecht kommt, kann direkt zum n\u00e4chsten Schritt weiter (Installation von Docker-Desktop und Aktivierung von WSL2)<\/p>\n\n\n\n
    Installation von Ubuntu 22.04 via Microsoft App Store<\/h3>\n\n\n\n
    Die Installation ist relativ simpel, sie kann direkt via App Store erfolgen. Einfach nach Ubuntu suchen und die passende Version finden, anschlie\u00dfend ausw\u00e4hlen und via \u201eHerunterladen\u201c installieren.<\/p>\n\n\n\n
    \"\"<\/a><\/figure>\n\n\n\n
    Linux-Distribution initial \u00f6ffnen<\/h3>\n\n\n\n
    Nachdem die Linux-Distribution heruntergeladen wurde, erscheint im App-Store der Button \u201e\u00d6ffnen\u201c \u2013 alternativ ist Ubuntu 22.04 jetzt nat\u00fcrlich auch \u00fcber das Startmenu wie jede andere App zu \u00f6ffnen. Wichtig beim ersten \u00d6ffnen ist allerdings, dass die Einrichtung stattfindet \u2013 in der unter anderem Benutzername und Passwort festgelegt werden. Bei den anderen Optionen k\u00f6nnen einfach die Standardeinstellungen \u00fcbernommen werden.<\/p>\n\n\n\n
    \"\"<\/a>
    Nach der Installation l\u00e4sst sich Ubuntu \u00f6ffnen.<\/figcaption><\/figure>\n\n\n\n
    \"\"<\/a><\/figure>\n\n\n\n
    Nach dem \u00d6ffnen findet erst einmal die Einrichtung statt, das kann auch schon mal ein paar Minuten dauern. Die Konfiguration und Vergabe von Benutzername und Passwort erfolgen danach gef\u00fchrt. Als Sprache habe ich \u201eDeutsch\u201c ausgew\u00e4hlt, ansonsten die Standardeinstellungen \u00fcbernommen.<\/p>\n\n\n\n
    Neue Linux-Distribution Ubuntu 22.04 als Standard WSL-Distribution konfigurieren<\/h3>\n\n\n\n
    Nach der Installation kann \u00fcberpr\u00fcft werden, ob die Installation erfolgreich war. Dazu wird wieder in einer Powershell der Befehl<\/p>\n\n\n\n
    wsl -l -v<\/code><\/pre>\n\n\n\n
    eingegeben. Dieser listet die installierten Linux-Distributionen auf:<\/p>\n\n\n\n
    \"\"<\/a><\/figure>\n\n\n\n
    Das Sternchen zeigt an, welche Distribution die Standardversion ist. \u201eVERSION\u201c steht in diesem Fall f\u00fcr die WSL Version \u2013 in diesem Fall die Version 2, was genau der entspricht, die wir brauchen. Ich setze jetzt Ubuntu 22.04 als Standard-Distribution mit dem folgenden Befehl:<\/p>\n\n\n\n
    wsl \u2013-set-default Ubuntu-22.04<\/code><\/pre>\n\n\n\n
    Die Ausgabe ist leise, d.h. es erfolgt keine Meldung:<\/p>\n\n\n\n
    \"\"<\/a><\/figure>\n\n\n\n
    Wir verifizieren im Anschluss mit dem vorherigen Befehl, um zu \u00fcberpr\u00fcfen ob der Vorgang erfolgreich war:<\/p>\n\n\n\n
    wsl -l -v<\/code><\/pre>\n\n\n\n
    \"\"<\/a><\/figure>\n\n\n\n
    Nicht mehr ben\u00f6tigte WSL Distribution deinstallieren<\/h3>\n\n\n\n
    Damit ich nur noch auf die Ubuntu Version 22.04 zugreife und nicht versehentlich in der 20.04 lande, deinstalliere ich schlussendlich noch die 20.04er Version mit dem folgenden Kommando:<\/p>\n\n\n\n
    wsl \u2013-unregister Ubuntu<\/code><\/pre>\n\n\n\n
    Danach sieht das Ganze bei mir so aus:<\/p>\n\n\n\n
    \"\"<\/a><\/figure>\n\n\n\n
    Dieser Schritt ist allerdings nicht zwingend erforderlich, es ist \u00fcberhaupt kein Problem, dass beide Distributionen parallel installiert sind (oder noch viele weitere).<\/p>\n\n\n\n
    Installation von Docker-Desktop und Aktivierung von WSL2<\/h2>\n\n\n\n
    Jetzt wird einfach Docker f\u00fcr Windows installiert \u2013 dazu einfach auf https:\/\/www.docker.com\/get-started\/<\/a> runterladen und installieren. Bei der Installation ist \u201eUse WSL 2 instead of Hyper-V (recommendend)\u201c schon vorausgew\u00e4hlt und sollte keinesfalls abgew\u00e4hlt werden.<\/p>\n\n\n\n
    \"\"<\/a><\/figure>\n\n\n\n
    Nach erfolgreicher Installation wird man aufgefordert, sich aus- und wieder einzuloggen. Ausgelogged wird man von Docker nach Bet\u00e4tigung des Buttons automatisch. Sobald man sich wieder einlogged, sollte Docker Desktop automatisch starten. Das Service Agreement muss noch akzeptiert werden.<\/p>\n\n\n\n
    WSL-Integration in Docker Desktop aktivieren<\/h3>\n\n\n\n
    Nachdem Docker Desktop erfolgreich gestartet wurde, muss die WSL Integration f\u00fcr die Linux-Distribution noch aktiviert werden. Dazu via Zahnrad in die Einstellungen und unter General erst einmal sicherstellen, dass \u201eUse the WSL 2 based engine\u201c aktiviert ist:<\/p>\n\n\n\n
    \"\"<\/a><\/figure>\n\n\n\n
    Danach unter \u201eResources > WSL Integration\u201c sicherstellen, dass diese f\u00fcr alle erforderlichen Distros aktiviert ist:<\/p>\n\n\n\n
    \"\"<\/a><\/figure>\n\n\n\n
    Ausf\u00fchren eines Containers mit deutlich gestiegener Geschwindigkeit<\/h2>\n\n\n\n
    So \u2013 fertig. Nun k\u00f6nnen Docker Container via WSL 2 benutzt werden. Wichtig dabei ist, dass die Installation und vor Allem das Mounten von Dateien oder Containern innerhalb der Linux-Distribution stattfinden sollten.<\/p>\n\n\n\n
    Das ist so wie so viel praktischer, weil die Handhabung, Installation usw. innerhalb einer nativen Linux-Umgebung (zumindest IMHO) viel einfacher ist und relevante Entwicklungswerkzeuge (wie bsw. composer) viel einfacher installiert und operiert werden k\u00f6nnen.<\/p>\n\n\n\n
    Zum Ausf\u00fchren eines Containers \u00f6ffne ich also zun\u00e4chst die Ubuntu App (bsw. via Startmenu) und navigiere in einen geeigneten Ordner. Gestartet wird die Linux-Distribution immer im Home-Verzeichnis des Users, also in meinem Fall \/home\/simon\/.<\/p>\n\n\n\n
    Ich lege dazu neue Verzeichnisse an und navigiere hinein:<\/p>\n\n\n\n
    mkdir projects\ncd projects\nmkdir demo\ncd demo<\/code><\/pre>\n\n\n\n
    Anschlie\u00dfend starte \/ installiere ich meine Container wie gewohnt, bsw. so:<\/p>\n\n\n\n
    docker run \u2013name nginx-demo -p  8080:80 nginx<\/code><\/pre>\n\n\n\n
    Docker muss nicht installiert warden, es steht ja durch die WSL Integration innerhalb der Linux-Distribution schon zur Verf\u00fcgung. Docker l\u00e4dt den Container automatisch runter und startet ihn:<\/p>\n\n\n\n
    \"\"<\/a><\/figure>\n\n\n\n
    Et voila \u2013 das hat funktioniert. Ich kann nun auf den Container via http mit meinem Windows-Browser zugreifen:<\/p>\n\n\n\n
    \"\"<\/a><\/figure>\n\n\n\n
    Das Ganze jetzt mit einer deutlich erh\u00f6hten Geschwindigkeit. Den Status meiner Docker Container und alles weitere kann ich wie gewohnt weiter \u00fcber Docker Desktop sehen\/machen:<\/p>\n\n\n\n
    \"\"<\/a><\/figure>\n\n\n\n
    Fertig<\/h2>\n\n\n\n
    Als N\u00e4chstes stehen wir nat\u00fcrlich vor der H\u00fcrde, dass i.d.R. Verzeichnisse in die Container eingehangen werden m\u00fcssen und an den Dateien gearbeitet werden muss. Git Operationen und alles andere kann ja einfach via Linux-Kommdandozeile durchgef\u00fchrt werden. F\u00fcr eine IDE klappt das so einfach nat\u00fcrlich nicht. Es gibt die unterschiedlichsten Wege das zu bewerkstelligen, der aus meiner Sicht einfachste und komfortabelste w\u00e4re eine IDE, die WSL unterst\u00fctzt. Ich nutze dazu Visual Studio Code, welches eine eigene WSL Extension hat, mit der problemlos auf die Dateien innerhalb der Linux-Distro zugegriffen werden kann. Dazu einfach die WSL Extension in VS Code installieren und fertig 😉<\/p>\n