loepperts/doing-it-website

Fork 0

Files

loepperts 9be0af25f7 added quartz external wiki

2025-11-29 10:30:33 +01:00

2.4 KiB

Executable File

Raw Blame History

Wiki Deployment Checklist

✅ Vor dem Deployment

Alle Änderungen committed
API-Route app/api/wiki/route.ts vorhanden
API-Route app/api/wiki/[...path]/route.ts vorhanden
Wiki-Seite app/wiki/page.tsx vorhanden
Docker-Compose mit beiden Services konfiguriert

🔧 Deployment-Schritte

1. Services neu starten

docker-compose down
docker-compose up -d --build

2. Services prüfen

docker-compose ps

Erwartet: Beide Services (web, wiki) sollten "Up" zeigen

3. Wiki-Service-Logs prüfen

docker-compose logs wiki --tail=50

Erwartet: "Build complete. Starting server on port 8080..."

4. API-Route testen

curl https://doing-it.de/api/wiki/

Erwartet: HTML-Inhalt des Wikis, nicht 404

5. Wiki-Seite testen

Browser: https://doing-it.de/wiki Erwartet: Wiki wird im iframe angezeigt

🐛 Troubleshooting

Problem: 404 auf /wiki

Schritt 1: Prüfe ob Wiki-Service läuft

docker-compose ps wiki
docker-compose logs wiki

Schritt 2: Prüfe ob API-Route erreichbar ist

curl https://doing-it.de/api/wiki/

Schritt 3: Prüfe interne Kommunikation

docker-compose exec web curl http://wiki:8080/

Schritt 4: Prüfe Environment-Variable

docker-compose exec web printenv WIKI_SERVICE_URL

Sollte sein: http://wiki:8080

Schritt 5: Prüfe Next.js Logs

docker-compose logs web | grep -i wiki

Problem: Wiki lädt nicht im iframe

Lösung 1: Prüfe Browser-Konsole (F12) auf Fehler

Lösung 2: Prüfe ob API-Route HTML zurückgibt

curl -I https://doing-it.de/api/wiki/

Lösung 3: Prüfe CORS-Header (sollte bereits gesetzt sein)

📝 Wichtige Konfiguration

docker-compose.yml sollte enthalten:

web:
  environment:
    - WIKI_SERVICE_URL=http://wiki:8080
  depends_on:
    - wiki

wiki:
  expose:
    - "8080"

Environment-Variable

Die WIKI_SERVICE_URL muss auf http://wiki:8080 gesetzt sein (Docker-Service-Name, nicht localhost!).

✅ Nach erfolgreichem Deployment

Wiki ist unter https://doing-it.de/wiki erreichbar
Navigation-Link funktioniert
Wiki-Inhalte werden angezeigt
Keine 404-Fehler
Keine Fehler in Browser-Konsole

2.4 KiB Executable File Raw Blame History