Déployer une application Node.js

Le déploiement d’une application Node.js sur votre instance onesubnet.com se résume à trois étapes : récupérer le code, configurer les variables d’environnement, et lancer le processus.

Cause / Le problème

Une application qui démarre puis crash, ou qui ne trouve pas ses variables de configuration, souffre généralement d’un fichier .env manquant, d’un script de démarrage incorrect, ou de dépendances non installées.

Solution

1. Connectez-vous à votre instance via SSH ou le terminal du panel.
2. Récupérez le code depuis Git :

   git clone https://github.com/votre-org/votre-app.git
   cd votre-app

   Ou uploadez vos fichiers via SFTP dans le dossier de l’application.
3. Installez les dépendances :

   npm install        # ou: bun install / yarn install

4. Créez le fichier .env à la racine du projet avec vos variables d’environnement :

   NODE_ENV=production
   PORT=3000
   DATABASE_URL=postgresql://utilisateur:motdepasse@db-paris.onesubnet.com:5432/mabase
   JWT_SECRET=votre_secret_long_et_aleatoire

   Ne committez jamais ce fichier en Git (ajoutez .env au .gitignore).
5. Lancez l’application directement pour vérifier qu’elle démarre :

   npm start
   # ou : node index.js / node dist/main.js

6. Mettez l’application en production avec PM2 pour qu’elle tourne en arrière-plan et redémarre automatiquement :

   npm install -g pm2
   pm2 start npm --name "mon-app" -- start
   pm2 save
   pm2 startup          # active le démarrage au boot du système

7. Pour les mises à jour ultérieures via Git :

   git pull origin main
   npm install
   pm2 restart mon-app

8. Consultez les logs en cas de crash :

   pm2 logs mon-app --lines 50

Pour une config propre, créez un fichier ecosystem.config.js PM2 qui définit env et env_production, puis lancez avec pm2 start ecosystem.config.js --env production.