Qu’est-ce qu’une saga dans un workflow ?
Une saga est un workflow dont chaque étape a une compensation, une action qui l’annule. Quand une étape plus loin échoue, la saga exécute les compensations des étapes terminées, la plus récente d’abord.
C’est ainsi qu’une réservation de voyage annule le vol et l’hôtel quand il ne reste plus de voiture. Pourtant, trois entreprises différentes ont pris les réservations.
À la fin de cette leçon
Remarque
Je peux déterminer les compensations qu’une saga en échec doit exécuter.
Mots clés
| Mot | Ce que ça veut dire |
|---|---|
| Transaction | des changements qu’une base fait tous ensemble ou pas du tout |
| Saga | un workflow qui annule ses étapes terminées quand une étape échoue |
| Compensation | une action qui annule une étape |
| La plus récente d’abord | l’inverse de l’ordre où les étapes ont tourné |
| Irréversible | impossible à annuler, comme un e-mail déjà envoyé |
Les cellules que les étudiants remplissent restent vides dans cet aperçu.
Une transaction ne couvre pas trois entreprises
Dans une seule base de données, une transaction fait plusieurs changements tous ensemble ou pas du tout. Un voyage se réserve auprès d’une compagnie aérienne, d’un hôtel et d’un loueur de voitures. Chacun a son propre système, et aucun ne rejoindra une transaction avec les autres.
Chaque réservation est donc une étape séparée, qui a vraiment lieu. Si la voiture échoue, le vol et l’hôtel sont déjà réservés, et il faut les annuler.
Réserver un voyage complet
docker exec worker python3 saga.py trip-1 --freshAffichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.
Réserver un voyage dont la voiture échoue
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.
Lire les réservations de trip-2
docker exec db psql -U durable -c "SELECT item, status FROM bookings WHERE workflow = 'trip-2' ORDER BY id"Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.
Les compensations sont aussi des étapes
Le moteur écrit l’étape en échec dans le journal, avec sa raison. Chaque compensation est une étape ordinaire, avec sa propre ligne.
Un plantage pendant l’annulation est donc sans danger. Les Runs suivants plantent trip-3 juste après l’échec de la voiture. La reprise rejoue les trois lignes, voit l’échec et exécute les deux compensations. Une compensation n’est jamais oubliée à mi-chemin.
Planter juste après l’échec de la voiture
docker exec worker python3 saga.py trip-3 --fresh --fail-at book_car --crash-after 3Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.
Reprendre trip-3 jusqu’aux compensations
docker exec worker python3 saga.py trip-3 --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.
Exemple guidé : le journal de trip-3
| Seq | Étape | Résultat | Écrite à l’exécution |
|---|---|---|---|
| 0 | book_flight | vol réservé | 1 |
| 1 | book_hotel | hôtel réservé | 1 |
| 2 | book_car | échec : plus de voiture | 1 |
| 3 | cancel_hotel | hôtel annulé | 2 |
| 4 | cancel_flight | vol annulé | 2 |
Les cellules que les étudiants remplissent restent vides dans cet aperçu.
Une erreur fréquente
Attention
Beaucoup pensent qu’une compensation remet le monde exactement comme avant. Elle ne peut pas retirer un e-mail ni effacer un billet imprimé. Une compensation est une nouvelle action, comme un remboursement ou des excuses, et certaines étapes n’en ont aucune. Placez celles-là en dernier.
À vous : une étape sans annulation
ETAPES = [["book_flight", "cancel_flight"],
["book_hotel", "cancel_hotel"],
["send_ticket", None], # un e-mail ne se retire pas
["book_car", "cancel_car"]]
ECHOUE = "book_car"
faites = []
for paire in ETAPES:
if paire[0] == ECHOUE:
print(paire[0], ": échec")
break
print(paire[0], ": ok")
faites.append(paire)
faites.reverse() # la plus récente d’abord
for paire in faites:
if paire[1] is None:
print("rien pour annuler", paire[0])
else:
print("compenser :", paire[1])
# Mettez ECHOUE = "book_hotel" et relancez.