Come ottimizzare l'infrastruttura di produzione di Node.js: best practice per 2025

Le migliori pratiche di distribuzione in produzione di Node.js, derivanti dalla nostra infrastruttura collaudata che gestisce milioni di richieste ogni giorno.

Forward Email Squadra
Scritto da
Forward Email SquadraVerified
Pubblicato
6/1/25
Tempo di leggere
Meno di 5 minuti

Noi di Forward Email abbiamo dedicato anni a perfezionare la configurazione del nostro ambiente di produzione Node.js. Questa guida completa condivide le nostre best practice di distribuzione in produzione Node.js, collaudate sul campo, concentrandosi sull'ottimizzazione delle prestazioni, sul monitoraggio e sulle lezioni apprese scalando le applicazioni Node.js per gestire milioni di transazioni giornaliere.

La nostra rivoluzione nell'ottimizzazione delle prestazioni single core del 573%

Quando siamo passati dai processori Intel a quelli AMD Ryzen, abbiamo ottenuto un Miglioramento delle prestazioni del 573% Nelle nostre applicazioni Node.js. Non si è trattato solo di un'ottimizzazione minore: ha cambiato radicalmente le prestazioni delle nostre applicazioni Node.js in produzione e dimostra l'importanza dell'ottimizzazione delle prestazioni a livello di singolo core per qualsiasi applicazione Node.js.

[!TIP] Per le migliori pratiche di distribuzione di Node.js in produzione, la scelta dell'hardware è fondamentale. Abbiamo scelto specificamente l'hosting DataPacket per la loro disponibilità su AMD Ryzen perché le prestazioni single-core sono cruciali per le applicazioni Node.js, dato che l'esecuzione di JavaScript è single-thread.

Perché l'ottimizzazione delle prestazioni del singolo core è importante per Node.js

La nostra migrazione da Intel ad AMD Ryzen ha prodotto:

  • Miglioramento delle prestazioni del 573% nell'elaborazione delle richieste (documentato in il problema GitHub n. 1519 della nostra pagina di stato)
  • Ritardi di elaborazione eliminati a risposte quasi istantanee (menzionate in Problema GitHub n. 298)
  • Miglior rapporto prezzo/prestazioni per ambienti di produzione Node.js
  • Tempi di risposta migliorati su tutti i nostri endpoint applicativi

L'incremento delle prestazioni è stato così significativo che ora consideriamo i processori AMD Ryzen essenziali per qualsiasi distribuzione di produzione Node.js seria, che si tratti di applicazioni web, API, microservizi o qualsiasi altro carico di lavoro Node.js.

Contenuti correlati

Per maggiori dettagli sulle nostre scelte infrastrutturali, consulta:

Configurazione dell'ambiente di produzione Node.js: il nostro stack tecnologico

Le nostre best practice per l'implementazione in produzione di Node.js includono scelte tecnologiche ponderate basate su anni di esperienza in produzione. Ecco cosa utilizziamo e perché queste scelte si applicano a qualsiasi applicazione Node.js:

Gestore pacchetti: pnpm per l'efficienza della produzione

Cosa utilizziamo: pnpm (versione bloccata)

Abbiamo scelto pnpm invece di npm e yarn per la configurazione del nostro ambiente di produzione Node.js perché:

  • Tempi di installazione più rapidi nelle pipeline CI/CD
  • Efficienza dello spazio su disco attraverso il collegamento rigido
  • Risoluzione rigorosa delle dipendenze che previene le dipendenze fantasma
  • Prestazioni migliori nelle distribuzioni di produzione

[!NOTE] Come parte delle nostre best practice per l'implementazione in produzione di Node.js, fissiamo versioni esatte di strumenti critici come pnpm per garantire un comportamento coerente in tutti gli ambienti e sulle macchine dei membri del team.

Dettagli di implementazione:

Framework Web: Koa per la moderna produzione Node.js

Cosa utilizziamo:

Abbiamo scelto Koa invece di Express per la nostra infrastruttura di produzione Node.js per il suo moderno supporto async/await e per la sua struttura middleware più pulita. Il nostro fondatore Nick Baugh ha contribuito sia a Express che a Koa, offrendoci una conoscenza approfondita di entrambi i framework per l'uso in produzione.

Questi modelli sono validi indipendentemente dal fatto che si sviluppino API REST, server GraphQL, applicazioni web o microservizi.

I nostri esempi di implementazione:

Elaborazione dei lavori in background: Bree per l'affidabilità della produzione

Cosa utilizziamo: bree pianificatore

Abbiamo creato e gestiamo Bree perché gli scheduler di lavoro esistenti non soddisfacevano le nostre esigenze di supporto per i thread di lavoro e di funzionalità JavaScript moderne negli ambienti di produzione Node.js. Questo vale per qualsiasi applicazione Node.js che necessiti di elaborazione in background, attività pianificate o thread di lavoro.

I nostri esempi di implementazione:

Gestione degli errori: @hapi/boom per l'affidabilità della produzione

Cosa utilizziamo: @hapi/boom

Utilizziamo @hapi/boom per risposte di errore strutturate in tutte le nostre applicazioni di produzione Node.js. Questo modello funziona per qualsiasi applicazione Node.js che richieda una gestione coerente degli errori.

I nostri esempi di implementazione:

Come monitorare le applicazioni Node.js in produzione

Il nostro approccio al monitoraggio delle applicazioni Node.js in produzione si è evoluto nel corso degli anni di utilizzo di applicazioni su larga scala. Implementiamo il monitoraggio a più livelli per garantire affidabilità e prestazioni per qualsiasi tipo di applicazione Node.js.

Monitoraggio della produzione Node.js a livello di sistema

La nostra implementazione principale: helpers/monitor-server.js

Cosa utilizziamo: node-os-utils

Le nostre soglie di monitoraggio della produzione (dal nostro attuale codice di produzione):

  • Limite di dimensione heap di 2 GB con avvisi automatici
  • Utilizzo della memoria al 25% soglia di allerta
  • Utilizzo della CPU all'80% soglia di allerta
  • Utilizzo del disco al 75% soglia di allerta

[!WARNING] Queste soglie sono valide per la nostra specifica configurazione hardware. Quando implementi il monitoraggio della produzione Node.js, consulta la nostra implementazione di monitor-server.js per comprenderne la logica esatta e adattare i valori alla tua configurazione.

Monitoraggio a livello di applicazione per la produzione Node.js

La nostra classificazione degli errori: helpers/is-code-bug.js

Questo helper distingue tra:

  • Bug del codice effettivi che richiedono attenzione immediata
  • Errori dell'utente che sono comportamenti attesi
  • Errori di servizio esterni che non possiamo controllare

Questo schema si applica a qualsiasi applicazione Node.js: app web, API, microservizi o servizi in background.

La nostra implementazione di registrazione: helpers/logger.js

Implementiamo una redazione completa dei campi per proteggere le informazioni sensibili, mantenendo al contempo utili funzionalità di debug nel nostro ambiente di produzione Node.js.

Monitoraggio specifico dell'applicazione

Le nostre implementazioni server:

Monitoraggio delle code: Implementiamo limiti di coda di 5 GB e timeout di 180 secondi per l'elaborazione delle richieste per evitare l'esaurimento delle risorse. Questi modelli si applicano a qualsiasi applicazione Node.js con code o elaborazione in background.

Monitoraggio della produzione di Node.js con controlli di integrità PM2

Abbiamo perfezionato la configurazione del nostro ambiente di produzione Node.js con PM2 nel corso di anni di esperienza in produzione. I nostri controlli di integrità PM2 sono essenziali per mantenere l'affidabilità di qualsiasi applicazione Node.js.

Il nostro sistema di controllo sanitario PM2

La nostra implementazione principale: jobs/check-pm2.js

Il nostro monitoraggio della produzione Node.js con controlli di integrità PM2 include:

  • Parte ogni 20 minuti tramite la pianificazione cron
  • Richiede almeno 15 minuti di attività prima di considerare un processo sano
  • Convalida lo stato del processo e l'utilizzo della memoria
  • Riavvia automaticamente i processi non riusciti
  • Previene i cicli di riavvio attraverso un controllo sanitario intelligente

[!CAUTION] For Node.js production deployment best practices, we require 15+ minutes uptime before considering a process healthy to avoid restart loops. This prevents cascading failures when processes are struggling with memory or other issues.

La nostra configurazione di produzione PM2

La configurazione del nostro ecosistema: Studia i nostri file di avvio del server per la configurazione dell'ambiente di produzione Node.js:

Questi modelli sono validi indipendentemente dal fatto che si eseguano app Express, server Koa, API GraphQL o qualsiasi altra applicazione Node.js.

Distribuzione automatica PM2

Distribuzione PM2: ansible/playbooks/node.yml

Automatizziamo l'intera configurazione PM2 tramite Ansible per garantire distribuzioni di produzione Node.js coerenti su tutti i nostri server.

Sistema di gestione e classificazione degli errori di produzione

Una delle nostre best practice più preziose per l'implementazione in produzione di Node.js è la classificazione intelligente degli errori, applicabile a qualsiasi applicazione Node.js:

La nostra implementazione isCodeBug per la produzione

Fonte: helpers/is-code-bug.js

Questo helper fornisce una classificazione intelligente degli errori per le applicazioni Node.js in produzione per:

  • Dare priorità ai bug reali sugli errori degli utenti
  • Migliorare la nostra risposta agli incidenti concentrandosi su problemi reali
  • Ridurre l'affaticamento da allerta da errori utente previsti
  • capire meglio problemi generati dall'applicazione rispetto a quelli generati dall'utente

Questo modello funziona per qualsiasi applicazione Node.js, che tu stia creando siti di e-commerce, piattaforme SaaS, API o microservizi.

Integrazione con la nostra registrazione di produzione

La nostra integrazione con il logger: helpers/logger.js

Il nostro logger utilizza isCodeBug per determinare i livelli di allerta e la redazione dei campi, assicurandoci di ricevere notifiche sui problemi reali e filtrando al contempo il rumore nel nostro ambiente di produzione Node.js.

Contenuti correlati

Scopri di più sui nostri modelli di gestione degli errori:

Debug delle prestazioni avanzato con v8-profiler-next e cpupro

Utilizziamo strumenti di profilazione avanzati per analizzare gli snapshot dell'heap e risolvere problemi di memoria insufficiente (OOM), colli di bottiglia nelle prestazioni e problemi di memoria di Node.js nel nostro ambiente di produzione. Questi strumenti sono essenziali per qualsiasi applicazione Node.js che riscontri perdite di memoria o problemi di prestazioni.

Il nostro approccio di profilazione per la produzione di Node.js

Strumenti che consigliamo:

  • v8-profiler-next - Per generare snapshot heap e profili CPU
  • cpupro - Per analizzare i profili della CPU e gli snapshot dell'heap

[!TIP] Utilizziamo v8-profiler-next e cpupro insieme per creare un flusso di lavoro completo per il debug delle prestazioni delle nostre applicazioni Node.js. Questa combinazione ci aiuta a identificare perdite di memoria, colli di bottiglia nelle prestazioni e a ottimizzare il nostro codice di produzione.

Come implementiamo l'analisi Heap Snapshot

La nostra implementazione del monitoraggio: helpers/monitor-server.js

Il nostro monitoraggio della produzione include la generazione automatica di snapshot dell'heap al superamento delle soglie di memoria. Questo ci aiuta a risolvere i problemi di OOM prima che causino crash dell'applicazione.

Modelli di implementazione chiave:

  • Istantanee automatiche quando la dimensione dell'heap supera la soglia di 2 GB
  • Profilazione basata sul segnale per analisi on-demand in produzione
  • Politiche di conservazione per la gestione dell'archiviazione degli snapshot
  • Integrazione con i nostri lavori di pulizia per la manutenzione automatizzata

Flusso di lavoro di debug delle prestazioni

Studia la nostra implementazione effettiva:

Per l'analisi degli snapshot heap:

  1. Installa v8-profiler-next per la generazione di snapshot
  2. Utilizzare cpupro per analizzare gli snapshot generati
  3. Implementare soglie di monitoraggio simile al nostro monitor-server.js
  4. Imposta la pulizia automatica per gestire l'archiviazione degli snapshot
  5. Creare gestori di segnali per la profilazione on-demand in produzione

Per la profilazione della CPU:

  1. Genera profili CPU durante i periodi di carico elevato
  2. Analizza con cpupro per identificare i colli di bottiglia
  3. Concentrarsi sui percorsi caldi e opportunità di ottimizzazione
  4. Monitorare prima/dopo miglioramenti delle prestazioni

[!WARNING] La generazione di snapshot dell'heap e profili CPU può influire sulle prestazioni. Si consiglia di implementare la limitazione e di abilitare la profilazione solo durante l'analisi di problemi specifici o durante le finestre di manutenzione.

Integrazione con il nostro monitoraggio della produzione

I nostri strumenti di profilazione si integrano con la nostra strategia di monitoraggio più ampia:

  • Attivazione automatica in base alle soglie di memoria/CPU
  • Integrazione degli avvisi quando vengono rilevati problemi di prestazioni
  • Analisi storica per monitorare l'andamento delle prestazioni nel tempo
  • Correlazione con le metriche dell'applicazione per un debug completo

Questo approccio ci ha aiutato a identificare e risolvere le perdite di memoria, ottimizzare i percorsi del codice attivo e mantenere prestazioni stabili nel nostro ambiente di produzione Node.js.

Sicurezza dell'infrastruttura di produzione Node.js

Implementiamo una sicurezza completa per la nostra infrastruttura di produzione Node.js tramite l'automazione Ansible. Queste procedure si applicano a qualsiasi applicazione Node.js:

Sicurezza a livello di sistema per la produzione di Node.js

La nostra implementazione Ansible: ansible/playbooks/security.yml

Le nostre principali misure di sicurezza per gli ambienti di produzione Node.js:

  • Scambio disabilitato per impedire che dati sensibili vengano scritti sul disco
  • Core dump disabilitati per prevenire dump di memoria contenenti informazioni sensibili
  • Archiviazione USB bloccata per impedire l'accesso non autorizzato ai dati
  • Ottimizzazione dei parametri del kernel sia per la sicurezza che per le prestazioni

[!WARNING] Quando si implementano le best practice per la distribuzione in produzione di Node.js, disabilitare lo swap può causare interruzioni per mancanza di memoria se l'applicazione supera la RAM disponibile. Monitoriamo attentamente l'utilizzo della memoria e dimensioniamo i nostri server in modo appropriato.

Sicurezza delle applicazioni per le applicazioni Node.js

La nostra redazione del campo di registro: helpers/logger.js

Ossudiamo i campi sensibili dai log, inclusi password, token, chiavi API e informazioni personali. Questo protegge la privacy degli utenti, mantenendo al contempo le funzionalità di debug in qualsiasi ambiente di produzione Node.js.

Automazione della sicurezza delle infrastrutture

La nostra configurazione completa di Ansible per la produzione Node.js:

I nostri contenuti di sicurezza

Scopri di più sul nostro approccio alla sicurezza:

Architettura del database per applicazioni Node.js

Utilizziamo un approccio di database ibrido ottimizzato per le nostre applicazioni Node.js. Questi modelli possono essere adattati a qualsiasi applicazione Node.js:

Implementazione di SQLite per la produzione Node.js

Cosa utilizziamo:

La nostra configurazione: ansible/playbooks/sqlite.yml

Utilizziamo SQLite per i dati specifici dell'utente nelle nostre applicazioni Node.js perché fornisce:

  • Isolamento dei dati per utente/inquilino
  • Prestazioni migliori per query monoutente
  • Backup semplificato e migrazione
  • Complessità ridotta rispetto ai database condivisi

Questo modello funziona bene per le applicazioni SaaS, i sistemi multi-tenant o qualsiasi applicazione Node.js che necessiti di isolamento dei dati.

Implementazione di MongoDB per la produzione Node.js

Cosa utilizziamo:

La nostra implementazione di configurazione: helpers/setup-mongoose.js

La nostra configurazione: config/mongoose.js

Utilizziamo MongoDB per i dati delle applicazioni nel nostro ambiente di produzione Node.js perché fornisce:

  • Schema flessibile per l'evoluzione delle strutture dati
  • Prestazioni migliori per query complesse
  • Scala orizzontale capacità
  • Linguaggio di query avanzato

[!NOTE] Il nostro approccio ibrido ottimizza il nostro caso d'uso specifico. Studia i nostri modelli di utilizzo effettivi del database nel codice sorgente per capire se questo approccio si adatta alle esigenze della tua applicazione Node.js.

Elaborazione del lavoro in background di produzione di Node.js

Abbiamo costruito la nostra architettura per i processi in background attorno a Bree per un'implementazione affidabile in produzione di Node.js. Questo vale per qualsiasi applicazione Node.js che necessiti di elaborazione in background:

La nostra configurazione del server Bree per la produzione

La nostra principale implementazione: bree.js

La nostra distribuzione Ansible: ansible/playbooks/bree.yml

Esempi di lavori di produzione

Monitoraggio sanitario: jobs/check-pm2.js

Automazione della pulizia: jobs/cleanup-tmp.js

Tutti i nostri lavori: Sfoglia la nostra directory completa dei lavori

Questi modelli si applicano a qualsiasi applicazione Node.js che necessiti di:

  • Attività pianificate (elaborazione dati, report, pulizia)
  • Elaborazione in background (ridimensionamento delle immagini, invio di e-mail, importazione di dati)
  • Monitoraggio e mantenimento della salute
  • Utilizzo del thread di lavoro per attività ad alta intensità di CPU

I nostri modelli di pianificazione dei lavori per la produzione Node.js

Studia i nostri attuali modelli di pianificazione del lavoro nella nostra directory dei lavori per capire:

  • Come implementiamo la pianificazione di tipo cron nella produzione Node.js
  • La nostra gestione degli errori e la logica di ripetizione
  • Come utilizziamo i thread di lavoro per le attività che richiedono un uso intensivo della CPU

Manutenzione automatizzata per applicazioni Node.js di produzione

Implementiamo la manutenzione proattiva per prevenire i problemi comuni di produzione di Node.js. Questi modelli si applicano a qualsiasi applicazione Node.js:

La nostra implementazione di pulizia

Fonte: jobs/cleanup-tmp.js

La nostra manutenzione automatizzata per le applicazioni di produzione Node.js ha come obiettivi:

  • File temporanei più vecchio di 24 ore
  • File di registro oltre i limiti di conservazione
  • File di cache e dati temporanei
  • File caricati che non servono più
  • Istantanee di heap dal debug delle prestazioni

Questi modelli si applicano a qualsiasi applicazione Node.js che genera file temporanei, registri o dati memorizzati nella cache.

Gestione dello spazio su disco per la produzione di Node.js

Le nostre soglie di monitoraggio: helpers/monitor-server.js

  • Limiti di coda per l'elaborazione in background
  • Utilizzo del disco al 75% soglia di allerta
  • Pulizia automatica quando vengono superate le soglie

Automazione della manutenzione delle infrastrutture

La nostra automazione Ansible per la produzione Node.js:

Guida all'implementazione della distribuzione di produzione di Node.js

Studia il nostro codice attuale per le migliori pratiche di produzione

Inizia con questi file chiave per la configurazione dell'ambiente di produzione Node.js:

  1. Configurazione: config/index.js
  2. Monitoraggio: helpers/monitor-server.js
  3. Gestione degli errori: helpers/is-code-bug.js
  4. Registrazione: helpers/logger.js
  5. Salute del processo: jobs/check-pm2.js

Impara dai nostri post del blog

Le nostre guide tecniche all'implementazione per la produzione di Node.js:

Automazione dell'infrastruttura per la produzione Node.js

I nostri playbook Ansible da studiare per la distribuzione in produzione di Node.js:

I nostri casi di studio

Le nostre implementazioni aziendali:

Conclusione: Best Practice per la distribuzione in produzione di Node.js

La nostra infrastruttura di produzione Node.js dimostra che le applicazioni Node.js possono raggiungere un'affidabilità di livello aziendale attraverso:

  • Scelte hardware comprovate (AMD Ryzen per un'ottimizzazione delle prestazioni single-core del 573%)
  • Monitoraggio della produzione Node.js testato in battaglia con soglie specifiche e risposte automatizzate
  • Classificazione intelligente degli errori per migliorare la risposta agli incidenti negli ambienti di produzione
  • Debug delle prestazioni avanzato con v8-profiler-next e cpupro per la prevenzione OOM
  • Rafforzamento completo della sicurezza tramite l'automazione Ansible
  • Architettura di database ibrida ottimizzato per le esigenze applicative
  • Manutenzione automatizzata per prevenire i comuni problemi di produzione di Node.js

Punto chiave: Studiate i nostri file di implementazione e i post del blog, invece di seguire best practice generiche. Il nostro codice sorgente fornisce modelli concreti per l'implementazione in produzione di Node.js, adattabili a qualsiasi applicazione Node.js: app web, API, microservizi o servizi in background.

Elenco completo delle risorse per la produzione di Node.js

I nostri file di implementazione principali

Le nostre implementazioni server

La nostra automazione delle infrastrutture

I nostri post del blog tecnico

I nostri casi di studio aziendali