Update documentation: CHANGELOG v0.2.0, Synology compatibility guide
This commit is contained in:
parent
fa03fb0f3d
commit
b6fd832311
|
|
@ -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)
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
Loading…
Reference in New Issue
Block a user