Et si le serveur tombait en plein milieu ?
Une boutique en ligne prend ta commande : elle réserve le stock, débite ta carte, t'envoie un reçu par e-mail et réserve un coursier. Et si le serveur tombe juste après le débit ? Relance la tâche depuis le début et tu paies deux fois. L'exécution durable permet aux tâches longues de survivre à un plantage : chaque étape terminée est notée, et une nouvelle exécution continue au lieu de tout recommencer.
À la fin de cette leçon
Remarque
Je peux expliquer comment un journal des étapes terminées permet à un workflow planté de continuer sans faire une étape deux fois.
Mots-clés
- Workflow : une tâche faite d'étapes qui doivent toutes avoir lieu, dans l'ordre.
- Étape : un morceau de la tâche, par exemple débiter une carte.
- Journal : une table où l'on note chaque étape terminée et son résultat.
- Rejeu (replay) : lire le résultat d'une étape dans le journal au lieu de la refaire.
- Clé d'idempotence : un nom pour une requête, pour que la faire deux fois ait l'effet d'une seule.
- Saga : un workflow qui annule ses étapes terminées quand une étape suivante échoue.
Pour commencer : ce que tu sais déjà
Remarque
Réponds dans ta tête. 1. Que contient une table de base de données ? 2. Que deviennent les variables d'un programme quand son processus s'arrête ? 3. Pourquoi une boutique donne-t-elle un numéro à chaque commande ? Réponses : des lignes de données ; elles sont perdues ; pour retrouver cette commande précise et en parler.
Avant de commencer
Remarque
Appuie sur Démarrer le lab dans la barre en haut de la leçon et attends qu'il indique qu'il est en marche. Il y a deux conteneurs. worker fait tourner le Python et db est PostgreSQL. Le terminal les atteint avec docker exec, qui lance une commande à l'intérieur d'un conteneur. Chaque bouton Exécuter ci-dessous tape sa commande dans le terminal de ton lab, l'une après l'autre, dans la même session. Pour suivre les commandes ou taper les tiennes, appuie sur Ouvrir le terminal dans la barre.
Une tâche simple repart du début
La première commande lance la tâche de commande sans journal, avec l'ordre de planter juste après le débit de la carte. Elle affiche deux lignes done puis la ligne du plantage. La deuxième est la relance : elle repart du début et débite de nouveau. La troisième demande à PostgreSQL les paiements de order-1 : il y a 2 lignes de 2500. Le client a payé deux fois.
docker exec worker python3 naive.py order-1 --fresh --crash-after charge_cardAffichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.
docker exec worker python3 naive.py order-1Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.
docker exec db psql -U durable -c "SELECT workflow, amount FROM payments WHERE workflow = 'order-1'"Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.
Un journal se souvient de chaque étape terminée
order.py est la même commande, écrite avec le moteur. Après chaque étape, le moteur note l'étape et son résultat dans la table journal. Cette commande plante après 2 nouvelles étapes. Le journal contient alors 2 lignes : l'étape 0 est reserve_stock et l'étape 1 est charge_card, chacune avec son résultat.
docker exec worker python3 order.py order-7 --fresh --crash-after 2Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.
docker exec db psql -U durable -c "SELECT seq, step, result FROM journal WHERE workflow = 'order-7' ORDER BY seq"Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.
La reprise rejoue le journal et continue
Relance le même workflow, sans option. Il trouve 2 lignes dans le journal, donc il affiche replay pour les étapes 0 et 1 et prend leurs résultats dans les lignes. Seules les étapes 2 et 3 tournent vraiment. La carte a été débitée une seule fois.
docker exec worker python3 order.py order-7Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.
Vérification
Astuce
Pourquoi la deuxième exécution de order.py n'a-t-elle pas débité la carte de nouveau ? Réponse : l'étape 1, charge_card, avait déjà une ligne dans le journal, donc le moteur a rejoué son résultat au lieu de l'exécuter.
Une clé d'idempotence rend une répétition sans effet
Il reste une brèche : un plantage après le débit mais avant sa ligne de journal. La première commande plante exactement là. La reprise n'a pas de ligne pour le débit, donc elle débite de nouveau. Avec --keyed, le débit porte la clé order-9:charge_card, et le prestataire de paiement prend un seul paiement par clé : la deuxième réponse dit "repeat": true et rien de plus n'est pris.
docker exec worker python3 order.py order-9 --fresh --keyed --crash-inside charge_cardAffichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.
docker exec worker python3 order.py order-9 --keyedAffichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.
Une saga annule ce qui a été fait
Un voyage demande un vol, un hôtel et une voiture. Cette commande fait échouer la voiture. Le moteur note aussi l'échec, puis exécute les compensations, la plus récente d'abord : cancel_hotel, puis cancel_flight. La dernière ligne dit que plus rien n'est réservé.
docker exec worker python3 saga.py trip-2 --fresh --fail-at book_carAffichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.
Une erreur fréquente
Attention
Beaucoup pensent qu'un journal suffit pour que chaque effet ait lieu exactement une fois. C'est faux : un plantage entre un effet et sa ligne de journal refait cet effet à la reprise. L'exactement une fois demande les deux moitiés : le journal, pour ne pas refaire les étapes terminées, et une clé d'idempotence, pour ignorer un effet répété.
Vérification finale
Astuce
Réponds sans revenir en arrière. 1. Où le moteur note-t-il une étape terminée ? 2. Que fait une reprise d'une étape qui a sa ligne ? 3. Quel plantage peut encore répéter un effet ? 4. Que fait une saga quand une étape échoue ? Réponses : dans la table de journal ; elle rejoue son résultat ; un plantage après l'effet et avant sa ligne ; elle annule les étapes terminées, la plus récente d'abord.
Pour les enseignants
Astuce
Cette leçon est un petit exemple de leçon qui se fait dans un lab : les étapes et les boutons Exécuter sont la leçon, et le lab est la copie de chaque élève. Le lab compte deux services, PostgreSQL et un worker Python qui contient un moteur d'une centaine de lignes, et rien ici ne se corrige tout seul : l'élève rend un workflow à lui, une exécution plantée, sa reprise et les lignes du journal. Points clés : 1. Une tâche sans journal refait ses étapes après un plantage. 2. Un journal permet à une nouvelle exécution de rejouer les étapes terminées et de continuer. 3. Une clé d'idempotence ferme la brèche entre un effet et sa ligne. Erreur fréquente : croire que le journal seul donne l'exactement une fois. Matériel : le lab et son terminal. Conseil : demandez aux élèves de prédire quelles lignes diront replay avant chaque reprise. Copiez-la dans votre propre module et modifiez-la, ou construisez-en une de zéro avec le menu Lab de l'éditeur de leçons.