Restructure README to prioritize Windows; add installation commands for optional tools (apt, dnf, winget)

This commit is contained in:
GitHub Copilot
2026-03-28 14:31:04 +01:00
parent c49774d629
commit 0446f9859d
+55 -42
View File
@@ -28,16 +28,9 @@ Basisrouten nach dem Start:
- `http://localhost:8080/hints.html` -> Hint Cheatsheet - `http://localhost:8080/hints.html` -> Hint Cheatsheet
- `http://localhost:8080/solutions.html` -> Musterloesungen - `http://localhost:8080/solutions.html` -> Musterloesungen
## Voraussetzungen (Linux / macOS / Windows WSL) ## Voraussetzungen
1. Docker + Compose (`docker compose` oder `docker-compose`) ### Windows (empfohlen)
2. Optional fuer TLS-Challenges: `easy-rsa`, `openssl`, `wireshark`
Docker muss in Linux installiert sein oder Docker Desktop mit WSL-Integration muss verfuegbar sein.
### Installation
#### Windows
Installiere die erforderlichen Tools mit winget: Installiere die erforderlichen Tools mit winget:
@@ -47,43 +40,75 @@ winget install --id Git.Git -e
winget install --id Docker.DockerDesktop -e winget install --id Docker.DockerDesktop -e
``` ```
Optional fuer TLS-Challenges:
```powershell
winget install --id OpenSSL.OpenSSL -e
winget install --id WiresharkFoundation.Wireshark -e
```
Nach der Installation von Docker Desktop aktiviere die WSL-Integration in den Einstellungen. Nach der Installation von Docker Desktop aktiviere die WSL-Integration in den Einstellungen.
Plattformhinweise: ### Linux / macOS
- Linux: Docker Engine oder Docker Desktop Docker Engine oder Docker Desktop installieren (falls `make` fehlt auf macOS: `xcode-select --install`).
- macOS: Docker Desktop (falls `make` fehlt -> `xcode-select --install`)
- Windows: Docker Desktop mit aktivierter WSL-Integration Optional fuer TLS-Challenges:
#### Ubuntu/Debian (apt)
```bash
sudo apt update
sudo apt install easy-rsa openssl wireshark
```
#### Fedora/RHEL (dnf)
```bash
sudo dnf install easy-rsa openssl wireshark
```
## Schnellstart ## Schnellstart
### Windows
```powershell
./scripts/workshop.ps1 -Action bootstrap
```
Falls PowerShell das Script blockiert:
```powershell
Set-ExecutionPolicy -Scope Process Bypass
```
Alternativ im WSL-Terminal:
```bash
./scripts/bootstrap.sh
```
### Linux / macOS ### Linux / macOS
```bash ```bash
./scripts/bootstrap.sh ./scripts/bootstrap.sh
``` ```
### Windows (WSL) Das Skript:
Option A (im WSL-Terminal): - prueft Docker + Compose
- erstellt `.env` aus `.env.example` (falls nicht vorhanden)
- startet den Stack
```bash Hinweis zu Skriptnamen:
./scripts/bootstrap.sh
```
Option B (PowerShell Wrapper): - `scripts/bootstrap.sh` ist der empfohlene Einstieg
- intern nutzt es `scripts/bootstrap-unix.sh`
- `scripts/bootstrap-wsl.sh` existiert nur noch als Kompatibilitaets-Wrapper
```powershell ## Neu deployen / resetten
./scripts/workshop.ps1 -Action bootstrap
```
Der PowerShell-Wrapper braucht kein `make` und ruft Linux-Skripte direkt in WSL auf. ### Windows
Falls PowerShell das Script blockiert:
```powershell
Set-ExecutionPolicy -Scope Process Bypass
```
Weitere Aktionen in PowerShell: Weitere Aktionen in PowerShell:
@@ -101,19 +126,7 @@ Wenn mehrere Distros installiert sind:
./scripts/workshop.ps1 -Action bootstrap -Distro Ubuntu-24.04 ./scripts/workshop.ps1 -Action bootstrap -Distro Ubuntu-24.04
``` ```
Das Skript: ### Linux / macOS
- prueft Docker + Compose
- erstellt `.env` aus `.env.example` (falls nicht vorhanden)
- startet den Stack
Hinweis zu Skriptnamen:
- `scripts/bootstrap.sh` ist der empfohlene Einstieg
- intern nutzt es `scripts/bootstrap-unix.sh`
- `scripts/bootstrap-wsl.sh` existiert nur noch als Kompatibilitaets-Wrapper
## Neu deployen / resetten
```bash ```bash
make redeploy make redeploy