88 lines
1.8 KiB
Markdown
Executable File
88 lines
1.8 KiB
Markdown
Executable File
# Debug-Anleitung für Wiki-Setup
|
|
|
|
## Problem behoben: Node.js Version
|
|
|
|
**Problem**: Quartz 4.5.2 benötigt Node.js >= 22, wir hatten Node 20.
|
|
|
|
**Lösung**: Dockerfile wurde aktualisiert auf `node:22-alpine`
|
|
|
|
## Build-Anweisungen
|
|
|
|
### 1. Wiki-Service neu bauen (nach Node.js Update)
|
|
```powershell
|
|
docker-compose build --no-cache wiki
|
|
```
|
|
|
|
### 2. Alle Services bauen
|
|
```powershell
|
|
docker-compose build
|
|
```
|
|
|
|
### 3. Services starten
|
|
```powershell
|
|
docker-compose up -d
|
|
```
|
|
|
|
### 4. Logs prüfen
|
|
```powershell
|
|
# Alle Logs
|
|
docker-compose logs
|
|
|
|
# Nur Wiki-Logs
|
|
docker-compose logs wiki
|
|
|
|
# Live-Logs folgen
|
|
docker-compose logs -f wiki
|
|
```
|
|
|
|
### 5. Container-Status prüfen
|
|
```powershell
|
|
docker-compose ps
|
|
```
|
|
|
|
## Erwartete Ausgabe beim Build
|
|
|
|
Beim erfolgreichen Build sollten Sie sehen:
|
|
- ✅ Git wird installiert
|
|
- ✅ npm wird aktualisiert
|
|
- ✅ Quartz Repository wird geklont
|
|
- ✅ npm install läuft durch (kann einige Minuten dauern)
|
|
- ✅ serve wird installiert
|
|
|
|
## Wenn der Build immer noch fehlschlägt
|
|
|
|
### Option 1: Container-Status prüfen
|
|
```powershell
|
|
docker ps -a
|
|
docker-compose logs wiki --tail=100
|
|
```
|
|
|
|
### Option 2: In Container einsteigen und manuell testen
|
|
```powershell
|
|
# Container starten (auch wenn Build fehlschlägt)
|
|
docker-compose run --rm wiki sh
|
|
|
|
# Dann im Container:
|
|
cd /app/quartz-repo
|
|
npm install
|
|
```
|
|
|
|
### Option 3: Cache leeren und neu bauen
|
|
```powershell
|
|
docker-compose down
|
|
docker system prune -f
|
|
docker-compose build --no-cache wiki
|
|
```
|
|
|
|
## Erwartete Ports
|
|
|
|
- **Web (Next.js)**: http://localhost:3001
|
|
- **Wiki (Quartz)**: http://localhost:8080
|
|
|
|
## Nächste Schritte nach erfolgreichem Build
|
|
|
|
1. Services starten: `docker-compose up -d`
|
|
2. Wiki aufrufen: http://localhost:8080
|
|
3. Wiki-Seite testen: http://localhost:3001/wiki
|
|
|