pironantoine
c0322d5c8e
Implement self-hosting for RockyLinux by adding systemd and Nginx configurations, updating API models to support standard OpenAI keys, and providing a comprehensive deployment guide. Replit-Commit-Author: Agent Replit-Commit-Session-Id: 923ae0e3-a363-4db8-b04a-e8baca2a1330 Replit-Commit-Checkpoint-Type: full_checkpoint Replit-Commit-Event-Id: f8aa455f-f180-4964-94dd-11cfb1a42383 Replit-Commit-Screenshot-Url: https://storage.googleapis.com/screenshot-production-us-central1/8af7d2ec-2cc3-4ece-8af3-9f071488d072/923ae0e3-a363-4db8-b04a-e8baca2a1330/VnHW0bR Replit-Helium-Checkpoint-Created: true
425 lines
10 KiB
Markdown
425 lines
10 KiB
Markdown
# Guide d'auto-hébergement — La Voix du Peuple
|
|
## RockyLinux 9 (ou RHEL 9, AlmaLinux 9)
|
|
|
|
---
|
|
|
|
## Architecture
|
|
|
|
```
|
|
Internet
|
|
│
|
|
▼
|
|
[Nginx] ─── /api/* ──► [Gunicorn + Flask] ──► [PostgreSQL]
|
|
│ │
|
|
└─── /* ──► [React SPA] └──► [OpenAI API]
|
|
(fichiers statiques)
|
|
```
|
|
|
|
- **Frontend** : React + Vite, servi comme fichiers statiques par Nginx
|
|
- **Backend** : Flask + Gunicorn (4 workers), accessible uniquement via Nginx
|
|
- **Base de données** : PostgreSQL 15+
|
|
- **IA** : API OpenAI (clé standard, pas de proxy Replit)
|
|
|
|
---
|
|
|
|
## Prérequis
|
|
|
|
```bash
|
|
# Mettre à jour le système
|
|
sudo dnf update -y
|
|
|
|
# Outils de base
|
|
sudo dnf install -y git curl wget epel-release
|
|
```
|
|
|
|
---
|
|
|
|
## 1. Installer les dépendances système
|
|
|
|
### Python 3.11
|
|
```bash
|
|
sudo dnf install -y python3.11 python3.11-pip python3.11-devel
|
|
python3.11 --version # doit afficher Python 3.11.x
|
|
```
|
|
|
|
### Node.js 20 (LTS)
|
|
```bash
|
|
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
|
|
sudo dnf install -y nodejs
|
|
node --version # doit afficher v20.x.x
|
|
```
|
|
|
|
### pnpm
|
|
```bash
|
|
npm install -g pnpm
|
|
pnpm --version
|
|
```
|
|
|
|
### PostgreSQL 15
|
|
```bash
|
|
sudo dnf install -y postgresql15-server postgresql15
|
|
sudo /usr/pgsql-15/bin/postgresql-15-setup initdb
|
|
sudo systemctl enable --now postgresql-15
|
|
```
|
|
|
|
### Nginx
|
|
```bash
|
|
sudo dnf install -y nginx
|
|
sudo systemctl enable nginx
|
|
```
|
|
|
|
---
|
|
|
|
## 2. Configurer PostgreSQL
|
|
|
|
```bash
|
|
# Connexion en tant que postgres
|
|
sudo -u postgres psql
|
|
|
|
-- Dans psql :
|
|
CREATE USER voixdupeuple WITH PASSWORD 'CHANGEME_MOT_DE_PASSE_FORT';
|
|
CREATE DATABASE voixdupeuple OWNER voixdupeuple;
|
|
GRANT ALL PRIVILEGES ON DATABASE voixdupeuple TO voixdupeuple;
|
|
\q
|
|
```
|
|
|
|
Éditez `/var/lib/pgsql/15/data/pg_hba.conf` pour autoriser la connexion locale par mot de passe :
|
|
|
|
```
|
|
# Remplacez "ident" par "md5" sur la ligne 127.0.0.1/32 :
|
|
host all all 127.0.0.1/32 md5
|
|
```
|
|
|
|
```bash
|
|
sudo systemctl restart postgresql-15
|
|
|
|
# Test de connexion
|
|
psql -U voixdupeuple -h 127.0.0.1 -d voixdupeuple -c "\dt"
|
|
```
|
|
|
|
---
|
|
|
|
## 3. Créer l'utilisateur système
|
|
|
|
```bash
|
|
sudo useradd -r -s /bin/bash -d /opt/voix-du-peuple voixdupeuple
|
|
sudo mkdir -p /opt/voix-du-peuple
|
|
sudo chown voixdupeuple:voixdupeuple /opt/voix-du-peuple
|
|
```
|
|
|
|
---
|
|
|
|
## 4. Cloner le dépôt depuis Gitea
|
|
|
|
```bash
|
|
sudo -u voixdupeuple bash -c "
|
|
cd /opt
|
|
git clone https://votre-gitea.example.com/utilisateur/voix-du-peuple.git voix-du-peuple
|
|
"
|
|
```
|
|
|
|
---
|
|
|
|
## 5. Configurer les variables d'environnement
|
|
|
|
```bash
|
|
sudo -u voixdupeuple bash -c "
|
|
cp /opt/voix-du-peuple/.env.example /opt/voix-du-peuple/.env
|
|
"
|
|
|
|
# Éditer le fichier .env
|
|
sudo nano /opt/voix-du-peuple/.env
|
|
```
|
|
|
|
Remplissez au minimum :
|
|
|
|
```env
|
|
DATABASE_URL=postgresql://voixdupeuple:CHANGEME_MOT_DE_PASSE_FORT@127.0.0.1:5432/voixdupeuple
|
|
OPENAI_API_KEY=sk-VOTRE_CLE_OPENAI
|
|
SESSION_SECRET=GENEREZ_UNE_VALEUR_ALEATOIRE_ICI
|
|
PORT=8000
|
|
FLASK_ENV=production
|
|
```
|
|
|
|
Générez le `SESSION_SECRET` :
|
|
```bash
|
|
python3.11 -c "import secrets; print(secrets.token_hex(32))"
|
|
```
|
|
|
|
Sécurisez le fichier :
|
|
```bash
|
|
sudo chmod 600 /opt/voix-du-peuple/.env
|
|
sudo chown voixdupeuple:voixdupeuple /opt/voix-du-peuple/.env
|
|
```
|
|
|
|
---
|
|
|
|
## 6. Installer les dépendances Python
|
|
|
|
```bash
|
|
sudo -u voixdupeuple bash -c "
|
|
cd /opt/voix-du-peuple
|
|
python3.11 -m venv .venv
|
|
.venv/bin/pip install --upgrade pip
|
|
.venv/bin/pip install -r artifacts/flask-api/requirements.txt
|
|
"
|
|
```
|
|
|
|
---
|
|
|
|
## 7. Initialiser la base de données
|
|
|
|
```bash
|
|
sudo -u voixdupeuple bash -c "
|
|
cd /opt/voix-du-peuple/artifacts/flask-api
|
|
source /opt/voix-du-peuple/.env
|
|
export DATABASE_URL OPENAI_API_KEY SESSION_SECRET FLASK_ENV PORT
|
|
/opt/voix-du-peuple/.venv/bin/python3 -c '
|
|
from database import init_db
|
|
init_db()
|
|
print(\"Base de données initialisée.\")
|
|
'
|
|
"
|
|
```
|
|
|
|
---
|
|
|
|
## 8. Construire le frontend React
|
|
|
|
```bash
|
|
sudo -u voixdupeuple bash -c "
|
|
cd /opt/voix-du-peuple
|
|
pnpm install --frozen-lockfile
|
|
|
|
cd artifacts/voix-du-peuple
|
|
pnpm exec vite build --config vite.config.selfhost.ts
|
|
"
|
|
```
|
|
|
|
Les fichiers statiques sont générés dans `artifacts/voix-du-peuple/dist/public/`.
|
|
|
|
---
|
|
|
|
## 9. Configurer le service systemd (Gunicorn)
|
|
|
|
```bash
|
|
# Créer le répertoire de logs
|
|
sudo mkdir -p /var/log/voix-du-peuple
|
|
sudo chown voixdupeuple:voixdupeuple /var/log/voix-du-peuple
|
|
|
|
# Copier le fichier de service
|
|
sudo cp /opt/voix-du-peuple/deploy/voix-du-peuple-api.service \
|
|
/etc/systemd/system/voix-du-peuple-api.service
|
|
|
|
# Activer et démarrer
|
|
sudo systemctl daemon-reload
|
|
sudo systemctl enable --now voix-du-peuple-api
|
|
|
|
# Vérifier
|
|
sudo systemctl status voix-du-peuple-api
|
|
```
|
|
|
|
Test de l'API :
|
|
```bash
|
|
curl http://127.0.0.1:8000/api/healthz
|
|
# {"status": "ok"}
|
|
```
|
|
|
|
---
|
|
|
|
## 10. Configurer Nginx
|
|
|
|
```bash
|
|
# Copier la config Nginx
|
|
sudo cp /opt/voix-du-peuple/deploy/nginx.conf \
|
|
/etc/nginx/conf.d/voix-du-peuple.conf
|
|
|
|
# Éditez le fichier pour mettre votre nom de domaine
|
|
sudo nano /etc/nginx/conf.d/voix-du-peuple.conf
|
|
# Remplacez voix-du-peuple.example.com par votre domaine
|
|
|
|
# Tester la configuration
|
|
sudo nginx -t
|
|
|
|
# Recharger Nginx
|
|
sudo systemctl reload nginx
|
|
```
|
|
|
|
---
|
|
|
|
## 11. Ouvrir le pare-feu
|
|
|
|
```bash
|
|
sudo firewall-cmd --permanent --add-service=http
|
|
sudo firewall-cmd --permanent --add-service=https
|
|
sudo firewall-cmd --reload
|
|
```
|
|
|
|
SELinux — autoriser Nginx à se connecter à Gunicorn :
|
|
```bash
|
|
sudo setsebool -P httpd_can_network_connect 1
|
|
```
|
|
|
|
---
|
|
|
|
## 12. (Recommandé) HTTPS avec Let's Encrypt
|
|
|
|
```bash
|
|
sudo dnf install -y certbot python3-certbot-nginx
|
|
|
|
sudo certbot --nginx -d voix-du-peuple.example.com \
|
|
--email admin@example.com --agree-tos --no-eff-email
|
|
|
|
# Renouvellement automatique (déjà configuré par certbot)
|
|
sudo systemctl status certbot-renew.timer
|
|
```
|
|
|
|
Puis décommentez le bloc HTTPS dans `/etc/nginx/conf.d/voix-du-peuple.conf`.
|
|
|
|
---
|
|
|
|
## Structure du projet
|
|
|
|
```
|
|
voix-du-peuple/
|
|
├── artifacts/
|
|
│ ├── flask-api/ # Backend Python Flask
|
|
│ │ ├── app.py # Application principale + routes
|
|
│ │ ├── ai_agent.py # Agent IA (filtrage + synthèse)
|
|
│ │ ├── legal_framework.py # Prompts ancrés dans le droit international
|
|
│ │ ├── database.py # Accès PostgreSQL (psycopg2)
|
|
│ │ ├── requirements.txt # Dépendances Python
|
|
│ │ └── start.sh # Démarrage développement
|
|
│ └── voix-du-peuple/ # Frontend React + Vite
|
|
│ ├── src/
|
|
│ │ ├── pages/ # home.tsx, about.tsx
|
|
│ │ ├── components/ # Composants UI (shadcn/ui + radix)
|
|
│ │ └── App.tsx # Routing principal
|
|
│ ├── vite.config.ts # Config Replit (développement)
|
|
│ └── vite.config.selfhost.ts # Config auto-hébergement (production)
|
|
├── lib/
|
|
│ ├── api-spec/ # Spécification OpenAPI
|
|
│ ├── api-client-react/ # Hooks React Query générés
|
|
│ └── db/ # Schéma Drizzle (référence)
|
|
├── deploy/
|
|
│ ├── voix-du-peuple-api.service # Service systemd Gunicorn
|
|
│ └── nginx.conf # Configuration Nginx
|
|
├── .env.example # Variables d'environnement (modèle)
|
|
└── DEPLOIEMENT.md # Ce fichier
|
|
```
|
|
|
|
---
|
|
|
|
## Variables d'environnement complètes
|
|
|
|
| Variable | Obligatoire | Description |
|
|
|----------|-------------|-------------|
|
|
| `DATABASE_URL` | Oui | URL PostgreSQL complète |
|
|
| `OPENAI_API_KEY` | Oui | Clé API OpenAI (sk-...) |
|
|
| `OPENAI_BASE_URL` | Non | Proxy OpenAI compatible (Ollama, Azure, etc.) |
|
|
| `OPENAI_FILTER_MODEL` | Non | Modèle de filtrage (défaut : `gpt-4o-mini`) |
|
|
| `OPENAI_SYNTHESIS_MODEL` | Non | Modèle de synthèse (défaut : `gpt-4o`) |
|
|
| `SESSION_SECRET` | Oui | Clé secrète Flask (min 32 caractères aléatoires) |
|
|
| `PORT` | Non | Port Gunicorn (défaut : 8000) |
|
|
| `FLASK_ENV` | Non | `production` ou `development` |
|
|
|
|
---
|
|
|
|
## Modèles IA utilisés
|
|
|
|
| Fonction | Modèle par défaut | Configurable dans |
|
|
|----------|-------------------|-------------------|
|
|
| Filtrage des idées | `gpt-4o-mini` | `ai_agent.py` ligne 56 |
|
|
| Synthèse collective | `gpt-4o` | `ai_agent.py` ligne 104 |
|
|
|
|
> **Note :** Les modèles `gpt-5-mini` et `gpt-5.2` sont les noms utilisés sur la plateforme Replit. En auto-hébergement avec l'API OpenAI standard, utilisez `gpt-4o-mini` et `gpt-4o`.
|
|
|
|
Pour changer les modèles, éditez `artifacts/flask-api/ai_agent.py` :
|
|
```python
|
|
# Filtrage (ligne ~56)
|
|
model="gpt-4o-mini", # ou tout modèle OpenAI compatible
|
|
|
|
# Synthèse (ligne ~104)
|
|
model="gpt-4o", # ou tout modèle OpenAI compatible
|
|
```
|
|
|
|
---
|
|
|
|
## Mise à jour
|
|
|
|
```bash
|
|
sudo -u voixdupeuple bash -c "
|
|
cd /opt/voix-du-peuple
|
|
git pull origin main
|
|
|
|
# Mise à jour des dépendances Python si nécessaire
|
|
.venv/bin/pip install -r artifacts/flask-api/requirements.txt
|
|
|
|
# Mise à jour des dépendances Node et rebuild frontend
|
|
pnpm install --frozen-lockfile
|
|
cd artifacts/voix-du-peuple
|
|
pnpm exec vite build --config vite.config.selfhost.ts
|
|
"
|
|
|
|
# Redémarrer le service
|
|
sudo systemctl restart voix-du-peuple-api
|
|
sudo systemctl reload nginx
|
|
```
|
|
|
|
---
|
|
|
|
## Logs et supervision
|
|
|
|
```bash
|
|
# Logs API Flask
|
|
sudo journalctl -u voix-du-peuple-api -f
|
|
tail -f /var/log/voix-du-peuple/api-error.log
|
|
tail -f /var/log/voix-du-peuple/api-access.log
|
|
|
|
# Logs Nginx
|
|
sudo tail -f /var/log/nginx/error.log
|
|
sudo tail -f /var/log/nginx/access.log
|
|
|
|
# Statut des services
|
|
sudo systemctl status voix-du-peuple-api
|
|
sudo systemctl status nginx
|
|
sudo systemctl status postgresql-15
|
|
```
|
|
|
|
---
|
|
|
|
## Dépannage fréquent
|
|
|
|
### L'API répond 502 Bad Gateway
|
|
```bash
|
|
# Vérifier que Gunicorn tourne
|
|
sudo systemctl status voix-du-peuple-api
|
|
# Vérifier SELinux
|
|
sudo setsebool -P httpd_can_network_connect 1
|
|
```
|
|
|
|
### Erreur "could not connect to server" (PostgreSQL)
|
|
```bash
|
|
# Vérifier que PostgreSQL tourne
|
|
sudo systemctl status postgresql-15
|
|
# Vérifier l'URL de connexion dans .env
|
|
psql -U voixdupeuple -h 127.0.0.1 -d voixdupeuple
|
|
```
|
|
|
|
### Erreur OpenAI API
|
|
```bash
|
|
# Vérifier la clé dans .env
|
|
grep OPENAI_API_KEY /opt/voix-du-peuple/.env
|
|
# Tester directement
|
|
curl https://api.openai.com/v1/models \
|
|
-H "Authorization: Bearer $OPENAI_API_KEY"
|
|
```
|
|
|
|
### Le frontend affiche une page blanche
|
|
```bash
|
|
# Vérifier que le build existe
|
|
ls /opt/voix-du-peuple/artifacts/voix-du-peuple/dist/public/
|
|
# Vérifier les droits
|
|
sudo chown -R voixdupeuple:voixdupeuple /opt/voix-du-peuple/artifacts/voix-du-peuple/dist/
|
|
```
|