Voici les workflows durables

Les tâches en arrière-plan commencent simplement, puis finissent en empilement de files d’attente, d’entrées cron et de tables de relance. Les workflows durables remplacent tout cela par du code ordinaire : vous écrivez les étapes dans l’ordre, et la plateforme s’assure que chacune va jusqu’au bout, même si un déploiement ou un plantage l’interrompt.

Les workflows durables sont disponibles dès aujourd’hui sur toutes les offres.

Comment s’exécute un workflow

Un workflow est une fonction composée d’étapes nommées. Quand une étape se termine, son résultat est enregistré comme point de reprise. Si le processus s’arrête, l’exécution suivante saute les étapes terminées et reprend au dernier point de reprise, avec les mêmes entrées.

import { workflow, step } from "@cloud/workflows";

export default workflow("send-invoices", async () => {
  const accounts = await step("load", () => loadAccounts());
  const invoices = await step("render", () => renderInvoices(accounts));
  await step("send", { retries: 5, timeout: "2m" }, () => sendAll(invoices));
});

Chaque étape doit pouvoir être relancée sans risque. Une bonne règle : écrire le résultat d’une étape à un seul endroit, avec une clé d’idempotence, pour qu’une relance n’envoie jamais deux fois la même facture.

Le lancer depuis votre application

Un workflow démarre depuis un appel API, une planification ou un autre workflow. L’appel renvoie immédiatement un identifiant d’exécution : votre gestionnaire de requête n’attend jamais la fin du travail.

import { workflows } from "@cloud/sdk";

const run = await workflows.start("send-invoices", { month: "2026-10" });
console.log(run.id); // wf_run_8f2c...

Déboguer une exécution en échec

Chaque exécution a une chronologie dans le tableau de bord, avec l’entrée, la sortie, la durée et les journaux de chaque étape. Quand une étape échoue après sa dernière relance, l’exécution se met en pause au lieu de disparaître. Corrigez le bug, déployez, puis rejouez l’exécution à partir de l’étape en échec.

cloud workflows replay wf_run_8f2c --from send

Limites et tarifs

Les workflows sont facturés comme du calcul classique. Les points de reprise et les rejeux sont inclus. Une exécution peut durer jusqu’à 30 jours, et une étape peut renvoyer jusqu’à 1 Mo de données. La liste complète des limites figure dans le changelog.