111 lines
2.4 KiB
Markdown
Executable File
111 lines
2.4 KiB
Markdown
Executable File
# 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
|
|
|