Update documentation: CHANGELOG v0.2.0, Synology compatibility guide

This commit is contained in:
XPS\Micro 2026-01-31 00:01:32 +01:00
parent fa03fb0f3d
commit b6fd832311
2 changed files with 111 additions and 0 deletions

View File

@ -347,4 +347,82 @@ chown -R 1000:1000 /volume1/docker/spawner/logs
---
## Synology NAS / BusyBox Kompatibilitaet
Das Installationsskript ist vollstaendig kompatibel mit Synology NAS und anderen BusyBox-basierten Systemen.
### Automatische Anpassungen
Das Skript erkennt und behandelt automatisch:
| Problem | Loesung |
|---------|---------|
| `git safe.directory` Fehler | Automatische Konfiguration |
| Kein `sort -V` (Versionsort) | Eigene Versionsvergleich-Funktion |
| Kein `grep -P` (Perl-Regex) | POSIX-kompatible Alternativen |
| Kein `--progress=plain` | Flag wird nicht verwendet |
| Aeltere Docker-Version | BuildKit-Features deaktiviert |
### Bekannte Einschraenkungen auf Synology
1. **Build-Zeit**: Docker-Builds dauern laenger (5-15 Min fuer Next.js)
2. **RAM**: Mindestens 4 GB RAM empfohlen
3. **Docker-Version**: Synology verwendet oft aeltere Docker-Versionen
### Manuelle Vorbereitung (optional)
```bash
# Als root auf der Synology einloggen
sudo -i
# In Installationsverzeichnis wechseln
cd /volume1/docker
mkdir spawner
cd spawner
# Installation starten
curl -sSL https://gitea.iotxs.de/RainerWieland/spawner/raw/branch/main/install.sh | bash
```
### Troubleshooting Synology
#### "dubious ownership" Fehler
Falls dieser Fehler auftritt:
```bash
git config --global --add safe.directory /volume1/docker/spawner
```
Das Skript macht dies automatisch, aber bei Problemen kann es manuell ausgefuehrt werden.
#### Docker-Build schlaegt fehl
```bash
# Build-Logs pruefen
cat /tmp/build-user-template.log
cat /tmp/build-spawner.log
cat /tmp/build-frontend.log
# Images manuell bauen
cd /volume1/docker/spawner
docker build -t user-service-template:latest ./user-template/
docker build -t spawner:latest .
docker build -t spawner-frontend:latest ./frontend/
```
#### Container startet nicht
```bash
# Logs pruefen
docker logs spawner
docker logs spawner-frontend
# Netzwerk pruefen
docker network ls
docker network inspect web
```
---
Zurueck zur [Dokumentations-Uebersicht](../README.md)

View File

@ -19,6 +19,39 @@ Das Format basiert auf [Keep a Changelog](https://keepachangelog.com/de/1.0.0/).
---
## [0.2.0] - 2026-01-31
### Hinzugefuegt
- Synology NAS / BusyBox Kompatibilitaet im Installationsskript
- Automatische Docker-Version Pruefung (>= 20.10)
- Automatische Docker Compose Version Pruefung (>= 2.0)
- Traefik-Laufzeit-Pruefung im Installationsskript
- Traefik-Netzwerk-Verbindungspruefung
- Build-Fortschrittsanzeige mit gefilterten Logs
- Automatische `git safe.directory` Konfiguration fuer NAS-Umgebungen
### Geaendert
- `auth.py`: Redirect zum Frontend statt Jinja2-Templates
- `docker-compose.yml`: Legacy-Router entfernt (verhindert Redirect-Loop)
- Dockerfiles: Fallback auf `npm install` wenn `package-lock.json` fehlt
- `--progress=plain` Flag entfernt (nicht kompatibel mit aelteren Docker-Versionen)
- Build-Verifikation prueft jetzt Exit-Code UND Image-Existenz
### Behoben
- Redirect-Loop bei `/login` und `/signup` behoben
- `@/lib/utils` Module-Not-Found Fehler in Next.js Projekten
- `.gitignore` blockierte `frontend/src/lib/` und `user-template-next/src/lib/`
- `tsconfig.json` fehlte `baseUrl` fuer TypeScript Path Aliases
- Docker Build meldete faelschlicherweise "OK" bei Fehlern
### Entfernt
- `templates/` Verzeichnis (alte Jinja2 Templates, ersetzt durch Next.js Frontend)
### Sicherheit
- Keine sensiblen Dateien (`.env`, `CLAUDE.md`) werden ins Repository kopiert
---
## [0.1.0] - 2026-01-30
### Hinzugefuegt