Aller au contenu

Aller au sommaire de la doc

Tâches planifiées

Une commande lancée à heure fixe : un import chaque nuit, un ménage, un rapport. Chaque passage est suivi, et votre agent est prévenu d’un échec.

Mis à jour le 9 novembre 2026.

Voir en Markdown

Vous, à votre agent : Lance l’import des ventes tous les jours à 6 h.

Ce que votre agent écrit

Votre agent l’écrit dans while.yaml, à la racine de votre appli :

while.yaml
crons:
  - name: menage
    title: Ménage de la nuit
    schedule: "0 3 * * *"
    command: [node, menage.js]
    timezone: Europe/Paris
    timeout_seconds: 600
    retries: 1
    concurrency: forbid

Ce que reçoit votre appli

Votre appli reçoit ces variables d’environnement à chaque mise en ligne :

VariableCe qu’elle contient
WHILE_CRONLe nom de la tâche.
WHILE_TRIGGERComment ce passage a été lancé : scheduled, manual ou catch_up.
WHILE_CATCH_UP_STARTLe début de la période à rattraper.
WHILE_CATCH_UP_ENDSa fin.

Quand vous en servir

Servez-vous-en pour ce qui part à heure fixe : charger une API externe chaque nuit, faire le ménage, écrire un rapport. Rien n’est réservé entre deux passages, et un passage dure 6 heures au plus.

Comment ça marche

Une tâche planifiée lance une commande à heure fixe, avec l’image et les variables d’un service, ou avec une image construite pour elle. Chaque passage est suivi, et un échec ou un passage manqué réveille l’agent.

Ce qu’il faut savoir

L’horaire suit la syntaxe cron, à l’heure de Paris par défaut (timezone). Une tâche réussit quand elle sort avec le code 0, et tout autre code est un échec. Chaque passage garde sa durée, son code de sortie, les dernières lignes de son journal et l’erreur résumée.

Un passage qui dépasse timeout_seconds (600 par défaut, 6 heures au plus) est arrêté, et retries le relance dans le même passage (0 par défaut). concurrency décide des chevauchements : forbid, le défaut, refuse qu’un passage en chevauche un autre, allow le permet, et replace arrête le passage en cours. Un passage lancé à la main au moment où un passage planifié démarre peut encore le chevaucher.

Chaque passage sait comment il a été lancé : WHILE_TRIGGER vaut scheduled, manual ou catch_up. Un rattrapage reçoit sa période dans WHILE_CATCH_UP_START et WHILE_CATCH_UP_END, et la commande ne traite qu’elle. Votre agent relance une tâche, ou rattrape une période, avec l’outil run_task.

Prix

Ces prix sont les mêmes dans toutes les offres, hors taxes :

RessourcePrixDétail
Processeur et mémoire17 € par vCPU·mois et 8,50 € par Gio·moisapplis à la consommation, caches à la réservation

Les outils MCP de votre agent

Votre agent s’en occupe avec les outils list_tasks et run_task.

Guides

Branchez votre agent, il s’occupe du reste

À coller dans votre agent

Lis while.sh/agents, puis mets mon appli en ligne avec while.

Copier les instructions

Pas besoin de compte pour essayer : votre appli est en ligne tout de suite. Pour la garder, connectez-vous.

Un projet pour votre entreprise ? Parlez à l’équipe : hello@while.sh