{"id":53234,"date":"2026-10-11T16:20:28","date_gmt":"2026-10-11T09:20:28","guid":{"rendered":"\/fr\/tutoriels\/?p=53234"},"modified":"2026-10-09T16:20:38","modified_gmt":"2026-10-09T09:20:38","slug":"comment-deployer-application-node-js","status":"publish","type":"post","link":"\/fr\/tutoriels\/comment-deployer-application-node-js\/","title":{"rendered":"Comment d\u00e9ployer une application Node.js"},"content":{"rendered":"

Pour déployer une application Node.js, vous pouvez suivre une procédure générale adaptée à la plupart des environnements d’hébergement ou choisir une méthode spécifique, selon que vous utilisez un hébergement d’applications web ou un serveur privé virtuel (VPS).<\/p>

Déployer une application Node.js consiste à la transférer de votre ordinateur de développement vers un serveur de production afin de la rendre accessible aux utilisateurs sur Internet.<\/p>

La qualité du déploiement influe directement sur les performances de votre application Node.js lorsqu’elle est soumise à un trafic réel. Un serveur mal configuré peut entraîner des temps de réponse élevés, des interruptions de service imprévues ou des failles de sécurité susceptibles d’exposer des données sensibles.<\/p>

Configurer correctement l’environnement de production de votre application Node.js dès le départ permet d’éviter ces problèmes et de maintenir sa stabilité à mesure que le trafic augmente.<\/p>

Le déploiement d’une application Node.js comprend généralement cinq étapes : la préparation, le choix de l’hébergement, la configuration de l’environnement, le déploiement et la surveillance.<\/p>

Voici en quoi consiste chacune de ces étapes :<\/p>

    \n
  1. Préparez l’application pour la production.<\/strong> Définissez les dépendances dans package.json<\/strong>, configurez les variables d’environnement et ajoutez un script de démarrage.<\/li>\n\n\n\n
  2. Créez un commit et envoyez le code vers un dépôt Git.<\/strong> Téléversez les fichiers dans le dépôt depuis l’interface du navigateur ou exécutez les commandes Git depuis le terminal de votre ordinateur.<\/li>\n\n\n\n
  3. Installez Node.js et un gestionnaire de processus.<\/strong> Installez Node.js sur le serveur, configurez les variables d’environnement et utilisez PM2 pour maintenir l’application en fonctionnement après un plantage ou un redémarrage du serveur.<\/li>\n\n\n\n
  4. Faites transiter le trafic par un proxy inverse.<\/strong> Configurez NGINX pour transmettre les requêtes au processus Node.js sur son port interne et sécurisez les connexions avec un certificat SSL.<\/li>\n\n\n\n
  5. Vérifiez et surveillez le déploiement.<\/strong> Testez l’application dans un navigateur, consultez les journaux PM2 et surveillez les indicateurs de performance pour détecter rapidement les problèmes.<\/li>\n<\/ol>

    Comment déployer une application Node.js<\/strong><\/h2>

    Le déploiement d’une application Node.js<\/a> repose sur une procédure générale, quel que soit l’hébergeur choisi.<\/p>

    Cette procédure consiste à préparer l’application pour la production, à envoyer le code vers un dépôt Git, à configurer le serveur avec un gestionnaire de processus, à mettre en place un proxy inverse avec HTTPS et à tester l’application une fois en ligne.<\/p>

    1. Préparez l’application Node.js pour le déploiement<\/strong><\/h3>

    Pour préparer une application Node.js au déploiement, assurez-vous que le projet contient tous les éléments nécessaires à l’installation des dépendances et au démarrage automatique de l’application sur un serveur de production.<\/p>

    Trois fichiers constituent la base d’un projet Node.js prêt pour le déploiement : app.js<\/strong> (le fichier principal de l’application), package.json<\/strong> (les métadonnées du projet, les dépendances et les scripts) et .gitignore<\/strong> (les fichiers exclus du contrôle de version).<\/p>

    Tous les packages importés par votre application doivent figurer dans le champ dependencies<\/strong> du fichier package.json<\/strong>. Ce fichier indique à npm<\/strong> les packages à télécharger sur le serveur lors de l’installation.<\/p>

    Si un package requis n’y figure pas, l’application plantera en production, même si elle fonctionnait en local grâce à la présence de ce package dans node_modules<\/strong>. Voici un exemple :<\/p>

    {\n  \"name\": \"node-deploy-test\",\n  \"version\": \"1.0.0\",\n  \"description\": \"Sample Node.js app for deployment tutorial\",\n  \"main\": \"app.js\",\n  \"scripts\": {\n    \"start\": \"node app.js\"\n  },\n  \"dependencies\": {\n    \"express\": \"^4.21.0\"\n  }\n}<\/pre>
    La section des scripts définit la manière dont les plateformes d’hébergement Node.js et les gestionnaires de processus démarrent l’application. L’entrée “start”: “node app.js”<\/strong> indique au serveur d’exécuter app.js<\/strong> comme point d’entrée.<\/p>
    Les variables d’environnement Node.js servent à stocker les paramètres de configuration qui diffèrent selon l’environnement, notamment entre le développement et la production. Utilisez-les pour définir les numéros de port, les identifiants de connexion aux bases de données et les clés API, plutôt que d’inscrire ces valeurs directement dans les fichiers source.<\/p>
    Dans le code de l’application, accédez à ces valeurs à l’aide de process.env<\/strong> :<\/p>
    const PORT = process.env.PORT || 3000;<\/pre>
    Cette ligne récupère la valeur de la variable PORT<\/strong> si elle existe. Dans le cas contraire, elle utilise la valeur par défaut 3000<\/strong>. Le même principe s’applique à NODE_ENV<\/strong>, que les plateformes d’hébergement définissent généralement automatiquement sur production.<\/p>
    Le stockage des paramètres de configuration dans des variables d’environnement évite que des données sensibles ne se retrouvent dans votre dépôt. Vous pouvez également modifier ces paramètres pour chaque environnement sans toucher au code.<\/p>
    2. Envoyez le code de l’application vers un dépôt Git<\/strong><\/h3>
    Le contrôle de version est essentiel au déploiement d’une application Node.js, car il permet de conserver un historique fiable et traçable de chaque modification du code source.<\/p>
    Si un déploiement introduit un bug, vous pouvez revenir au dernier commit fonctionnel en quelques secondes, plutôt que de chercher l’origine du problème à l’aveugle.<\/p>
    Git est le système de contrôle de version de référence. GitHub et GitLab comptent parmi les plateformes les plus courantes pour héberger des dépôts Git. Voici comment procéder avec GitHub :<\/p>
      \n
    1. Connectez-vous à GitHub ou créez un compte sur github.com<\/strong> si vous n’en avez pas.<\/li>\n\n\n\n
    2. Dans le tableau de bord, cliquez sur New<\/strong>, puis saisissez un nom de dépôt, par exemple node-deploy-test<\/strong>.<\/li>\n\n\n\n
    3. Définissez la visibilité sur Public<\/strong> si vous prévoyez de connecter le dépôt à une plateforme d’hébergement par la suite.<\/li>\n\n\n\n
    4. Laissez les autres options décochées (sans README<\/strong>, sans .gitignore<\/strong> et sans licence), puis cliquez sur Create repository<\/strong>.<\/li>\n<\/ol>
      \n
      \"Le