# 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 :** ```bash # Via winget (recommandé) winget install Docker.DockerDesktop # Ou téléchargement manuel # https://www.docker.com/products/docker-desktop ``` **Linux :** ```bash curl -fsSL https://get.docker.com -o get-docker.sh sh get-docker.sh ``` ### 2. Configuration des variables d'environnement ```bash # Copier le fichier d'exemple cp env.example .env # Éditer avec vos vraies valeurs notepad .env # Windows nano .env # Linux ``` **Variables obligatoires :** ```bash SERPAPI_KEY=your_serpapi_key_here WIKI_USERNAME=your_wiki_username WIKI_PASSWORD=your_wiki_password ``` ### 3. Déploiement automatique ```bash # Script automatique (Linux/Mac) chmod +x scripts/setup.sh ./scripts/setup.sh # Ou manuellement docker-compose up -d ``` ### 4. Vérification ```bash # 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 ```bash # Script de déploiement chmod +x scripts/deploy-vps.sh ./scripts/deploy-vps.sh # Exemple ./scripts/deploy-vps.sh 192.168.1.100 root ~/.ssh/id_rsa ``` ### 3. Configuration manuelle ```bash # 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 cd assistant-ai # Configurer les variables cp env.example .env nano .env # Déployer docker-compose up -d ``` ## 🧪 Tests et Monitoring ### Tests automatiques ```bash # Exécuter les tests de déploiement python tests/test_deployment.py ``` ### Monitoring ```bash # 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** ```bash # Redémarrer Docker Desktop # Ou sur Linux sudo systemctl restart docker ``` **2. Ports déjà utilisés** ```bash # Vérifier les ports netstat -tulpn | grep :5000 # Changer les ports dans docker-compose.yml ``` **3. Variables d'environnement manquantes** ```bash # 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** ```bash # 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é