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

Les sagas et la compensation

Après cette leçon: Je peux déterminer les compensations qu’une saga en échec doit exécuter.

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

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

MotCe que ça veut dire
Transactiondes changements qu’une base fait tous ensemble ou pas du tout
Sagaun workflow qui annule ses étapes terminées quand une étape échoue
Compensationune action qui annule une étape
La plus récente d’abordl’inverse de l’ordre où les étapes ont tourné
Irréversibleimpossible à 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

Commande
docker exec worker python3 saga.py trip-1 --fresh

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

Commande
docker exec worker python3 saga.py trip-2 --fresh --fail-at book_car

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

Commande
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

Commande
docker exec worker python3 saga.py trip-3 --fresh --fail-at book_car --crash-after 3

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

Commande
docker exec worker python3 saga.py trip-3 --fail-at book_car

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é : le journal de trip-3

SeqÉtapeRésultatÉcrite à l’exécution
0book_flightvol réservé1
1book_hotelhôtel réservé1
2book_caréchec : plus de voiture1
3cancel_hotelhôtel annulé2
4cancel_flightvol 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

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

À 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.