Pourquoi le client a-t-il payé deux fois ?
Une tâche longue est un programme qui enchaîne plusieurs étapes, comme la prise d’une commande dans une boutique en ligne. Si son processus meurt en route, une simple relance repart du début. Elle refait alors les étapes déjà faites.
C’est ainsi qu’un client est débité deux fois. Ce module construit la solution pas à pas : l’exécution durable, l’idée qui fait tourner les moteurs de workflow.
À la fin de cette leçon
Remarque
Je peux expliquer ce qui se passe quand un processus meurt au milieu d’une tâche.
Mots clés
| Mot | Ce que ça veut dire |
|---|---|
| Processus | un programme en cours d’exécution, avec sa propre mémoire |
| Plantage | l’arrêt d’un processus, sans prévenir |
| Effet de bord | un changement hors du programme, comme un paiement |
| Nouvelle tentative | relancer une tâche après son échec |
| Tâche | un travail qu’un programme fait en plusieurs étapes |
Les cellules que les étudiants remplissent restent vides dans cet aperçu.
Une tâche : des étapes à effets
La boutique du labo prend une commande en quatre étapes : réserver le stock, débiter la carte, envoyer un reçu par e-mail et réserver un coursier. La plupart changent quelque chose hors du programme. Ces changements sont des effets de bord.
La mémoire d’un programme disparaît quand son processus meurt. Un effet de bord, lui, reste. Une fois la carte débitée, l’argent a quitté le compte du client, quoi que le programme oublie.
Lister les fichiers du labo
docker exec worker lsAffichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.
Lancer la tâche simple et la planter
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.
Une simple relance repart du début
Le premier Run a affiché deux lignes done, reserve_stock et charge_card, puis la ligne du plantage. Le processus s’est arrêté là, avec le code de sortie 3.
Le Run suivant est la relance. La tâche ne garde aucune trace de ce qu’elle a fait, donc elle repart du début. Elle réserve, débite, envoie le reçu et réserve le coursier. Une requête demande ensuite à PostgreSQL combien de paiements a order-1.
Relancer la tâche simple
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.
Compter les paiements de order-1
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.
Exemple guidé : ce qu’a fait chaque exécution
| Exécution | Étapes terminées | Paiements à ce stade |
|---|---|---|
| 1, plantée | reserve_stock, charge_card | 1 de 2500 |
| 2, la relance | les quatre étapes | 2 de 2500 |
| Ce que voulait le client | les quatre étapes, une fois | 1 de 2500 |
Les cellules que les étudiants remplissent restent vides dans cet aperçu.
Une erreur fréquente
Attention
Beaucoup pensent qu’une relance est toujours sans danger puisque la tâche a échoué. Elle ne l’est que si chaque étape peut tourner deux fois sans dégât. Débiter une carte ne le peut pas : la relance a donc débité le client une deuxième fois.
À vous : déplacez le plantage
ETAPES = ["reserve_stock", "charge_card", "send_receipt", "book_courier"]
EFFETS = ["charge_card", "send_receipt"]
PLANTE_APRES = 2 # la première exécution meurt après ce nombre d’étapes
faites = []
# Première exécution : elle plante en route.
for nom in ETAPES[:PLANTE_APRES]:
faites.append(nom)
# La nouvelle tentative repart du début et va au bout.
for nom in ETAPES:
faites.append(nom)
for nom in EFFETS:
print(nom, ":", faites.count(nom), "fois")
# Mettez PLANTE_APRES à 3, puis à 0, et relancez.
L’endroit du plantage fait les dégâts
Un plantage avant tout effet de bord ne coûte rien : la relance fait le travail une fois. Un plantage après le débit refait le débit. Un plantage après le reçu refait le débit et l’e-mail.
Vous ne choisissez pas où tombe un plantage. Une coupure de courant, un serveur remplacé, un déploiement qui redémarre le processus. La tâche doit donc se souvenir elle-même de ce qu’elle a fait. La leçon 2 lui donne une mémoire qui survit au processus.