DEPLOYMENT.md 5.1 KB

Guide de Déploiement - Assistant AI

🎯 Différences entre les options

Option 1 : Docker Compose (Local)

  • Environnement : Votre machine locale
  • Usage : Développement, test, démonstration
  • Avantages : Simple, rapide, pas de coût
  • Limitations : Pas accessible depuis l'extérieur
  • Prérequis : Docker Desktop

Option 2 : Render.com

  • Environnement : Cloud géré
  • Usage : Production simple, accessible publiquement
  • Avantages : Déploiement automatique, SSL gratuit
  • Limitations : Moins de contrôle, coût mensuel
  • Prérequis : Compte GitHub connecté

Option 3 : VPS Privé

  • Environnement : Serveur distant (AWS, OVH, DigitalOcean)
  • Usage : Production professionnelle, contrôle total
  • Avantages : Performance, sécurité, personnalisation
  • Coût : ~5-50€/mois selon le serveur
  • Prérequis : Option 1 + serveur VPS

🚀 Déploiement Local (Option 1)

1. Installation de Docker Desktop

Windows :

# Via winget (recommandé)
winget install Docker.DockerDesktop

# Ou téléchargement manuel
# https://www.docker.com/products/docker-desktop

Linux :

curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh

2. Configuration des variables d'environnement

# Copier le fichier d'exemple
cp env.example .env

# Éditer avec vos vraies valeurs
notepad .env  # Windows
nano .env     # Linux

Variables obligatoires :

SERPAPI_KEY=your_serpapi_key_here
WIKI_USERNAME=your_wiki_username
WIKI_PASSWORD=your_wiki_password

3. Déploiement automatique

# Script automatique (Linux/Mac)
chmod +x scripts/setup.sh
./scripts/setup.sh

# Ou manuellement
docker-compose up -d

4. Vérification

# Vérifier les services
docker-compose ps

# Voir les logs
docker-compose logs -f

# Tester l'application
curl http://localhost:5000/

🌐 Déploiement VPS (Option 3)

1. Préparation du VPS

Choisir un VPS :

  • OVH : VPS SSD 2 (4€/mois) - Recommandé pour débuter
  • DigitalOcean : Droplet Basic (5$/mois)
  • AWS EC2 : t3.small (~15$/mois)

Spécifications minimales :

  • 2 vCPU
  • 4 GB RAM
  • 20 GB SSD
  • Ubuntu 20.04+

2. Déploiement automatique

# Script de déploiement
chmod +x scripts/deploy-vps.sh
./scripts/deploy-vps.sh <vps-ip> <user> <ssh-key>

# Exemple
./scripts/deploy-vps.sh 192.168.1.100 root ~/.ssh/id_rsa

3. Configuration manuelle

# Connexion au VPS
ssh user@vps-ip

# Installation de Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh

# Installation de Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/download/v2.20.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

# Cloner le projet
git clone <your-repo>
cd assistant-ai

# Configurer les variables
cp env.example .env
nano .env

# Déployer
docker-compose up -d

🧪 Tests et Monitoring

Tests automatiques

# Exécuter les tests de déploiement
python tests/test_deployment.py

Monitoring

# Logs en temps réel
docker-compose logs -f

# Statut des services
docker-compose ps

# Utilisation des ressources
docker stats

Healthchecks

Les services incluent des healthchecks automatiques :

  • Flask App : http://localhost:5000/
  • Ollama : http://localhost:11434/api/tags

🔧 Améliorations recommandées

1. Sécurité

  • Ajouter un reverse proxy (Nginx)
  • Configurer SSL/TLS
  • Implémenter l'authentification
  • Limiter les accès par IP

2. Performance

  • Optimiser les modèles ML
  • Ajouter du caching Redis
  • Implémenter la compression
  • Optimiser les images Docker

3. Monitoring

  • Ajouter Prometheus/Grafana
  • Implémenter des alertes
  • Logs centralisés
  • Métriques d'utilisation

4. CI/CD

  • GitHub Actions
  • Tests automatisés
  • Déploiement automatique
  • Rollback automatique

🆘 Dépannage

Problèmes courants

1. Docker ne démarre pas

# Redémarrer Docker Desktop
# Ou sur Linux
sudo systemctl restart docker

2. Ports déjà utilisés

# Vérifier les ports
netstat -tulpn | grep :5000
# Changer les ports dans docker-compose.yml

3. Variables d'environnement manquantes

# Vérifier le fichier .env
cat .env
# S'assurer que toutes les variables sont définies

4. Modèles Ollama non téléchargés

# Télécharger le modèle
docker exec -it assistant-ai-ollama-1 ollama pull llama3

📊 Comparaison des options

Critère Local Render VPS
Coût Gratuit 7$/mois 5-50€/mois
Complexité Simple Très simple Moyenne
Contrôle Total Limité Total
Performance Moyenne Bonne Excellente
Sécurité Basique Bonne Excellente
Maintenance Manuelle Automatique Manuelle

🎯 Recommandation

Pour débuter : Option 1 (Local) → Option 2 (Render) Pour production : Option 3 (VPS) avec les améliorations de sécurité