Plus facile à lire avec un fond crème, une teinte, plus de contraste ou un texte plus grand ? Choisissez vos couleurs et votre texte, une fois pour toutes les pages.

Leçon gratuite

Quand une tâche plante en cours de route

Après cette leçon: Je peux expliquer ce qui se passe quand un processus meurt au milieu d’une tâche.

Leçon de 60 min4 commandesLab d’exécution durable : planter un workflow exprès et le reprendre depuis son journal

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

MotCe que ça veut dire
Processusun programme en cours d’exécution, avec sa propre mémoire
Plantagel’arrêt d’un processus, sans prévenir
Effet de bordun changement hors du programme, comme un paiement
Nouvelle tentativerelancer une tâche après son échec
Tâcheun 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

Commande
docker exec worker ls

Affiché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

Commande
docker exec worker python3 naive.py order-1 --fresh --crash-after charge_card

Affiché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

Commande
docker exec worker python3 naive.py 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.

Compter les paiements de order-1

Commande
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éesPaiements à ce stade
1, plantéereserve_stock, charge_card1 de 2500
2, la relanceles quatre étapes2 de 2500
Ce que voulait le clientles quatre étapes, une fois1 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

Code: python
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.

À propos de ce labo et de sa source: Lab d’exécution durable : planter un workflow exprès et le reprendre depuis son journal

Vous enseignez à une classe ? Proposez ce module à vos étudiants avec un guide de l'enseignant, des devoirs corrigés et un laboratoire pour chaque étudiant.