Planifications
Une tâche s'exécute selon sa propre planification — une expression cron et un fuseau horaire — et selon celles de ses préréglages. Une tâche sans planification ne s'exécute que par un clic sur Exécuter.
Le cron dans Nomaflow
Une planification comporte cinq zones :
┌──── minute (0-59)
│ ┌── heure (0-23)
│ │ ┌── jour du mois (1-31)
│ │ │ ┌── mois (1-12)
│ │ │ │ ┌── jour de la semaine (mon-sun)
0 2 * * *
| Opérateur | Signification | Exemple |
|---|---|---|
* | toutes les valeurs | * * * * * — chaque minute |
, | une liste | 0 6,12,18 * * * — à 06:00, 12:00 et 18:00 |
- | un intervalle | 0 9 * * mon-fri — en semaine à 09:00 |
/ | un pas | */10 * * * * — toutes les 10 minutes |
Le planificateur numérote les jours de 0 = lundi à 6 = dimanche — contrairement au cron Unix, où 0 désigne le dimanche. 0 9 * * 1 s'exécute donc le mardi. Écrire mon, tue… sun (mon-fri, sat,sun) : les noms ne laissent aucun doute, et l'aperçu sous le champ confirme les jours.
Quand le jour du mois et le jour de la semaine sont tous deux renseignés, les deux doivent correspondre : 0 9 15 * mon s'exécute un 15 qui tombe un lundi.
| Besoin | Cron |
|---|---|
| Toutes les 5 minutes | */5 * * * * |
| Chaque heure à :15 | 15 * * * * |
| Chaque jour à 02:00 | 0 2 * * * |
| En semaine à 09:00 | 0 9 * * mon-fri |
| Chaque lundi à 06:00 | 0 6 * * mon |
| Le 1er de chaque mois à 07:00 | 0 7 1 * * |
| Chaque trimestre (1er janvier, avril, juillet, octobre) à 03:00 | 0 3 1 1,4,7,10 * |
Dans l'éditeur de tâche
Le champ Planification (cron) de l'éditeur propose des choix tout faits — Manuelle, Horaire, Quotidienne, Hebdomadaire, Mensuelle — et un cron libre. Sous le champ, Prochaines exécutions liste les cinq prochaines exécutions dans le fuseau de la tâche ; la liste est recalculée peu après chaque modification, et une expression invalide y est signalée.
Fuseau horaire est un nom IANA (Europe/Paris, America/New_York). La planification est évaluée dans ce fuseau, heure d'été comprise : 0 2 * * * en Europe/Paris s'exécute à 02:00 heure de Paris toute l'année.
La vue Planning
Exploitation → Planning, dans le menu de Nomaflow, montre ce qui s'exécute et quand, jour par jour.
| Partie | Contenu |
|---|---|
| Compteurs | Les exécutions prévues dans les 24 h, les planifications actives, les planifications désactivées, les tâches lancées à la main uniquement. |
| À venir | Chaque planification active à sa prochaine exécution — celle de la tâche, et une par préréglage planifié (le nom du préréglage à côté de la tâche) —, groupées par jour : Aujourd'hui, Demain, puis la date. Chaque ligne présente l'heure, la tâche, la planification en clair (chaque jour à 03:00, chaque lundi à 07:00) avec le cron en dessous, l'échéance et l'état de la dernière exécution. |
| Planifiées mais désactivées | Les planifications définies mais désactivées. |
| Lancées à la main uniquement | Les tâches sans aucune planification, repliées ; un clic sur l'une ouvre son éditeur. |
Les planifications que la page ne sait pas exprimer en clair — listes d'heures, plusieurs mois — n'affichent que leur cron.
Préréglages planifiables
Un préréglage est un jeu de paramètres d'exécution enregistré (paramètres, arguments des étapes, étapes activées ou non, niveau de journal), créé depuis la fenêtre Exécuter avec des paramètres avec Enregistrer comme préréglage…. Dans l'éditeur de tâche, la section Préréglages & plannings donne à chaque préréglage sa propre Planification (cron) et son Fuseau horaire, ainsi qu'une case Planning activé.
Le planificateur exécute alors la tâche selon cette planification avec les paramètres du préréglage : une tâche, plusieurs planifications, des entrées différentes — un chargement complet la nuit et un incrément toutes les heures pour le même ETL, par exemple.
La planification d'un préréglage ne dépend pas du switch Activée de la tâche : un préréglage activé s'exécute même quand la planification propre de la tâche est arrêtée.
Cloner crée une copie désactivée et sans aucune planification : le cron de la tâche et ceux des préréglages sont retirés, si bien que la copie ne se déclenche jamais en même temps que l'original. Ses planifications se définissent une fois la copie prête.
Planifications manquées
Une exécution peut ne pas avoir lieu : le serveur était arrêté à ce moment-là, ou l'exécution précédente de la même tâche était encore en cours. Nomaflow recherche ces manques et enregistre chacun comme une exécution à l'état MISSED, avec l'heure attendue, dans l'historique des exécutions et comme dernière exécution de la tâche. Une règle sur l'événement missed peut prévenir quelqu'un — voir Notifications.
Le panneau Planifications manquées de la page des Tâches (à côté du panneau de rétention) affiche la politique et le dernier contrôle, et Contrôler maintenant lance aussitôt un contrôle.
| Réglage | Défaut | Signification |
|---|---|---|
| Contrôle | activé | Active ou désactive le contrôle. |
| Tolérance (min) | 10 | Une exécution lancée dans ce délai après l'heure attendue — planifiée ou manuelle — compte pour elle. |
| Intervalle de contrôle (min) | 5 | La fréquence du contrôle. |
| Fenêtre arrière (heures) | 24 | La profondeur maximale d'un contrôle. Une tâche qui ne s'est jamais exécutée n'est contrôlée qu'à partir du démarrage du planificateur. |
La politique s'enregistre dans jobs.toml, sous [meta.missed]. Une heure manquée n'est enregistrée qu'une fois : un redémarrage ne la signale pas de nouveau.
Suspendre une planification
| Option | Effet |
|---|---|
| La pastille activée / désactivée de la tâche dans la page des Tâches, ou Mettre la planification en pause sur la carte des tâches d'un tableau de bord | La planification propre de la tâche s'arrête aussitôt, sans rechargement. Exécuter fonctionne toujours ; les planifications des préréglages continuent, sauf si elles sont désactivées. |
| Manuelle dans le champ Planification | La planification propre de la tâche est retirée. |
| Planning activé décoché sur un préréglage | La planification de ce préréglage s'arrête. |
Conseils
- Étaler les tâches lourdes sur la nuit (02:00, 02:30, 03:00) plutôt que de toutes les lancer à minuit.
- Préférer
15 * * * *à0 * * * *pour les tâches horaires : beaucoup d'autres systèmes s'exécutent à l'heure pile. - Utiliser un nom de fuseau horaire, jamais un décalage fixe, pour suivre l'heure d'été.
- Vérifier l'aperçu Prochaines exécutions après chaque modification : c'est le moyen le plus rapide de repérer un mauvais jour.