Ergaenze WSL-Installation in der Windows-Anleitung

Die Windows-Voraussetzungen setzten WSL stillschweigend voraus. WSL
kann aber fehlen - dann scheitert der ganze Workshop am ersten Schritt.

- Schritt 1 neu: WSL2 + Ubuntu-24.04 per "wsl --install -d Ubuntu-24.04"
  (Admin-PowerShell), inkl. Neustart-/Benutzer-Hinweis und den Pruef-/
  Update-Kommandos (wsl --list --verbose/--online, wsl --update)
- Windows-Abschnitt in nummerierte Schritte gegliedert (WSL -> Tools -> TLS)
- Optionale TLS-Tools auf apt-in-WSL umgestellt (easy-rsa openssl tshark)
  statt nativem winget-OpenSSL/Wireshark - deckt sich mit wireshark-hints
  (natives Windows-Wireshark schneidet Docker-Loopback nicht zuverlaessig mit)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
hkoeck
2026-05-31 22:50:53 +02:00
parent b178d10c81
commit 239cb9a90a
+28 -7
View File
@@ -32,7 +32,26 @@ Basisrouten nach dem Start:
### Windows (empfohlen)
Installiere die erforderlichen Tools mit winget:
#### 1. WSL + Ubuntu installieren
WSL ist die Grundlage fuer den Workshop (alle Test-Kommandos laufen spaeter in der Linux-Shell). In einer **PowerShell als Administrator**:
```powershell
wsl --install -d Ubuntu-24.04
```
Das installiert WSL2 samt Ubuntu 24.04. Danach **Windows neu starten** und beim ersten Ubuntu-Start einen Linux-Benutzer (Name + Passwort) anlegen.
Pruefen bzw. verfuegbare Distros anzeigen:
```powershell
wsl --list --verbose # bereits installierte Distros + WSL-Version
wsl --list --online # installierbare Distros
```
Ist WSL schon vorhanden, nur aktualisieren: `wsl --update`. Fehlt nur die Distro, separat nachziehen: `wsl --install -d Ubuntu-24.04`.
#### 2. Tools installieren (winget)
```powershell
winget install --id Microsoft.VisualStudioCode -e
@@ -40,15 +59,17 @@ winget install --id Git.Git -e
winget install --id Docker.DockerDesktop -e
```
Optional fuer TLS-Challenges:
Nach der Installation von Docker Desktop die WSL-Integration in den Einstellungen aktivieren (Settings -> Resources -> WSL Integration -> Ubuntu-24.04).
```powershell
winget install --id OpenSSL.OpenSSL -e
winget install --id WiresharkFoundation.Wireshark -e
#### 3. Optionale TLS-Tools (in Ubuntu/WSL)
Die TLS-Challenges (Easy-RSA, OpenSSL, Wireshark/tshark) laufen am besten **innerhalb WSL**. Im Ubuntu-Terminal:
```bash
sudo apt update
sudo apt install -y easy-rsa openssl tshark
```
Nach der Installation von Docker Desktop die WSL-Integration in den Einstellungen aktivieren.
### Linux / macOS
Docker Engine oder Docker Desktop installieren.