added quartz external wiki
This commit is contained in:
110
DEPLOYMENT-CHECKLIST.md
Executable file
110
DEPLOYMENT-CHECKLIST.md
Executable file
@@ -0,0 +1,110 @@
|
||||
# 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
|
||||
```bash
|
||||
docker-compose down
|
||||
docker-compose up -d --build
|
||||
```
|
||||
|
||||
### 2. Services prüfen
|
||||
```bash
|
||||
docker-compose ps
|
||||
```
|
||||
**Erwartet:** Beide Services (web, wiki) sollten "Up" zeigen
|
||||
|
||||
### 3. Wiki-Service-Logs prüfen
|
||||
```bash
|
||||
docker-compose logs wiki --tail=50
|
||||
```
|
||||
**Erwartet:** "Build complete. Starting server on port 8080..."
|
||||
|
||||
### 4. API-Route testen
|
||||
```bash
|
||||
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
|
||||
```bash
|
||||
docker-compose ps wiki
|
||||
docker-compose logs wiki
|
||||
```
|
||||
|
||||
**Schritt 2:** Prüfe ob API-Route erreichbar ist
|
||||
```bash
|
||||
curl https://doing-it.de/api/wiki/
|
||||
```
|
||||
|
||||
**Schritt 3:** Prüfe interne Kommunikation
|
||||
```bash
|
||||
docker-compose exec web curl http://wiki:8080/
|
||||
```
|
||||
|
||||
**Schritt 4:** Prüfe Environment-Variable
|
||||
```bash
|
||||
docker-compose exec web printenv WIKI_SERVICE_URL
|
||||
```
|
||||
Sollte sein: `http://wiki:8080`
|
||||
|
||||
**Schritt 5:** Prüfe Next.js Logs
|
||||
```bash
|
||||
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
|
||||
```bash
|
||||
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:
|
||||
|
||||
```yaml
|
||||
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
|
||||
|
||||
Reference in New Issue
Block a user