Comment optimiser l'infrastructure de production Node.js : bonnes pratiques en 2025

Meilleures pratiques de déploiement de production Node.js issues de notre infrastructure testée au combat qui gère des millions de requêtes quotidiennement.

Forward Email Équipe
Écrit par
Forward Email ÉquipeVerified
Publié
6/1/25
Il est temps de lire
Moins de 5 minutes

Chez Forward Email, nous avons passé des années à perfectionner la configuration de notre environnement de production Node.js. Ce guide complet présente nos bonnes pratiques éprouvées en matière de déploiement en production Node.js, en mettant l'accent sur l'optimisation des performances, la surveillance et les enseignements tirés de la mise à l'échelle d'applications Node.js pour gérer des millions de transactions quotidiennes.

Notre révolution d'optimisation des performances monocœur à 573 %

Lorsque nous sommes passés des processeurs Intel aux processeurs AMD Ryzen, nous avons obtenu un 573 % d'amélioration des performances dans nos applications Node.js. Il ne s'agissait pas d'une simple optimisation mineure : cela a fondamentalement changé les performances de nos applications Node.js en production et démontre l'importance de l'optimisation des performances sur un seul cœur pour toute application Node.js.

[!TIP] Pour les bonnes pratiques de déploiement de Node.js en production, le choix du matériel est crucial. Nous avons spécifiquement choisi l'hébergement DataPacket pour sa disponibilité sur AMD Ryzen, car les performances monocœur sont cruciales pour les applications Node.js, l'exécution JavaScript étant monothread.

Pourquoi l'optimisation des performances monocœur est importante pour Node.js

Notre migration d'Intel vers AMD Ryzen a abouti à :

  • 573 % d'amélioration des performances dans le traitement des demandes (documenté dans Problème GitHub n° 1519 de notre page d'état)
  • Élimination des retards de traitement à des réponses quasi instantanées (mentionnées dans Problème GitHub n° 298)
  • Meilleur rapport qualité-prix pour les environnements de production Node.js
  • Temps de réponse améliorés sur tous nos points de terminaison d'application

L'augmentation des performances a été si importante que nous considérons désormais les processeurs AMD Ryzen comme essentiels pour tout déploiement de production Node.js sérieux, que vous exécutiez des applications Web, des API, des microservices ou toute autre charge de travail Node.js.

Contenu connexe

Pour plus de détails sur nos choix d'infrastructures, consultez :

Configuration de l'environnement de production Node.js : notre pile technologique

Nos bonnes pratiques de déploiement Node.js en production reposent sur des choix technologiques réfléchis, fruit de nombreuses années d'expérience en production. Voici ce que nous utilisons et pourquoi ces choix s'appliquent à toute application Node.js :

Gestionnaire de paquets : pnpm pour une production efficace

Ce que nous utilisons : pnpm (version épinglée)

Nous avons choisi pnpm plutôt que npm et yarn pour la configuration de notre environnement de production Node.js car :

  • Temps d'installation plus rapides dans les pipelines CI/CD
  • Efficacité de l'espace disque par le biais de liens physiques
  • Résolution de dépendance stricte qui empêche les dépendances fantômes
  • Meilleures performances dans les déploiements de production

[!NOTE] Dans le cadre de nos bonnes pratiques de déploiement en production Node.js, nous attribuons des versions exactes d'outils critiques comme pnpm afin de garantir un comportement cohérent dans tous les environnements et sur les machines des membres de l'équipe.

Détails de mise en œuvre :

Framework Web : Koa pour la production Node.js moderne

Ce que nous utilisons :

Nous avons choisi Koa plutôt qu'Express pour notre infrastructure de production Node.js en raison de sa prise en charge moderne des approches asynchrones et en attente et de sa composition middleware plus claire. Notre fondateur, Nick Baugh, a contribué à Express et Koa, nous offrant ainsi une connaissance approfondie des deux frameworks pour une utilisation en production.

Ces modèles s'appliquent que vous créiez des API REST, des serveurs GraphQL, des applications Web ou des microservices.

Nos exemples de mise en œuvre :

Traitement des tâches en arrière-plan : Bree pour la fiabilité de la production

Ce que nous utilisons : bree planificateur

Nous avons créé et maintenons Bree car les planificateurs de tâches existants ne répondaient pas à nos besoins en matière de prise en charge des threads de travail et de fonctionnalités JavaScript modernes dans les environnements Node.js de production. Ce problème s'applique à toute application Node.js nécessitant un traitement en arrière-plan, des tâches planifiées ou des threads de travail.

Nos exemples de mise en œuvre :

Gestion des erreurs : @hapi/boom pour la fiabilité de la production

Ce que nous utilisons : @hapi/boom

Nous utilisons @hapi/boom pour les réponses d'erreur structurées dans nos applications de production Node.js. Ce modèle fonctionne pour toute application Node.js nécessitant une gestion cohérente des erreurs.

Nos exemples de mise en œuvre :

Comment surveiller les applications Node.js en production

Notre approche de la surveillance des applications Node.js en production a évolué au fil des années d'exploitation d'applications à grande échelle. Nous mettons en œuvre une surveillance à plusieurs niveaux pour garantir la fiabilité et les performances de tout type d'application Node.js.

Surveillance de la production Node.js au niveau du système

Notre implémentation principale : helpers/monitor-server.js

Ce que nous utilisons : node-os-utils

Nos seuils de surveillance de la production (à partir de notre code de production réel) :

  • Limite de taille de tas de 2 Go avec des alertes automatiques
  • 25 % d'utilisation de la mémoire seuil d'alerte
  • 80 % d'utilisation du processeur seuil d'alerte
  • 75 % d'utilisation du disque seuil d'alerte

[!AVERTISSEMENT] Ces seuils fonctionnent avec notre configuration matérielle spécifique. Lors de la mise en œuvre de la surveillance de production Node.js, consultez notre implémentation monitor-server.js pour comprendre la logique exacte et adapter les valeurs à votre configuration.

Surveillance au niveau des applications pour la production Node.js

Notre classification des erreurs : helpers/is-code-bug.js

Cet assistant fait la distinction entre :

  • Bogues de code réels qui nécessitent une attention immédiate
  • Erreurs d'utilisateur qui sont des comportements attendus
  • Pannes de services externes que nous ne pouvons pas contrôler

Ce modèle s'applique à toute application Node.js : applications Web, API, microservices ou services d'arrière-plan.

Notre implémentation de journalisation : helpers/logger.js

Nous mettons en œuvre une rédaction complète des champs pour protéger les informations sensibles tout en conservant des capacités de débogage utiles dans notre environnement de production Node.js.

Surveillance spécifique à l'application

Nos implémentations de serveur :

Surveillance des files d'attente : Nous implémentons des limites de file d'attente de 5 Go et des délais d'expiration de 180 secondes pour le traitement des requêtes afin d'éviter l'épuisement des ressources. Ces modèles s'appliquent à toute application Node.js avec files d'attente ou traitement en arrière-plan.

Surveillance de la production Node.js avec les contrôles de santé PM2

Forts de nombreuses années d'expérience en production, nous avons optimisé la configuration de notre environnement de production Node.js avec PM2. Nos contrôles de santé PM2 sont essentiels pour garantir la fiabilité de toute application Node.js.

Notre système de contrôle de santé PM2

Notre implémentation principale : jobs/check-pm2.js

Notre surveillance de production Node.js avec contrôles de santé PM2 comprend :

  • Circule toutes les 20 minutes via la planification cron
  • Nécessite un temps de disponibilité minimum de 15 minutes avant de considérer un processus comme sain
  • Valide l'état du processus et l'utilisation de la mémoire
  • Redémarre automatiquement les processus ayant échoué
  • Empêche les boucles de redémarrage grâce à un contrôle de santé intelligent

[!CRITIQUE] Conformément aux bonnes pratiques de déploiement en production de Node.js, nous exigeons un temps de disponibilité d'au moins 15 minutes avant de considérer un processus comme sain, afin d'éviter les boucles de redémarrage. Cela permet d'éviter les pannes en cascade lorsque les processus rencontrent des problèmes de mémoire ou d'autres problèmes.

Notre configuration de production PM2

Notre configuration d'écosystème : Étudiez nos fichiers de démarrage de serveur pour la configuration de l'environnement de production Node.js :

Ces modèles s'appliquent que vous exécutiez des applications Express, des serveurs Koa, des API GraphQL ou toute autre application Node.js.

Déploiement automatisé de PM2

Déploiement PM2 : ansible/playbooks/node.yml

Nous automatisons l'ensemble de notre configuration PM2 via Ansible pour garantir des déploiements de production Node.js cohérents sur tous nos serveurs.

Système de gestion et de classification des erreurs de production

L’une de nos meilleures pratiques de déploiement de production Node.js les plus précieuses est la classification intelligente des erreurs qui s’applique à n’importe quelle application Node.js :

Notre implémentation isCodeBug pour la production

Source: helpers/is-code-bug.js

Cet assistant fournit une classification intelligente des erreurs pour les applications Node.js en production pour :

  • Donner la priorité aux bugs réels sur les erreurs des utilisateurs
  • Améliorer notre réponse aux incidents en se concentrant sur les vrais problèmes
  • Réduire la fatigue liée aux alertes à partir des erreurs attendues de l'utilisateur
  • Mieux comprendre problèmes liés à l'application et aux utilisateurs

Ce modèle fonctionne pour n'importe quelle application Node.js, que vous créiez des sites de commerce électronique, des plateformes SaaS, des API ou des microservices.

Intégration avec notre journalisation de production

Notre intégration de logger : helpers/logger.js

Notre enregistreur utilise isCodeBug pour déterminer les niveaux d'alerte et la rédaction des champs, en veillant à ce que nous soyons informés des problèmes réels tout en filtrant le bruit dans notre environnement de production Node.js.

Contenu connexe

En savoir plus sur nos modèles de gestion des erreurs :

Débogage avancé des performances avec v8-profiler-next et cpupro

Nous utilisons des outils de profilage avancés pour analyser les snapshots de tas et déboguer les problèmes de mémoire insuffisante (OOM), les goulots d'étranglement des performances et les problèmes de mémoire Node.js dans notre environnement de production. Ces outils sont essentiels pour toute application Node.js confrontée à des fuites de mémoire ou des problèmes de performances.

Notre approche de profilage pour la production Node.js

Outils que nous recommandons :

  • v8-profiler-next - Pour générer des instantanés de tas et des profils de processeur
  • cpupro - Pour analyser les profils CPU et les instantanés de tas

[!TIP] Nous utilisons conjointement v8-profiler-next et cpupro pour créer un workflow complet de débogage des performances pour nos applications Node.js. Cette combinaison nous aide à identifier les fuites de mémoire, les goulots d'étranglement et à optimiser notre code de production.

Comment nous mettons en œuvre l'analyse des instantanés de tas

Notre mise en œuvre du suivi : helpers/monitor-server.js

Notre surveillance de la production inclut la génération automatique d'instantanés de tas lorsque les seuils de mémoire sont dépassés. Cela nous permet de déboguer les problèmes de mémoire insuffisante avant qu'ils ne provoquent des plantages d'application.

Principaux modèles de mise en œuvre :

  • Instantanés automatiques lorsque la taille du tas dépasse le seuil de 2 Go
  • Profilage basé sur le signal pour l'analyse à la demande en production
  • Politiques de conservation pour gérer le stockage des instantanés
  • Intégration avec nos travaux de nettoyage pour la maintenance automatisée

Flux de travail de débogage des performances

Étudiez notre mise en œuvre réelle :

Pour l'analyse des instantanés de tas :

  1. Installer v8-profiler-next pour la génération d'instantanés
  2. Utiliser cpupro pour analyser les instantanés générés
  3. Mettre en œuvre des seuils de surveillance similaire à notre monitor-server.js
  4. Configurer le nettoyage automatisé pour gérer le stockage des instantanés
  5. Créer des gestionnaires de signaux pour le profilage à la demande en production

Pour le profilage du processeur :

  1. Générer des profils CPU pendant les périodes de forte charge
  2. Analyser avec cpupro pour identifier les goulots d'étranglement
  3. Se concentrer sur les chemins chauds et opportunités d'optimisation
  4. Surveiller avant/après améliorations des performances

[!AVERTISSEMENT] La génération d'instantanés de tas et de profils CPU peut impacter les performances. Nous recommandons de mettre en œuvre une limitation et d'activer le profilage uniquement lors de l'analyse de problèmes spécifiques ou pendant les périodes de maintenance.

Intégration avec notre surveillance de production

Nos outils de profilage s'intègrent à notre stratégie de surveillance plus large :

  • Déclenchement automatique basé sur les seuils de mémoire/CPU
  • Intégration des alertes lorsque des problèmes de performances sont détectés
  • Analyse historique pour suivre les tendances de performance au fil du temps
  • Corrélation avec les métriques d'application pour un débogage complet

Cette approche nous a aidé à identifier et à résoudre les fuites de mémoire, à optimiser les chemins de code à chaud et à maintenir des performances stables dans notre environnement de production Node.js.

Sécurité de l'infrastructure de production Node.js

Nous mettons en œuvre une sécurité complète pour notre infrastructure de production Node.js grâce à l'automatisation Ansible. Ces pratiques s'appliquent à toutes les applications Node.js :

Sécurité au niveau du système pour la production Node.js

Notre implémentation Ansible : ansible/playbooks/security.yml

Nos principales mesures de sécurité pour les environnements de production Node.js :

  • Échange désactivé pour empêcher l'écriture de données sensibles sur le disque
  • Vidages de mémoire désactivés pour éviter les vidages de mémoire contenant des informations sensibles
  • Stockage USB bloqué pour empêcher l'accès non autorisé aux données
  • Réglage des paramètres du noyau pour la sécurité et la performance

[!AVERTISSEMENT] Lors de la mise en œuvre des bonnes pratiques de déploiement en production de Node.js, la désactivation du swap peut entraîner des arrêts prématurés dus à un manque de mémoire si votre application dépasse la RAM disponible. Nous surveillons attentivement l'utilisation de la mémoire et dimensionnons nos serveurs en conséquence.

Sécurité des applications pour les applications Node.js

Notre rédaction de champ de journal : helpers/logger.js

Nous supprimons les champs sensibles des journaux, notamment les mots de passe, les jetons, les clés API et les informations personnelles. Cela protège la confidentialité des utilisateurs tout en maintenant les capacités de débogage dans tout environnement de production Node.js.

Automatisation de la sécurité des infrastructures

Notre configuration Ansible complète pour la production Node.js :

Notre contenu de sécurité

En savoir plus sur notre approche en matière de sécurité :

Architecture de base de données pour les applications Node.js

Nous utilisons une approche de base de données hybride optimisée pour nos applications Node.js. Ces modèles peuvent être adaptés à n'importe quelle application Node.js :

Implémentation de SQLite pour la production Node.js

Ce que nous utilisons :

Notre configuration : ansible/playbooks/sqlite.yml

Nous utilisons SQLite pour les données spécifiques à l'utilisateur dans nos applications Node.js car il fournit :

  • Isolation des données par utilisateur/locataire
  • Meilleures performances pour les requêtes mono-utilisateur
  • Sauvegarde simplifiée et la migration
  • Complexité réduite par rapport aux bases de données partagées

Ce modèle fonctionne bien pour les applications SaaS, les systèmes multi-locataires ou toute application Node.js nécessitant une isolation des données.

Implémentation de MongoDB pour la production Node.js

Ce que nous utilisons :

Notre mise en œuvre de configuration : helpers/setup-mongoose.js

Notre configuration : config/mongoose.js

Nous utilisons MongoDB pour les données d'application dans notre environnement de production Node.js car il fournit :

  • Schéma flexible pour faire évoluer les structures de données
  • Meilleures performances pour les requêtes complexes
  • Mise à l'échelle horizontale capacités
  • Langage de requête riche

[!NOTE] Notre approche hybride est optimisée pour notre cas d'utilisation spécifique. Étudiez nos modèles d'utilisation de base de données réels dans le code source pour comprendre si cette approche répond aux besoins de votre application Node.js.

Traitement des tâches d'arrière-plan de production Node.js

Nous avons construit notre architecture de tâches d'arrière-plan autour de Bree pour un déploiement fiable de Node.js en production. Ceci s'applique à toute application Node.js nécessitant un traitement en arrière-plan :

Notre configuration du serveur Bree pour la production

Notre principale implémentation : bree.js

Notre déploiement Ansible : ansible/playbooks/bree.yml

Exemples de travaux de production

Surveillance de la santé : jobs/check-pm2.js

Automatisation du nettoyage : jobs/cleanup-tmp.js

Tous nos métiers : Parcourez notre répertoire complet d'emplois

Ces modèles s'appliquent à toute application Node.js qui a besoin de :

  • Tâches planifiées (traitement des données, rapports, nettoyage)
  • Traitement en arrière-plan (redimensionnement d'image, envoi d'e-mail, importations de données)
  • Surveillance et maintenance de la santé
  • Utilisation des threads de travail pour les tâches gourmandes en ressources CPU

Nos modèles de planification de tâches pour la production Node.js

Étudiez nos modèles réels de planification des tâches dans notre répertoire d'emplois pour comprendre :

  • Comment implémenter la planification de type cron dans la production Node.js
  • Notre logique de gestion des erreurs et de nouvelle tentative
  • Comment nous utilisons les threads de travail pour les tâches gourmandes en ressources CPU

Maintenance automatisée pour les applications Node.js de production

Nous mettons en œuvre une maintenance proactive pour prévenir les problèmes courants de production de Node.js. Ces modèles s'appliquent à toutes les applications Node.js :

Notre mise en œuvre du nettoyage

Source: jobs/cleanup-tmp.js

Notre maintenance automatisée pour les applications de production Node.js cible :

  • Fichiers temporaires datant de plus de 24 heures
  • Fichiers journaux au-delà des limites de conservation
  • Fichiers cache et données temporaires
  • Fichiers téléchargés qui ne sont plus nécessaires
  • Instantanés de tas du débogage des performances

Ces modèles s'appliquent à toute application Node.js qui génère des fichiers temporaires, des journaux ou des données mises en cache.

Gestion de l'espace disque pour la production Node.js

Nos seuils de surveillance : helpers/monitor-server.js

  • Limites de file d'attente pour le traitement en arrière-plan
  • 75 % d'utilisation du disque seuil d'alerte
  • Nettoyage automatique lorsque les seuils sont dépassés

Automatisation de la maintenance des infrastructures

Notre automatisation Ansible pour la production Node.js :

Guide d'implémentation du déploiement en production Node.js

Étudiez notre code actuel pour les meilleures pratiques de production

Commencez avec ces fichiers clés pour la configuration de l'environnement de production Node.js :

  1. Configuration: config/index.js
  2. Surveillance: helpers/monitor-server.js
  3. Gestion des erreurs : helpers/is-code-bug.js
  4. Enregistrement: helpers/logger.js
  5. Santé du processus : jobs/check-pm2.js

Apprenez de nos articles de blog

Nos guides d'implémentation technique pour la production Node.js :

Automatisation de l'infrastructure pour la production Node.js

Nos playbooks Ansible à étudier pour le déploiement de production Node.js :

Nos études de cas

Nos implémentations d'entreprise :

Conclusion : Bonnes pratiques de déploiement en production de Node.js

Notre infrastructure de production Node.js démontre que les applications Node.js peuvent atteindre une fiabilité de niveau entreprise grâce à :

  • Des choix matériels éprouvés (AMD Ryzen pour une optimisation des performances monocœur de 573 %)
  • Surveillance de la production Node.js testée sur le terrain avec des seuils spécifiques et des réponses automatisées
  • Classification intelligente des erreurs pour améliorer la réponse aux incidents dans les environnements de production
  • Débogage avancé des performances avec v8-profiler-next et cpupro pour la prévention des OOM
  • Renforcement complet de la sécurité grâce à l'automatisation Ansible
  • Architecture de base de données hybride optimisé pour les besoins des applications
  • Maintenance automatisée pour éviter les problèmes courants de production de Node.js

À retenir : Étudiez nos fichiers d'implémentation et nos articles de blog plutôt que de suivre les bonnes pratiques génériques. Notre base de code fournit des modèles concrets pour le déploiement en production de Node.js, adaptables à toute application Node.js : applications web, API, microservices ou services d'arrière-plan.

Liste complète des ressources pour la production Node.js

Nos principaux fichiers d'implémentation

Nos implémentations de serveur

Notre automatisation des infrastructures

Nos articles de blog technique

Nos études de cas d'entreprise