Moodle VSCode Dev Container Example

1. Docker installieren
   1. Windows
   2. macOS
2. Installation VSCode
   1. Windows
   2. macOS
3. Erster Start von VSCode
4. Container starten

Docker installieren

Windows

1. WSL2 installieren

https://learn.microsoft.com/de-de/windows/wsl/install

• In der Regel genügt es, den Befehl wsl --install in einem Windows Terminal mit Admin-Rechten auszuführen.
• Windows muss ggfs. neu gestartet werden.

2. Docker Desktop für Windows installieren

https://www.docker.com/

• Beim Installieren darauf achten, dass das Häkchen ✔️ bei Use WSL 2 instead of Hyper-V (recommended) gesetzt ist.
• Anschließend Docker starten. Sobald das Rechteck unten links grün wird (beim Darüberfahren mit der Maus erscheint der Tooltip Engine running), kann das Fenster geschlossen werden ❌
• ❗ Wichtig: Docker sollte weiterhin im Systemtray laufen (unten rechts in der Taskbar) ❗

macOS

Variante 1: Docker Desktop für Mac mit brew installieren

Ein elleganteter Weg zur Installation ist mit Homebrew und Homebrew Cask.

brew install --cask docker     # Installiert Docker
open /Applications/Docker.app  # Startet Docker

Variante 2: Docker Desktop über Download installieren

https://www.docker.com/

• Beim Download darauf achten, dass die richtige Chip-Variante ausgewählt wird (Intel Chip amd-64 vs Apple Chip arm-64).
• Herrausfindbar ist dies über das Apple-Menü () -> "Über diesen Mac" -> Chip / Prozessor Bezeichnung.
• Anschließend Docker starten. Sobald das Rechteck unten links grün wird (beim Darüberfahren mit der Maus erscheint der Tooltip Engine running), kann das Fenster geschlossen werden ❌
• ❗ Wichtig: Docker sollte weiterhin laufen und der Prozess sollte nicht manuell beendet werden ❗

Empfehlung macOS

Um die Performance von Docker unter macOS maßgeblich zu verbessern sollte der VirtioFS Treiber aktiviert sein. Dieser findet sich in Docker Desktop unter Settings -> Beta features -> Enable VirtioFS accelerated directory sharing.

Installation VSCode

Windows

https://code.visualstudio.com/

• Beim Starten von VS Code sollte Docker auf dem System erkannt werden und das Installieren der empfohlenen Erweiterungen vorgeschlagen werden: Dev Containers von Microsoft (ms-vscode-remote.remote-containers) und - im Falle von Windows - WSL von Microsoft (ms-vscode-remote.remote-wsl). Diese Erweiterungen installieren.

Empfehlung Windows

Da PHP-Anwendungen in Docker unter Windows Performanceprobleme haben können (wie es bei Moodle leider der Fall ist) empfiehlt es sich, den Devcontainer direkt aus der WSL heraus zu bedienen. Dazu mit der WSL Extension in VSCode in die WSL verbinden (über die Schaltfläche unten links) und das Verzeichnis direkt in die WSL clonen.

macOS

Variante 1: Mit brew installieren

brew install --cask visual-studio-code

Variante 2: Über Download von der Webseite

https://code.visualstudio.com/

Erster Start von VSCode

Beim Starten von VS Code sollte Docker auf dem System erkannt werden und das Installieren der empfohlenen Erweiterungen vorgeschlagen werden: Dev Containers von Microsoft (ms-vscode-remote.remote-containers) und - im Falle von Windows - WSL von Microsoft (ms-vscode-remote.remote-wsl). Diese Erweiterungen installieren.

Container starten

• In VS Code über Datei → Ordner öffnen... zu dem Verzeichnis navigieren, in dem sich der geclonte Ordner (Default moodle-vscode-dev-container-example) befindet, und diesen öffnen
• VS Code sollte erkennen, dass das Verzeichnis eine Dev Container-Konfigurationsdatei enthält, und vorschlagen, den Ordner zum Entwickeln in einem Container zu öffnen.
• Auf Reopen in Container klicken.
• Beim erstmaligen Öffnen wird nun Moodle installiert. Das kann einige Zeit in Anspruch nehmen 🕒

Anschließend sollte Moodle über localhost:8080/moodle-400 erreichbar sein.