Modification de HomePharma

= 🚀 Déploiement & Maintenance – HomePharma (Flask + Apache) =


== 📝 Mémo Déploiement ==
# **Cloner ou mettre à jour** le code dans `/var/www/HomePharma`
# **Créer / activer l'environnement virtuel**
   <pre>
cd /var/www/HomePharma
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
   </pre>
# **Créer le fichier wsgi.py** (si absent)
   <pre>
from app import app

if __name__ == "__main__":
    app.run()
   </pre>
# **Vérifier les permissions**
   <pre>
sudo chown -R www-data:www-data /var/www/HomePharma
   </pre>
# **Recharger et démarrer le service**
   <pre>
sudo systemctl daemon-reload
sudo systemctl restart homepharma
sudo systemctl status homepharma
   </pre>
# **Tester avec Gunicorn (optionnel)**
   <pre>
cd /var/www/HomePharma
source venv/bin/activate
venv/bin/gunicorn --bind 0.0.0.0:5000 wsgi:app
   </pre>


== 🔗 Schéma Architecture ==
<pre>
   [ Navigateur ] 
         │ (HTTPS)
         ▼
 ┌───────────────────┐
 │      Apache       │
 │  (mod_proxy + SSL)│
 └────────┬──────────┘
          │ (Proxy via UNIX socket)
          ▼
 ┌───────────────────┐
 │     Gunicorn      │
 │  (WSGI serveur)   │
 └────────┬──────────┘
          │ (appel WSGI)
          ▼
 ┌───────────────────┐
 │      Flask        │
 │ (ton application) │
 └───────────────────┘
</pre>


== 🌐 Schéma des Ports & Sockets ==
<pre>
Navigateur (client)
      │
      │  HTTPS :443
      ▼
┌───────────────┐
│    Apache     │  <-- écoute sur :443 (HTTPS)
└──────┬────────┘
       │
       │ ProxyPass (pas de port TCP, utilise un SOCKET UNIX)
       ▼
/var/www/HomePharma/homepharma.sock
       │
       │ (Socket Unix = communication locale, pas ouvert sur réseau)
       ▼
┌───────────────┐
│   Gunicorn    │  <-- ne publie rien sur un port TCP en prod
└──────┬────────┘
       │
       │ WSGI call
       ▼
┌───────────────┐
│    Flask      │
└───────────────┘
</pre>


== 🖥️ Commandes Fréquentes ==
{| class="wikitable" style="text-align:center;"
! Action !! Commande
|-
| ▶️ Démarrer le service || <code>sudo systemctl start homepharma</code>
|-
| 🔄 Redémarrer après mise à jour || <code>sudo systemctl restart homepharma</code>
|-
| ♻️ Recharger sans coupure || <code>sudo systemctl reload homepharma</code>
|-
| ⏹️ Arrêter le service || <code>sudo systemctl stop homepharma</code>
|-
| 📊 Voir l'état || <code>sudo systemctl status homepharma</code>
|-
| 📜 Logs en direct || <code>journalctl -u homepharma -f</code>
|-
| 🧪 Test manuel sur port 5000 || <code>cd /var/www/HomePharma && source venv/bin/activate && venv/bin/gunicorn --bind 0.0.0.0:5000 wsgi:app</code>
|-
| 🔧 Logs Apache || <code>sudo tail -f /var/log/apache2/error.log</code>
|}


== 🔄 Procédure de Mise à Jour ==
# **Aller dans le dossier du projet**
   <pre>
cd /var/www/HomePharma
   </pre>

# **Activer l'environnement virtuel**
   <pre>
source venv/bin/activate
   </pre>

# **Mettre à jour le code (exemple avec Git)**
   <pre>
git pull origin main
   </pre>

# **Mettre à jour les dépendances si besoin**
   <pre>
pip install -r requirements.txt
   </pre>

# **Vérifier les permissions**
   <pre>
sudo chown -R www-data:www-data /var/www/HomePharma
   </pre>

# **Redémarrer le service pour appliquer les changements**
   <pre>
sudo systemctl restart homepharma
   </pre>

# **Vérifier l'état et les logs**
   <pre>
sudo systemctl status homepharma
journalctl -u homepharma -n 20 --no-pager
   </pre>


= Service =

sudo nano /etc/systemd/system/PROJECT_NAME.service

# /etc/systemd/system/homepharma.service
[Unit]
Description=Gunicorn instance to serve HomePharma Flask app
After=network.target
# network.target : attendre que le réseau soit prêt avant de lancer le service

[Service]
User=www-data              # Utilisateur qui exécutera Gunicorn
Group=www-data             # Groupe associé
WorkingDirectory=/var/www/HomePharma  # Dossier du projet

# Chemin vers le venv + bin de Gunicorn
Environment="PATH=/var/www/HomePharma/venv/bin"

# Commande pour lancer Gunicorn avec 3 workers et le socket Unix
ExecStart=/var/www/HomePharma/venv/bin/gunicorn \
          --workers 3 \
          --bind unix:/var/www/HomePharma/homepharma.sock \
          wsgi:app

# Redémarrage automatique en cas de plantage
Restart=always
RestartSec=3                # attendre 3 secondes avant de relancer

# Limites facultatives (éviter qu’un crash flood le serveur)
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target  # Le service démarre automatiquement au boot


== Commandes associées ==

sudo systemctl daemon-reload       # Recharger les fichiers systemd après modification
sudo systemctl enable homepharma   # Activer le démarrage automatique
sudo systemctl start homepharma    # Démarrer le service
sudo systemctl restart homepharma  # Redémarrer après mise à jour
sudo systemctl status homepharma   # Vérifier l'état
journalctl -u homepharma -f        # Voir les logs en temps réel


== Template Générique ==

# /etc/systemd/system/PROJECT_NAME.service
[Unit]
Description=Gunicorn instance to serve PROJECT_NAME Flask app
After=network.target
# network.target : attendre que le réseau soit prêt avant de lancer le service

[Service]
User=www-data               # Utilisateur non-root pour exécuter Gunicorn
Group=www-data              # Groupe associé
WorkingDirectory=/path/to/project  # Dossier racine du projet

# Chemin vers le venv + bin de Gunicorn
Environment="PATH=/path/to/project/venv/bin"

# Commande pour lancer Gunicorn
# --workers : nombre de workers (adaptable selon ressources)
# --bind : socket Unix ou port TCP
ExecStart=/path/to/project/venv/bin/gunicorn \
          --workers 3 \
          --bind unix:/path/to/project/PROJECT_NAME.sock \
          wsgi:app

# Redémarrage automatique en cas de plantage
Restart=always
RestartSec=3

# Limites facultatives
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target

== Commandes génériques ==

sudo systemctl daemon-reload
sudo systemctl enable PROJECT_NAME
sudo systemctl start PROJECT_NAME
sudo systemctl status PROJECT_NAME


journalctl -u PROJECT_NAME -f