Vorbereitung:

1. Optional: Windows Terminal installieren (https://learn.microsoft.com/de-de/windows/terminal/install)
2. Folgende Windows-Features aktivieren und anschließend neu starten:
   • Hyper-V
   • Windows Subsystem for Linux
   • VM-Plattform
3. Powershell: wsl --update
4. Git auf Windows installieren. Dieses wird nun nur noch benötigt, um die nachfolgende Einrichtung für WSL durchzuführen. Dabei wird dann git auch innerhalb von WSL installiert. Für die spätere Entwicklung kann dann dieses Binary verwendet werden.
5. Powershell: git config --global core.autocrlf input
6. Optional: Bei erstmaliger Einrichtung eines Users einen SSH Key anlegen: Powershell ssh-keygen -t ed25519 -C "<email>@wagner-ecommerce.group". Das somit erstellte SSH Keypaar befindet sich nun im Ordner %HOMEPATH%\.ssh. Den Publickey (Dateiendung .pub) bei GitHub hinterlegen.

Start:

1. Repo "wsltooling" in C:\Users<windows-username>\git klonen: https://github.com/cherrmann89/wsltooling
2. Verzeichnis C:\Users<windows-username>\wsl anlegen
3. GitHub Token mit den Rechten repo:all, read:org und admin:public_key:all erzeugen und in C:\Users<windows-username>\wsl\.token speichern
4. Verknüpfung im Verzeichnis C:\Users<windows-username>\wsl anlegen. Als Speicherort powershell.exe -NoExit -execution bypass "%HOMEPATH%\git\wsltooling\installUbuntuLTS.ps1 dev-infra %HOMEPATH%\wsl\dev-infra <wsl-distro-username> <github-username> C:\Users\<windows-username>\wsl\.token" angeben. Hierbei kann der <wsl-distro-username> frei gewählt werden, <github-username> muss dem Usernamen bei GitHub entsprechen und <windows-username> dem Usernamen auf Windows. Im nächsten Schritt kann der Verknüpfungsname frei gewählt werden.
5. Sicherstellen, dass das VPN aktiv ist.
6. Die gerade erstellte Verknüpfung per Doppelklick ausführen. Leider können nicht alle für das Skript benötigten Parameter direkt mit in der Verknüpfung angegeben werden, da es hier eine Längenbeschränkung gibt. Daher werden bei Ausführung der Verknüpfung die restlichen Parameter abgefragt und diese müssen über die sich öffnende PowerShell eingegeben werden.
7. Das ausgeführte Skript installiert nun eine aktuelle Ubuntu Version als WSL Distro und startet anschließend ein Ansible Playbook, um die Distro zu provisionieren.

Nachbereitung:

1. Host-Einträge anlegen (C:\Windows\System32\drivers\etc\hosts)

   IP der WSL-Instanz mittels Powershell ermitteln:

   wsl -d dev-infra ip -o -4 -json addr list eth0 | ConvertFrom-Json | %{ $_.addr_info.local } | ?{ $_ }

   Host-Einträge:

   <WSL-IP> web.dev.local

   <WSL-IP> lvs.dev.local

2. Umgebungsvariable für Xdebug erstellen und laden. Innerhalb der dev-infra Bash:

   • echo 'export PHP_IDE_CONFIG="serverName=WSL-dev-infra"' >> ~/.profile; source ~/.profile

3. PHPStorm durch Firewall zulassen: Das Menü "Apps über die Windows-Firewall kommunizieren lassen" -> "Einstellungen ändern" -> In der Liste PHPStorm suchen und den Haken bei Domäne und Privat setzen.

Konfiguration eines neuen Projekts in PhpStorm

1. PHP-Interpreter:
   • Settings -> PHP -> CLI-Interpreter -> + -> "From Docker, Vagrant [...]"
   • WSL Distro auswählen
2. Server erstellen:
   • Settings -> PHP -> Servers -> + Name: WSL-dev-infra Host: web.dev.local Port: 443 Debugger: Xdebug Use Path mappings: /home/<wsl-distro-username/projects/shop
3. Debugger konfigurieren:
   • Settings -> PHP -> Debug -> Sektion Xdebug Debug port: 9003,9000,9010
4. PhpStan konfigurieren
   • Settings -> PhpStan
5. Composer konfigurieren
   • Settings -> PHP -> Composer: Unter Path to composer.json den Pfad auswählen (z.B. im shop Repo \\wsl.localhost\dev-infra\home<wsl-username>\projects\shop\composer.json) und unter Execution Remote Interpreter auswählen. Als CLI Interpreter den unter Punkt 1. erstellten CLI Interpreter auswählen. Path mappings und Executable sollten direkt gesetzt sein.
   • Anschließend kann die composer Integration über PHPStorm benutzt werden, z.B. wenn die composer.json geöffnet ist, kann man auf install klicken, um die Abhängigkeiten zu installieren.
6. Node konfigurieren
   • Settings -> Languages & Frameworks -> Node.js: Hinter Node Interpreter auf die 3 Punkte klicken, dann mit dem + einen neuen Interpreter hinzufügen Add WSL. Als Linux distribution dev-infra auswählen. Der Pfad zum Executable sollte dann direkt ausgefüllt werden.
   • Der Pfad zum npm executable sollte dann auch direkt ausgefüllt sein.
   • Anschließend kann die npm Integration über PHPStorm benutzt werden, z.B. wenn die package.json geöffnet ist, erscheint ein Pop mit npm install oder man kann direkt einzelne Befehle in der package.json anklicken und somit laufen lassen.

Neuerstellung der Distro

1. Projekte auf ungepushte Änderungen überprüfen

2. Distro mittels Powershell entfernen

   wsl --unregister dev-infra

3. Angelegte Verknüpfung im Verzeichnis C:\Users<windows-username>\wsl ausführen