Aller au contenu

Installation de la Stack LMELP

Ce guide vous accompagne dans l'installation complète de la stack LMELP (Le Masque et La Plume) sur votre système.

Prérequis

Logiciels requis

Docker et Docker Compose

La stack nécessite Docker et Docker Compose installés sur votre système.

Portainer (optionnel, recommandé)

Portainer fournit une interface web pour gérer vos stacks Docker.

Accéder à Portainer : http://localhost:9000 ou https://localhost:9443

Installation de la Stack LMELP

Étape 1 : Cloner le repository

# Choisir un emplacement pour la stack
cd /path/to/your/installation

# Cloner le repository
git clone https://github.com/castorfou/docker-lmelp.git
cd docker-lmelp

Étape 2 : Configuration des variables d'environnement

Note : La structure des volumes (data/mongodb/, data/backups/, data/audios/, data/logs/) est créée automatiquement lors du clonage du repository grâce aux fichiers .gitkeep.

Copier le template de configuration et le personnaliser :

cp .env.example .env

Éditer le fichier .env avec vos valeurs. Voir le guide de configuration pour les détails.

Configuration minimale requise :

# 1. Au moins une clé LLM (choisir selon votre préférence)
GEMINI_API_KEY=votre_cle_gemini_ici
# OU
OPENAI_API_KEY=votre_cle_openai_ici

# 2. Configuration MongoDB (optionnel, valeurs par défaut fonctionnelles)
MONGO_PORT=27018
MONGO_DATABASE=masque_et_la_plume

# Les autres variables ont des valeurs par défaut dans docker-compose.yml

Note : La stack utilise un réseau Docker bridge. Les services communiquent entre eux via les noms de services Docker (ex: mongo, backoffice-backend). Pas besoin de configurer les URLs de connexion manuellement.

Étape 3 : Initialiser la base de données

Si vous avez un backup existant à restaurer, placez-le dans data/backups/ :

# Exemple : copier un backup existant
cp -r /path/to/backup_2025-10-07_04-38-25 data/backups/

# exemple
cp -r ~/git/lmelp/db/masque_et_la_plume/backup_2025-11-21_19-41-58 ~/git/docker-lmelp/data/backups/

Note : La restauration se fait manuellement après le démarrage de la stack. Voir Restauration depuis un backup.

Étape 4 : Démarrer la stack

Avec Docker Compose (ligne de commande) :

# Démarrer tous les services
docker compose up -d

# Vérifier que les containers sont démarrés
docker compose ps

# Consulter les logs
docker compose logs -f

Avec Portainer :

Voir le guide Portainer pour déployer via l'interface web.

Étape 5 : Vérifier le déploiement

Une fois les services démarrés, vérifier leur état.

Consulter les logs

Les logs des services sont gérés par Docker et accessibles via les commandes Docker Compose :

# Voir les logs de tous les services
docker compose logs

# Suivre les logs en temps réel
docker compose logs -f

# Logs d'un service spécifique
docker compose logs lmelp
docker compose logs backend
docker compose logs frontend
docker compose logs mongo

# Voir les dernières lignes
docker compose logs --tail=100 lmelp

# Logs depuis une date/heure
docker compose logs --since 2024-01-20T15:00:00 lmelp

Note : Le répertoire data/logs/ est monté dans le container LMELP pour d'éventuels logs applicatifs, mais les logs Docker sont stockés séparément par Docker lui-même (dans /var/lib/docker/containers/). La configuration actuelle limite les logs à 10MB par fichier avec rotation sur 3 fichiers maximum.

Vérification automatique avec Health Checks

Docker Compose inclut des health checks automatiques pour tous les services. Pour voir l'état de santé :

# Voir l'état de tous les services
docker compose ps

# Sortie attendue :
# NAME                        STATUS
# lmelp-mongo                 Up (healthy)
# lmelp-frontoffice           Up (healthy)
# lmelp-backoffice-backend    Up (healthy)
# lmelp-backoffice-frontend   Up (healthy)
# lmelp-mongo-backup          Up

Les services devraient afficher "Up (healthy)" une fois complètement opérationnels. Les health checks vérifient automatiquement :

  • MongoDB : Commande ping via mongosh
  • LMELP App : Endpoint Streamlit /_stcore/health
  • Backend API : Endpoint / (retourne infos API)
  • Frontend : Disponibilité du serveur web nginx

Temps de démarrage : Attendez 30-60 secondes après docker compose up pour que tous les services passent à l'état "healthy".

Vérification manuelle (optionnelle)

Si vous souhaitez tester manuellement l'accessibilité :

LMELP Application : 

curl http://localhost:8501
# Ou ouvrir dans le navigateur : http://localhost:8501

Back-Office Frontend : 

curl http://localhost:8080
# Ou ouvrir dans le navigateur : http://localhost:8080

Back-Office API : 

curl http://localhost:8000/
# Devrait retourner : {"message":"Back-office LMELP API","version":"0.1.0"}

MongoDB : 

# Installer mongosh si nécessaire
mongosh --host localhost --port 27018

# Vérifier les bases de données
show dbs
use masque_et_la_plume
show collections

Résolution des problèmes courants

Les containers ne démarrent pas

# Vérifier les logs détaillés
docker compose logs

# Vérifier les erreurs par service
docker compose logs mongo
docker compose logs lmelp
docker compose logs backoffice-backend
docker compose logs backoffice-frontend

Problèmes de permissions

# Réinitialiser les permissions des volumes
sudo chown -R $USER:$USER data/
chmod -R 755 data/

MongoDB n'est pas accessible

Vérifier que tous les services sont sur le même réseau Docker :

# Vérifier les réseaux
docker network ls | grep lmelp

# Inspecter le réseau
docker network inspect lmelp-network

Les services doivent utiliser le nom de service mongo pour se connecter à MongoDB (pas localhost).

Port déjà utilisé

Si un port est déjà utilisé (8501, 8080, 8000), modifier dans .env :

LMELP_PORT=8502
FRONTEND_PORT=8081
BACKEND_PORT=8001

Note : Le port MongoDB par défaut est déjà 27018 pour éviter les conflits avec une instance existante. Une fois la migration terminée, vous pouvez revenir au port standard 27017 en modifiant MONGO_PORT=27017.

Mise à jour de la stack

Mise à jour automatique avec Watchtower

Si Watchtower tourne sur votre système, les images seront automatiquement mises à jour.

Mise à jour manuelle

# Arrêter la stack
docker compose down

# Télécharger les dernières images
docker compose pull

# Redémarrer la stack
docker compose up -d

Désinstallation

Arrêter et supprimer les containers

# Arrêter tous les services
docker compose down

# Supprimer les volumes (⚠️ supprime toutes les données)
docker compose down -v

Supprimer les données sur l'hôte

# ⚠️ ATTENTION : Cette commande supprime toutes les données
rm -rf data/

Supprimer les images Docker

# Lister les images
docker images | grep lmelp

# Supprimer les images
docker rmi ghcr.io/castorfou/lmelp:latest
docker rmi ghcr.io/castorfou/lmelp-frontend:latest
docker rmi ghcr.io/castorfou/lmelp-backend:latest
docker rmi mongo:latest

Prochaines étapes