Formations — 1 037 leçons en français

Accueil › Node.js › Processus, arguments et environnement

Processus, arguments et environnement

Démarrer avec Nodedebutant

Les arguments

// node migrer.js --dry-run --depuis=12
const args = process.argv.slice(2);     // les deux premiers sont node et le script

Avec l'analyseur intégré :

import { parseArgs } from "node:util";

const { values } = parseArgs({
  options: {
    "dry-run": { type: "boolean", default: false },
    depuis: { type: "string" },
  },
});

L'environnement, lu une seule fois

// src/config.js
const requises = ["DATABASE_URL", "JWT_SECRET"];
const manquantes = requises.filter((c) => !process.env[c]);

if (manquantes.length > 0) {
  console.error(`Variables manquantes : ${manquantes.join(", ")}`);
  process.exit(1);
}

export const config = {
  port: Number(process.env.PORT ?? 3000),
  baseUrl: process.env.DATABASE_URL,
  secret: process.env.JWT_SECRET,
};

Le reste du code lit config, jamais process.env. Une seule frontière, une seule validation.

Pourquoi au démarrage

Une variable absente vaut undefined. Le programme démarre, répond aux contrôles de santé, et échoue trois heures plus tard sur un appel vers undefined/clients. L'erreur arrive loin de sa cause.

L'arrêt propre

const serveur = app.listen(config.port);

for (const signal of ["SIGTERM", "SIGINT"]) {
  process.on(signal, () => {
    serveur.close(async () => {          // plus de nouvelles connexions
      await base.end();                   // on ferme ce qui reste
      process.exit(0);
    });
  });
}

Sans cela, chaque déploiement coupe les requêtes en vol.

Les termes à connaître

Configuration par l'environnement

Le même artefact dans tous les environnements, et des variables qui changent. C'est ce qui rend une mise en production reproductible.

process.argv

Les arguments de la ligne de commande. Les deux premiers sont l'exécutable et le script : les arguments utiles commencent à l'indice 2.

parseArgs

L'analyseur d'arguments intégré, dans node:util. Il remplace une dépendance pour les cas simples.

Validation au démarrage

Vérifier la configuration avant d'écouter sur un port. Une variable manquante doit faire échouer le démarrage, pas la première requête.

Signal d'arrêt

SIGTERM demande au processus de s'arrêter. L'orchestrateur l'envoie, puis force l'arrêt quelques secondes plus tard.

Arrêt propre

Cesser d'accepter des connexions, terminer celles en cours, fermer les ressources, puis sortir. Ce qui manque le plus souvent dans les projets.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.