Agent Zero
122 lines
2.9 KiB
Markdown
122 lines
2.9 KiB
Markdown
# LeoCRM Deployment
|
|
|
|
## Quick Start
|
|
|
|
### Option A: Coolify (empfohlen für Produktion)
|
|
|
|
```bash
|
|
# Einmalig: Umgebungsvariablen setzen
|
|
export COOLIFY_API_TOKEN="dein-token"
|
|
export COOLIFY_APP_UUID="deine-app-uuid"
|
|
|
|
# Deploy
|
|
python scripts/deploy.py
|
|
|
|
# Redeploy (ohne Neubuild)
|
|
python scripts/deploy.py --skip-build
|
|
```
|
|
|
|
Das Script macht automatisch:
|
|
1. Coolify Build & Deploy triggern
|
|
2. Persistent Volume in Coolify DB konfigurieren (automatisch, portabel)
|
|
3. Auf healthy Container warten
|
|
4. RLS auf allen Tenant-Tabellen sicherstellen
|
|
5. DB-Migrationen verifizieren
|
|
6. Worker-Container starten
|
|
7. App-Health verifizieren
|
|
8. Domain-Erreichbarkeit prüfen
|
|
|
|
**Funktioniert auf jeder Coolify-Instanz. Bei mehreren Apps. Bei Erst-Deploy und Redeploy.**
|
|
|
|
### Option B: Docker Compose (lokal / ohne Coolify)
|
|
|
|
```bash
|
|
# .env.docker erstellen
|
|
cp .env.docker.example .env.docker
|
|
$EDITOR .env.docker # SECRET_KEY, POSTGRES_PASSWORD, etc. ausfüllen
|
|
|
|
# Starten (alle 4 Container: Postgres, Redis, App, Worker)
|
|
docker compose --env-file .env.docker up --build -d
|
|
|
|
# Health check
|
|
curl http://localhost:8000/api/v1/health
|
|
|
|
# Stoppen
|
|
docker compose down
|
|
```
|
|
|
|
**Container:**
|
|
- `crm-postgres` — PostgreSQL 16 mit pgvector
|
|
- `crm-redis` — Redis 7
|
|
- `crm-app` — FastAPI API Server
|
|
- `crm-worker` — ARQ Background Worker
|
|
|
|
Alle mit persistenten Volumes. Kein Datenverlust bei Redeploy.
|
|
|
|
## Voraussetzungen
|
|
|
|
- Python 3.12+
|
|
- Docker & Docker Compose (für Option B)
|
|
- Coolify v4+ (für Option A)
|
|
- SSH-Zugang zum Server (für Option A)
|
|
|
|
## Umgebungsvariablen
|
|
|
|
Siehe `.env.example` für alle Variablen. Wichtigste:
|
|
|
|
| Variable | Pflicht | Default | Beschreibung |
|
|
|---|---|---|---|
|
|
| `DATABASE_URL` | Ja | — | PostgreSQL Connection String |
|
|
| `REDIS_URL` | Ja | — | Redis Connection String |
|
|
| `SECRET_KEY` | Ja | — | Mindestens 32 Zeichen |
|
|
| `ENVIRONMENT` | Nein | `development` | `production` oder `development` |
|
|
| `SESSION_COOKIE_SECURE` | Nein | `true` | In Production muss `true` |
|
|
| `STORAGE_PATH` | Nein | `/data/storage` | Datei-Upload-Pfad |
|
|
| `STORAGE_BACKEND` | Nein | `local` | `local` oder `s3` |
|
|
|
|
## S3 Storage (optional)
|
|
|
|
Die App unterstützt S3-kompatiblen Storage. Setze:
|
|
```bash
|
|
STORAGE_BACKEND=s3
|
|
S3_ENDPOINT=https://s3.example.com
|
|
S3_BUCKET=leocrm
|
|
S3_ACCESS_KEY=...
|
|
S3_SECRET_KEY=...
|
|
```
|
|
|
|
## Test- vs. Produktionsumgebung
|
|
|
|
**Test:**
|
|
```bash
|
|
python scripts/deploy.py --environment test
|
|
```
|
|
Eigene Coolify-App, eigene DB, eigene Domain (`crm-test.media-on.de`).
|
|
|
|
**Produktion:**
|
|
```bash
|
|
python scripts/deploy.py --environment production
|
|
```
|
|
|
|
## Troubleshooting
|
|
|
|
**Container nicht healthy:**
|
|
```bash
|
|
docker logs <container-name> --tail 50
|
|
```
|
|
|
|
**Migration fehlgeschlagen:**
|
|
```bash
|
|
docker exec <container> alembic upgrade head
|
|
```
|
|
|
|
**RLS nicht aktiv:**
|
|
```bash
|
|
python scripts/deploy.py --migrate-only
|
|
```
|
|
|
|
**Worker nicht gestartet:**
|
|
```bash
|
|
python scripts/deploy.py --skip-build # startet Worker automatisch
|
|
```
|