changement du workflow et ajout d'un readme pour le workflow

Author: Andros78

.github/workflows/nouvelle-version.yml

@@ -24,27 +24,30 @@ jobs:
 
             cd /data/supercoop
 
-            # Nettoyage
-            rm -f /tmp/webapp-backend.sock
+            # Sauvegarder le .env existant
+            if [ -f webapp-backend/.env ]; then
+              cp webapp-backend/.env /tmp/webapp-backend.env
+            fi
 
-            # Cloner la nouvelle version
-            git clone "https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git"
+            # Supprimer l'ancien dossier
+            rm -rf webapp-backend
+
+            # Cloner la nouvelle version dans le dossier webapp-backend
+            git clone "https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git" webapp-backend
             cd webapp-backend
             git checkout ${{ github.ref }}
 
-            # Copier le .env
-            cp /data/supercoop/webapp-backend/.env .env
+            # Restaurer le .env
+            if [ -f /tmp/webapp-backend.env ]; then
+              mv /tmp/webapp-backend.env .env
+            fi
 
-            # Créer l'env et installer les dépendances
-            virtualenv ../env
-            ../env/bin/pip install -r requirements.txt
+            # Créer l'environnement virtuel et installer les dépendances
+            virtualenv env
+            env/bin/pip install -r requirements.txt
 
             # Appliquer les migrations
-            ../env/bin/flask db upgrade
-
-            # Créer le dossier de logs si manquant
-            mkdir -p /data/supercoop/webapp-backend/logs
-            chown webapp-backend:webapp-backend /data/supercoop/webapp-backend/logs
+            env/bin/flask db upgrade
 
             # Relancer Supervisor
             sudo supervisorctl reread
@@ -56,14 +59,14 @@ jobs:
       - name: Notify IT
         uses: hilarion5/send-mail@v1
         with:
-          smtp-server: ${{vars.SMTP_HOST}}
-          smtp-port: ${{vars.SMTP_PORT}}
+          smtp-server: ${{ vars.SMTP_HOST }}
+          smtp-port: ${{ vars.SMTP_PORT }}
           smtp-secure: false
-          username: ${{vars.MAIL_ACCOUNT}}
-          password: ${{secrets.MAIL_PASSWORD}}
-          from-email: ${{vars.MAIL_FROM_ADDRESS}}
-          to-email: ${{vars.MAIL_TO_ADDRESS}}
+          username: ${{ vars.MAIL_ACCOUNT }}
+          password: ${{ secrets.MAIL_PASSWORD }}
+          from-email: ${{ vars.MAIL_FROM_ADDRESS }}
+          to-email: ${{ vars.MAIL_TO_ADDRESS }}
           subject: Version ${{ github.ref_name }} de la webapp backend mobile
           body: Tout est dans le titre
 
-      - run: echo "🎉 The job was automatically triggered by a ${{ github.event_name }} event."
+      - run: echo "🎉 The job was automatiquement déclenché par un événement ${{ github.event_name }}."

.github/workflows/readme.md

@@ -0,0 +1,68 @@
+# Déploiement de la Webapp Backend
+
+Ce guide décrit les étapes automatiques réalisées lors d'un déploiement via GitHub Actions sur le serveur `/data/supercoop`.
+
+---
+
+## 1. Déclenchement
+
+- Le workflow se déclenche automatiquement lors de la **publication d'une release** sur GitHub.
+- Le nom de la version et l'auteur sont affichés dans le run-name.
+
+---
+
+## 2. Étapes du déploiement
+
+1. **Arrêt du process Supervisor**  
+   - Le processus `webapp-backend` est arrêté avec :  
+     ```bash
+     sudo supervisorctl stop webapp-backend
+     ```
+
+2. **Sauvegarde du `.env` existant**  
+   - Si le fichier `.env` existe, il est temporairement déplacé dans `/tmp/webapp-backend.env`.
+
+3. **Suppression de l'ancien dossier**  
+   - L'ancien dossier `webapp-backend` est supprimé pour laisser place à la nouvelle version.
+
+4. **Clonage du nouveau code**  
+   - Le repo est cloné avec le token GitHub dans `/data/supercoop/webapp-backend`.
+   - La branche/release correspondante est checkoutée.
+
+5. **Restauration du `.env`**  
+   - Le fichier `.env` sauvegardé est replacé dans le nouveau dossier cloné.
+
+6. **Création de l'environnement virtuel et installation des dépendances**  
+   - Un virtualenv nommé `env` est créé dans `webapp-backend`.
+   - Les dépendances sont installées via :
+     ```bash
+     env/bin/pip install -r requirements.txt
+     ```
+
+7. **Application des migrations**  
+   - Les migrations de la base de données sont appliquées avec Flask :
+     ```bash
+     env/bin/flask db upgrade
+     ```
+
+8. **Redémarrage du process Supervisor**  
+   - Le service Supervisor est rechargé et le backend est démarré :
+     ```bash
+     sudo supervisorctl reread
+     sudo supervisorctl update
+     sudo supervisorctl start webapp-backend
+     ```
+
+---
+
+## 3. Notification
+
+- Une notification email est envoyée automatiquement pour informer l'équipe IT du déploiement réussi.
+
+---
+
+## 4. Notes importantes
+
+- Le `.env` doit toujours rester en dehors du repo Git pour ne pas exposer les secrets.
+- Le virtualenv est nommé `env` et se trouve dans le dossier cloné.
+- Les logs de l’application sont stockés dans `webapp-backend/logs`.