Files
formation-manager-itinova/DEPLOIEMENT-TARGZ.md
Manus Sandbox 228c0e0056 Checkpoint: Version finale avec guide et script de déploiement tar.gz
Ajout du workflow tar.gz (méthode habituelle du client) :

1. DEPLOIEMENT-TARGZ.md :
   - Guide complet pour créer l'archive .tar.gz
   - Instructions de transfert via SFTP/SCP
   - Procédure de mise à jour simplifiée

2. deploy-update-targz.sh :
   - Script automatique pour mise à jour via archive
   - Sauvegarde automatique de la BDD
   - Extraction et copie des fichiers
   - Installation dépendances + migrations + build
   - Redémarrage automatique du serveur
   - Usage: ./deploy-update-targz.sh /tmp/archive.tar.gz

Le client peut maintenant utiliser son workflow habituel :
- Télécharger depuis Manus
- Créer archive .tar.gz
- Transférer sur VPS
- Lancer le script de mise à jour

Toutes les corrections de bugs précédentes sont incluses.
2025-12-03 05:30:10 -05:00

2.3 KiB

Guide de déploiement avec archive .tar.gz

Ce guide est adapté à votre workflow habituel avec des archives .tar.gz.


📦 Étape 1 : Créer l'archive .tar.gz

Sur votre machine locale (après téléchargement depuis Manus)

# Aller dans le dossier parent
cd /d/ProjetsGit

# Créer l'archive (exclure les dossiers inutiles)
tar -czf formation-manager-itinova.tar.gz \
  --exclude='node_modules' \
  --exclude='dist' \
  --exclude='build' \
  --exclude='.env' \
  --exclude='backups' \
  formation-manager-itinova/

Sur Windows (si tar n'est pas disponible), utilisez 7-Zip :

  1. Clic droit sur le dossier formation-manager-itinova
  2. 7-Zip → Ajouter à l'archive
  3. Format : tar
  4. Niveau de compression : Ultra
  5. OK

Ensuite compresser le .tar en .gz :

  1. Clic droit sur formation-manager-itinova.tar
  2. 7-Zip → Ajouter à l'archive
  3. Format : gzip
  4. OK

📤 Étape 2 : Transférer l'archive sur le VPS

Avec FileZilla/WinSCP

  1. Se connecter au VPS
  2. Naviguer vers /tmp/ ou /home/votre-utilisateur/
  3. Transférer formation-manager-itinova.tar.gz

Avec SCP (ligne de commande)

scp formation-manager-itinova.tar.gz votre-utilisateur@votre-serveur.com:/tmp/

🚀 Étape 3 : Exécuter le script de mise à jour

Se connecter en SSH

ssh votre-utilisateur@votre-serveur.com

Lancer le script de mise à jour

cd /var/www/formation-manager-itinova
./deploy-update-targz.sh /tmp/formation-manager-itinova.tar.gz

Le script va automatiquement :

  • Sauvegarder la base de données
  • Arrêter le serveur
  • Extraire l'archive
  • Copier les nouveaux fichiers (en préservant .env)
  • Installer les dépendances
  • Appliquer les migrations
  • Recompiler le projet
  • Redémarrer le serveur

🔍 Vérification

# Voir le statut
pm2 status

# Voir les logs
pm2 logs formation-manager --lines 50

📝 Résumé de la procédure

  1. Télécharger les fichiers depuis Manus (Code → Download all files)
  2. Créer l'archive .tar.gz
  3. Transférer l'archive sur le VPS (dans /tmp/)
  4. Se connecter en SSH au VPS
  5. Exécuter ./deploy-update-targz.sh /tmp/formation-manager-itinova.tar.gz
  6. Vérifier avec pm2 status et pm2 logs

C'est tout ! 🚀