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
SIGTERMdemande 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.
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.