mirror of
https://github.com/Memo-2023/mana-monorepo.git
synced 2026-05-16 16:59:41 +02:00
61d181fbc2
Move inactive projects out of active workspace: - bauntown (community website) - maerchenzauber (AI story generation) - memoro (voice memo app) - news (news aggregation) - nutriphi (nutrition tracking) - reader (reading app) - uload (URL shortener) - wisekeep (AI wisdom extraction) Update CLAUDE.md documentation: - Add presi to active projects - Document archived projects section - Update workspace configuration Archived apps can be re-activated by moving back to apps/ 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
135 lines
3.2 KiB
Markdown
135 lines
3.2 KiB
Markdown
# uLoad Deployment Guide
|
|
|
|
## 🚀 Deployment Architektur
|
|
|
|
Die Anwendung wurde vereinfacht und läuft nun **ohne embedded PocketBase**. PocketBase wird als separater Service in Coolify deployed.
|
|
|
|
### Container-Struktur
|
|
|
|
```
|
|
uLoad Container (Port 3000)
|
|
├── SvelteKit App
|
|
├── Node.js Runtime
|
|
└── Health Check Endpoint
|
|
|
|
PocketBase Container (Port 8090) - Separat in Coolify
|
|
├── PocketBase Server
|
|
├── SQLite Database
|
|
└── Admin UI
|
|
```
|
|
|
|
## 📦 Was wurde geändert?
|
|
|
|
### Entfernte Komponenten:
|
|
|
|
- ❌ Embedded PocketBase im Container
|
|
- ❌ Supervisor Process Manager
|
|
- ❌ Docker Entrypoint Script
|
|
- ❌ PocketBase Initialisierungs-Scripts
|
|
- ❌ Port 8090 Mapping im App Container
|
|
- ❌ Volume für pb_data
|
|
|
|
### Neue Struktur:
|
|
|
|
- ✅ Schlanker Container nur mit SvelteKit
|
|
- ✅ Externe PocketBase Verbindung via `PUBLIC_POCKETBASE_URL`
|
|
- ✅ Direkte Node.js Ausführung (kein Supervisor)
|
|
- ✅ Reduzierte Image-Größe (~80MB kleiner)
|
|
|
|
## 🔧 Deployment in Coolify
|
|
|
|
### 1. PocketBase Service (falls noch nicht vorhanden)
|
|
|
|
```yaml
|
|
# Als separater Service in Coolify
|
|
Service: PocketBase
|
|
Port: 8090
|
|
Persistent Volume: /pb_data
|
|
```
|
|
|
|
### 2. uLoad App Service
|
|
|
|
```yaml
|
|
# docker-compose.coolify.yml verwenden
|
|
Service: uLoad
|
|
Port: 3000
|
|
Build: Dockerfile
|
|
Environment:
|
|
- PUBLIC_POCKETBASE_URL=http://pocketbase:8090 # Interner Service Name
|
|
- ORIGIN=https://ulo.ad
|
|
- PUBLIC_UMAMI_URL=...
|
|
- PUBLIC_UMAMI_WEBSITE_ID=...
|
|
```
|
|
|
|
## 🔄 Migration Steps
|
|
|
|
### Für bestehende Deployments:
|
|
|
|
1. **PocketBase Daten sichern** (falls noch embedded):
|
|
|
|
```bash
|
|
docker cp container_name:/app/pb_data ./pb_data_backup
|
|
```
|
|
|
|
2. **Externe PocketBase aufsetzen** in Coolify
|
|
|
|
3. **Daten importieren** in neue PocketBase Instanz
|
|
|
|
4. **Environment Variables anpassen**:
|
|
|
|
```env
|
|
PUBLIC_POCKETBASE_URL=http://pocketbase:8090
|
|
```
|
|
|
|
5. **Neues Image deployen** mit aktualisiertem Dockerfile
|
|
|
|
## 📝 Environment Variables
|
|
|
|
```env
|
|
# Required
|
|
PORT=3000
|
|
ORIGIN=https://ulo.ad
|
|
PUBLIC_POCKETBASE_URL=http://pocketbase:8090
|
|
|
|
# Optional
|
|
PUBLIC_UMAMI_URL=https://analytics.domain.com
|
|
PUBLIC_UMAMI_WEBSITE_ID=xxx-xxx-xxx
|
|
```
|
|
|
|
## 🏗️ Build & Deploy
|
|
|
|
### Lokal testen:
|
|
|
|
```bash
|
|
# Build
|
|
docker build -t uload:latest .
|
|
|
|
# Run mit externer PocketBase
|
|
docker run -p 3000:3000 \
|
|
-e PUBLIC_POCKETBASE_URL=https://pb.ulo.ad \
|
|
-e ORIGIN=http://localhost:3000 \
|
|
uload:latest
|
|
```
|
|
|
|
### Production Deploy:
|
|
|
|
```bash
|
|
# Via Coolify mit docker-compose.coolify.yml
|
|
# Oder direkt:
|
|
docker compose -f docker-compose.yml up -d
|
|
```
|
|
|
|
## 📊 Vorteile der neuen Architektur
|
|
|
|
1. **Bessere Skalierbarkeit**: App und DB können unabhängig skaliert werden
|
|
2. **Einfachere Updates**: PocketBase Updates ohne App-Rebuild
|
|
3. **Kleinere Images**: ~120MB statt ~200MB
|
|
4. **Klarere Trennung**: Frontend und Backend sind klar getrennt
|
|
5. **Flexiblere Konfiguration**: PocketBase kann zentral für mehrere Apps genutzt werden
|
|
|
|
## ⚠️ Wichtige Hinweise
|
|
|
|
- PocketBase Hooks (`pb_hooks/`) müssen manuell zur externen PocketBase migriert werden
|
|
- Schema (`backend/pb_schema.json`) muss in der externen PocketBase importiert werden
|
|
- Interne Coolify Networking nutzen (nicht über Public URL)
|
|
- Health Check läuft nur auf Port 3000 (nicht mehr auf 8090)
|