Aller au contenu
TYPEDébloqué
ÉTAPEProduction
DIFFICULTÉSimple
MÉTIERAutomatiser une tâche
POURFondateurs solo
POURDevs backend
SERVICESCron
SERVICESFiles
POURQUOI HOODYHTTP-natif
TYPEDébloqué
ÉTAPEProduction
DIFFICULTÉSimple
MÉTIERAutomatiser une tâche
POURFondateurs solo
POURDevs backend
SERVICESCron
SERVICESFiles
POURQUOI HOODYHTTP-natif
TYPEDébloqué
ÉTAPEProduction
DIFFICULTÉSimple
MÉTIERAutomatiser une tâche
POURFondateurs solo
POURDevs backend
SERVICESCron
SERVICESFiles
POURQUOI HOODYHTTP-natif
TYPEDébloqué
ÉTAPEProduction
DIFFICULTÉSimple
MÉTIERAutomatiser une tâche
POURFondateurs solo
POURDevs backend
SERVICESCron
SERVICESFiles
POURQUOI HOODYHTTP-natif
Retour aux cas d'usage
CRON · FILES · AUTO-RETIRÉ

Des jobs de nettoyage qui planifient leur propre retraite

Provisionnez une entrée cron managée le jour où le nettoyage commence. Mettez expires_at quelques jours après le dernier run attendu. Le script tranche le travail nuit après nuit, puis se DELETE quand il ne reste plus rien. Pas de rappel calendrier, pas de crontab zombie, pas de revue annuelle pour nettoyer les nettoyages.

Doc cron
cleanup-stale-uploads.sh
# tail of cleanup-stale-uploads.sh
removed=$(find /uploads -mtime +90 -delete -print | wc -l)
echo "$removed files removed"

# self-aware tail: nothing left → retire
if [ -z "$(ls /uploads)" ]; then
  curl -fsS -X DELETE \
    "$CRON_URL/entries/$ENTRY_ID"
fi

La queue auto-consciente. L'entrée cron est la dernière ligne de son propre script.

Un nettoyage avec une durée de vie finie, par construction

Trois phases discrètes. Chaque transition est mécanique, aucune n'exige qu'un humain s'en souvienne. L'entrée sait quand son travail est fait et quand son créneau calendrier est passé.

CYCLE · PLANIFIER → TRANCHER → AUTO-SUPPRIMERUNE ENTRÉE, UNE VIE FINIE
1 · PLANIFIER

POST une entrée le jour où le nettoyage commence

Schedule @daily, command pointe vers un script slicer, expires_at est positionné juste après le dernier run attendu. La deadline est dans l'entrée — pas dans un doc Notion, pas dans un thread Slack.

2 · TRANCHER

Le script grignote nuit après nuit, en douceur

Chaque run supprime une tranche de données obsolètes pour ne pas marteler la base. Jour 1 peut vider 247 fichiers ; jour 6 juste 1. Le rythme est borné par ce qui reste réellement.

3 · AUTO-SUPPRIMER

Quand le travail est fait, l'entrée se retire

Le dernier bloc du script vérifie si la cible est vide. Si oui, il tire DELETE /entries/[self]. Si pour une raison quelconque ça ne se fait pas, expires_at déclenche le filet de sécurité un ou deux jours plus tard.

Deux déclencheurs indépendants — la propre vérification du script et l'expires_at de l'API — convergent vers le même résultat : une ligne de crontab qui ne survit pas à son propos.

Deux appels HTTP, un nettoyage fini

Hoody Cron est un wrapper JSON-CRUD autour du crontab système. POST crée l'entrée ; DELETE la retire ; expires_at est le filet de sécurité. Le script qui tourne nuit après nuit est celui qui sait quand c'est fini — donc c'est celui qui appelle DELETE.

create-entry.sh
JOUR 0 · POST
# day 0 — provision the cleanup
curl -X POST \
  https://cron.containers.hoody.com/users/me/entries \
  -H "Content-Type: application/json" \
  -d '["schedule":"@daily","command":"/srv/jobs/cleanup-stale-uploads.sh","expires_at":"2026-05-05T00:00:00Z"]'

# response
HTTP/1.1 201 Created
{ "id":"f3a1", "expires_at":"2026-05-05T00:00:00Z", "enabled":true }
cleanup-stale-uploads.sh
JOUR 7 · DELETE
# inside the cron command itself
if [ -z "$(ls /uploads)" ]; then
  curl -X DELETE \
    "$CRON_URL/entries/$ENTRY_ID"
fi

# response
HTTP/1.1 204 No Content
# entry f3a1 was here. f3a1 deleted itself.

$ENTRY_ID est l'UUID retourné par le POST. Passe-le par la ligne de commande pour que le script puisse le lire depuis un fichier ou argv. De toute façon, l'entrée cron supprime l'entrée cron.

Ce que le nettoyage auto-retiré débloque

Ce n'est pas la suppression qui compte. C'est que personne n'aura à se souvenir que tout ça existe dans trois mois.

RYTHME SANS PRESSION

Tranche par tranche, pas tout d'un coup

@daily tourne toutes les 24 heures. Le script supprime une tranche de données obsolètes — quelques milliers de fichiers, quelques milliers de lignes — et sort. La base reste calme ; la courbe de charge a l'air de rien.

PAS DE CRONTAB ZOMBIE

La ligne ne survit pas à l'ingénieur

expires_at est dans l'entrée en JSON. Quand il se déclenche, la ligne est retirée du crontab système. Trois ingénieurs plus tard, personne ne fouille 200 lignes pour deviner ce que cleanup-stale-uploads-v3 fait encore.

DEUX DÉCLENCHEURS, UN RÉSULTAT

Auto-DELETE plus filet expires_at

Le script se DELETE la nuit où le travail est fait. Si un bug saute ce chemin, expires_at retire l'entrée un ou deux jours plus tard. Deux mécanismes indépendants ; l'un des deux se déclenchera.

Ce que ça scale

Chaque entrée managée est une ligne de JSON que l'API injecte dans le crontab système. Le scaling est borné par ce que cron lui-même peut tenir, pas par Hoody.

  1. CADENCE DE RUN1 / jour

    @daily est le rythme canonique du nettoyage. Si vous avez besoin de passages plus fréquents vous pouvez utiliser des expressions à 5 champs jusqu'à * * * * * — résolution à la minute.

  2. DURÉE DE VIE D'UNE ENTRÉEexpires_at

    Un timestamp ISO-8601 sur l'entrée. Quand il passe, l'API retire la ligne au prochain balayage. Le nettoyage ne traîne jamais au-delà de sa propre deadline.

  3. TEARDOWN HTTPDELETE · 204

    DELETE /users/[user]/entries/[id] depuis l'intérieur de la commande en cours fonctionne parce que le daemon cron ne verrouille pas son propre crontab — l'API balaie le changement en sécurité.

Expressions cron standard à 5 champs plus macros (@hourly, @daily, @weekly, @monthly, @yearly). Isolation par utilisateur ; chaque utilisateur système a son propre crontab. La page Cron du Hoody Kit documente à la fois les entrées managées et l'accès crontab brut si vous avez besoin de la forme historique.

Le nettoyage tourne nuit après nuit jusqu'à ce que la chose à nettoyer ait disparu.

AVANT · RAPPELS CALENDRIER, LIGNES CRON ZOMBIESAPRÈS · UNE ENTRÉE CRON QUI SAIT QUAND C'EST FINI
AVANT// TODO: delete this when /uploads is empty (2026?)Un commentaire que votre futur vous lira une fois et plus jamais.
MAINTENANTDELETE /entries/$ENTRY_ID · expires_at: 2026-05-05Un teardown qui se déclenche depuis le script et une deadline encodée dans l'entrée elle-même.
Référence API Cron

Ce que ça remplace

Partout où une tâche de nettoyage est censée disparaître toute seule — voici les patterns que ça remplace :

  • Jobs cron de nettoyage zombiesDes lignes de 2022 que personne n'ose supprimer
  • // TODO: delete this when X is emptyUn commentaire devenu permanent
  • Scripts janitor manuelsUn coéquipier les lance tous les trimestres, quand il y pense
  • CronJobs Kubernetes qui ne se suppriment jamaisttlSecondsAfterFinished sur le pod, pas sur la planification
  • Gestionnaires de cycle de vie auto-conscients customUn service maison qui surveille vos autres services
  • Policies lifecycle gérées par TerraformPlan, apply, six mois plus tard toujours dans le tfstate

Provisionne le nettoyage. Fixe sa date de retraite. Pars.

Lire la doc Cron

Lis les autres