Formations — 1 037 leçons en français

Accueil › Node.js › Tâches planifiées sur plusieurs instances

Tâches planifiées sur plusieurs instances

Tâches de fond et filesavance

Une tâche planifiée est déclenchée par l'horloge : purger les sessions à 3 h, relancer les paiements échoués chaque heure, envoyer un récapitulatif chaque nuit.

// ⛔ sur trois instances, cela s'exécute trois fois
import cron from "node-cron";
cron.schedule("0 3 * * *", () => purgerSessions());

Chaque instance a sa propre horloge et ne sait rien des autres. Trois répliques derrière un répartiteur de charge, c'est trois purges, trois récapitulatifs, trois courriels par client.

Deux corrections, pas trois

Un verrou à bail, pris sur l'occurrence :

const occurrence = new Date().toISOString().slice(0, 13);   // 2025-11-13T03
const pris = await redis.set(`cron:purge:${occurrence}`, instanceId, {
  NX: true,
  PX: 10 * 60_000,     // bail de 10 minutes
});
if (!pris) return;     // une autre instance s'en occupe
await purgerSessions();

Le verrou est nommé par l'occurrence, pas par la tâche : la purge de 3 h de demain prendra une clé différente. Et le bail expire, sinon une instance tuée pendant l'exécution bloque la tâche pour toujours.

Un déclencheur extérieur unique : un CronJob Kubernetes, une tâche planifiée du fournisseur, ou un ordonnanceur dédié qui ne fait que déposer le travail dans la file. Les consommateurs restent nombreux, le déclenchement est unique.

C'est l'option préférable quand l'infrastructure le permet : elle supprime le problème au lieu de le gérer.

Les termes à connaître

Tâche planifiée

Un travail déclenché par l'horloge et non par une requête : relancer les paiements, purger les sessions, envoyer un récapitulatif nocturne.

Verrou à bail

Un verrou distribué qui expire tout seul. Il désigne une seule instance pour l'exécution, et se libère si l'instance meurt.

Ordonnanceur unique

Un seul processus — ou un déclencheur extérieur — chargé de déposer la tâche dans la file. Les consommateurs restent nombreux.

Occurrence

L'instant planifié d'une exécution, identifié par sa date. C'est la clé naturelle d'idempotence d'une tâche planifiée.

Heure UTC

Le temps de référence sans heure d'été. Planifier en UTC supprime les occurrences doublées ou manquées du changement d'heure.

Fenêtre de rattrapage

La règle qui dit quoi faire d'une occurrence manquée pendant un arrêt — la rejouer, ou la sauter.

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.