Déploiement d'une application JavaScript sur VPS : guide étape par étape de A à Z

Introduction : Pourquoi le VPS est le bon choix pour votre application Node.js

Vous avez créé une superbe application en JavaScript (Node.js), vous l'avez testée localement, et elle est maintenant prête à conquérir le monde. Mais comment la faire passer de l'environnement de développement confortable au monde impitoyable de la production ? La réponse est simple : VPS (Virtual Private Server). Contrairement à l'hébergement mutualisé, le VPS vous donne un contrôle total sur le serveur, un accès root et la possibilité de régler finement l'environnement selon les besoins de votre application Node.js.

Dans ce guide étape par étape, nous allons parcourir tout le chemin : de l'achat du serveur et de l'installation de Node.js à la configuration du domaine, du certificat SSL et du gestionnaire de processus PM2. Vous apprendrez à rendre votre site stable, rapide et sécurisé. C'est parti !

Étape 1 : Préparation du VPS et connexion au serveur

La première chose à faire est de louer un VPS. N'importe quel fournisseur populaire convient : DigitalOcean, Linode, Vultr ou leurs équivalents russes. La configuration minimale pour une petite application est de 1 vCPU et 1 Go de RAM (avec Ubuntu 20.04 ou 22.04 LTS).

Après avoir créé le serveur, vous recevrez une adresse IP et un mot de passe root. Connectez-vous via SSH :

ssh root@votre_adresse_IP

Si vous utilisez macOS ou Linux, le client SSH est déjà intégré. Sous Windows, vous pouvez utiliser PowerShell ou Putty.

Mettons immédiatement le système à jour :

apt update && apt upgrade -y

Conseil : créez un utilisateur séparé (pas root) pour le travail quotidien. Cela améliorera la sécurité :

adduser monutilisateurusermod -aG sudo monutilisateursu - monutilisateur

Installation de Node.js et npm

Nous allons installer la dernière version stable de Node.js via NodeSource – c'est la méthode la plus fiable :

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -sudo apt install -y nodejs

Vérifions les versions :

node --version   # v20.x.xnpm --version    # 10.x.x

Parfait ! Nous avons maintenant un environnement pour exécuter du code JavaScript sur le serveur.

Étape 2 : Téléchargement de l'application sur le serveur et installation des dépendances

Il existe plusieurs façons de transférer le code. La plus simple pour les débutants est d'utiliser git clone. Si votre code est hébergé sur GitHub/GitLab, exécutez :

git clone https://github.com/votre_compte/votre_dépôt.git /var/www/monappcd /var/www/monapp

Si le dépôt est privé, configurez des clés SSH ou utilisez un Personal Access Token.

Une autre méthode consiste à télécharger les fichiers via SCP (depuis votre console locale) :

scp -r /chemin/vers/votre/projet monutilisateur@votre_IP:/var/www/monapp

Après le transfert du code, installez les dépendances :

cd /var/www/monappnpm install --production

Le drapeau --production garantit que les dépendances de développement (tests, bundlers, etc.) ne seront pas installées, ce qui économise de l'espace et améliore la sécurité.

Configuration des variables d'environnement

Ne stockez jamais les mots de passe et les clés API dans le code. Créez un fichier .env à la racine du projet :

nano .env

Exemple de contenu :

PORT=3000DB_HOST=localhostDB_USER=monutilisateurDB_PASS=supersecretJWT_SECRET=monjwtsecret123

Assurez-vous que ce fichier est ajouté au .gitignore. Pour lire les variables dans le code, utilisez le package dotenv (il devrait déjà être dans vos dépendances).

Étape 3 : Lancement de l'application avec PM2 et configuration du démarrage automatique

Si vous exécutez node app.js et fermez la session SSH, l'application s'arrêtera. Nous avons besoin d'un gestionnaire de processus qui maintiendra l'application en vie 24h/24 et 7j/7. PM2 est le choix idéal pour Node.js.

Installez PM2 globalement :

sudo npm install -g pm2

Lancez l'application :

pm2 start app.js --name "monapp"

Si votre application utilise le port 3000,