# Tâches cron

> Exécutez des commandes planifiées, lancez-les à la demande et consultez l’historique des exécutions.

Source: https://gheima.ma/fr/docs/cron-jobs

Les tâches cron exécutent une commande selon un planning, isolées comme vos apps. Utilisez-les pour des sauvegardes, des résumés, des nettoyages ou toute tâche récurrente.

### Créer une tâche

1. **Nouvelle tâche cron** — Sur la page Tâches cron, cliquez sur « Nouvelle tâche cron » et nommez-la.
2. **Définissez un planning** — Choisissez un préréglage, comme « Toutes les heures » ou « Chaque jour », ou tapez une expression cron comme 0 * * * *. Une description en clair indique quand la tâche s’exécute. Les plannings s’exécutent en UTC.
3. **Définissez la commande** — Saisissez la commande à exécuter, par exemple npm run task. Vous pouvez l’exécuter avec l’image et l’environnement d’un service, ou avec l’image de base.

```
0 * * * *
```

S’exécute au début de chaque heure. Votre plan fixe l’intervalle minimum autorisé.

### Exécuter maintenant et historique

- Cliquez sur « Exécuter maintenant » pour lancer une tâche immédiatement.
- Mettez une tâche en pause avec son interrupteur, sans la supprimer.
- L’historique des exécutions liste les exécutions récentes avec leur statut, leur durée, leur code de sortie et leurs logs.

### Options et limites de planning

- `Intervalle minimum`: Votre plan fixe le plus petit écart autorisé entre les exécutions.
- `Fuseau horaire`: UTC par défaut, et le tableau de bord crée toutes les tâches en UTC. Définissez timezone via l’API pour évaluer le planning dans un autre fuseau.
- `Délai`: Une exécution qui dépasse son délai est arrêtée. Le délai est de 300 secondes par défaut, 3 600 au maximum. Définissez timeoutSeconds via l’API.
- `Cible`: Exécuter avec l’image et l’environnement d’un service, ou avec l’image de base.

> Result: Votre commande s’exécute selon le planning, à la demande quand il le faut, avec un historique complet des exécutions passées.

---

All docs: https://gheima.ma/fr/docs.md