Was, wenn der Server mittendrin ausfällt?
Ein Onlineshop nimmt deine Bestellung an: Er reserviert die Ware, belastet deine Karte, mailt dir einen Beleg und bucht einen Kurier. Was, wenn der Server direkt nach der Abbuchung ausfällt? Startest du den Job wieder von vorn, zahlst du doppelt. Dauerhafte Ausführung lässt lange Jobs einen Absturz überstehen: Jeder fertige Schritt wird aufgeschrieben, und ein neuer Lauf macht weiter, statt neu anzufangen.
Am Ende dieser Lektion
Notiz
Ich kann erklären, wie ein Journal der fertigen Schritte einen abgestürzten Workflow weitermachen lässt, ohne einen Schritt zweimal auszuführen.
Schlüsselwörter
- Workflow: ein Job aus Schritten, die alle geschehen müssen, der Reihe nach.
- Schritt: ein Teil des Jobs, etwa eine Karte belasten.
- Journal: eine Tabelle, in die jeder fertige Schritt mit seinem Ergebnis geschrieben wird.
- Replay (Abspielen): das Ergebnis eines Schritts aus dem Journal lesen, statt ihn noch einmal auszuführen.
- Idempotenzschlüssel: ein Name für eine Anfrage, damit sie zweimal ausgeführt dieselbe Wirkung hat wie einmal.
- Saga: ein Workflow, der seine fertigen Schritte rückgängig macht, wenn ein späterer scheitert.
Zum Einstieg: was du schon weißt
Notiz
Antworte im Kopf. 1. Was steht in einer Datenbanktabelle? 2. Was passiert mit den Variablen eines Programms, wenn sein Prozess stoppt? 3. Warum gibt ein Shop jeder Bestellung eine Nummer? Antworten: Zeilen mit Daten; sie gehen verloren; damit er genau diese eine Bestellung finden und über sie sprechen kann.
Bevor du anfängst
Notiz
Klicke oben in der Leiste dieser Lektion auf Lab starten und warte, bis dort steht, dass es läuft. Es gibt zwei Container. worker führt das Python aus, und db ist PostgreSQL. Das Terminal erreicht sie mit docker exec, das einen Befehl in einem Container ausführt. Jede Schaltfläche Ausführen unten tippt ihren Befehl ins Terminal deines Labs, einen nach dem anderen in derselben Sitzung. Wenn du zuschauen oder eigene Befehle tippen willst, klicke in der Leiste auf Terminal öffnen (neuer Tab).
Ein einfacher Job beginnt wieder von vorn
Der erste Befehl startet den Bestell-Job ohne Journal und lässt ihn direkt nach der Abbuchung abstürzen. Er gibt zwei done-Zeilen und dann die Absturzzeile aus. Der zweite ist der neue Versuch: Er beginnt wieder oben und bucht noch einmal ab. Der dritte fragt PostgreSQL nach den Zahlungen von order-1, und es sind 2 Zeilen mit 2500. Die Kundin hat doppelt bezahlt.
docker exec worker python3 naive.py order-1 --fresh --crash-after charge_cardHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
docker exec worker python3 naive.py order-1Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
docker exec db psql -U durable -c "SELECT workflow, amount FROM payments WHERE workflow = 'order-1'"Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Ein Journal merkt sich jeden fertigen Schritt
order.py ist dieselbe Bestellung, mit der Engine geschrieben. Nach jedem Schritt schreibt die Engine den Schritt und sein Ergebnis in die Tabelle journal. Dieser Befehl stürzt nach 2 neuen Schritten ab. Das Journal hat dann 2 Zeilen: Schritt 0 ist reserve_stock und Schritt 1 ist charge_card, jeder mit seinem Ergebnis.
docker exec worker python3 order.py order-7 --fresh --crash-after 2Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
docker exec db psql -U durable -c "SELECT seq, step, result FROM journal WHERE workflow = 'order-7' ORDER BY seq"Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Fortsetzen spielt das Journal ab und macht weiter
Starte denselben Workflow noch einmal, ohne Optionen. Er findet 2 Zeilen im Journal, also gibt er für die Schritte 0 und 1 replay aus und nimmt ihre Ergebnisse aus den Zeilen. Nur die Schritte 2 und 3 laufen wirklich. Die Karte wurde einmal belastet.
docker exec worker python3 order.py order-7Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Kontrolle
Tipp
Warum hat der zweite Lauf von order.py die Karte nicht noch einmal belastet? Antwort: Schritt 1, charge_card, hatte schon eine Zeile im Journal, also hat die Engine sein Ergebnis abgespielt, statt ihn auszuführen.
Ein Idempotenzschlüssel macht eine Wiederholung harmlos
Eine Lücke bleibt: ein Absturz nach der Abbuchung, aber vor ihrer Journalzeile. Der erste Befehl stürzt genau dort ab. Der neue Lauf hat keine Zeile für die Abbuchung, also bucht er noch einmal ab. Mit --keyed trägt die Abbuchung den Schlüssel order-9:charge_card, und der Kartenanbieter nimmt pro Schlüssel nur eine Zahlung: Die zweite Antwort sagt "repeat": true, und es wird nichts mehr genommen.
docker exec worker python3 order.py order-9 --fresh --keyed --crash-inside charge_cardHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
docker exec worker python3 order.py order-9 --keyedHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Eine Saga macht rückgängig, was getan wurde
Eine Reise braucht einen Flug, ein Hotel und einen Mietwagen. Dieser Befehl lässt den Mietwagen scheitern. Die Engine schreibt auch den Fehlschlag auf und führt dann die Kompensationen aus, die neueste zuerst: cancel_hotel, dann cancel_flight. Die letzte Zeile sagt, dass nichts mehr gebucht ist.
docker exec worker python3 saga.py trip-2 --fresh --fail-at book_carHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Ein häufiger Fehler
Warnung
Viele denken, ein Journal allein sorge dafür, dass jeder Effekt genau einmal geschieht. Das stimmt nicht: Ein Absturz zwischen einem Effekt und seiner Journalzeile wiederholt diesen Effekt beim neuen Lauf. Genau einmal braucht beide Hälften: das Journal, damit fertige Schritte nicht wiederholt werden, und einen Idempotenzschlüssel, damit ein wiederholter Effekt ignoriert wird.
Abschlusskontrolle
Tipp
Antworte, ohne zurückzublättern. 1. Wohin schreibt die Engine einen fertigen Schritt? 2. Was macht ein neuer Lauf mit einem Schritt, der eine Zeile hat? 3. Welcher Absturz kann einen Effekt trotzdem wiederholen? 4. Was macht eine Saga, wenn ein Schritt scheitert? Antworten: in die Journaltabelle; er spielt sein Ergebnis ab; einer nach dem Effekt und vor seiner Zeile; sie macht die fertigen Schritte rückgängig, den neuesten zuerst.
Für Lehrkräfte
Tipp
Diese Lektion ist ein kleines Beispiel für eine Lektion, die in einem Lab durchgeführt wird: Die Schritte und die Schaltflächen „Ausführen“ sind die Lektion, und das Lab ist die eigene Kopie jeder lernenden Person. Das Lab besteht aus zwei Diensten, PostgreSQL und einem Python-Worker mit einer Engine von etwa hundert Zeilen, und nichts hier bewertet sich selbst: Die lernende Person gibt einen eigenen Workflow ab, einen abgestürzten Lauf, sein Fortsetzen und die Journalzeilen. Wichtigste Lernpunkte: 1. Ein Job ohne Journal wiederholt nach einem Absturz seine Schritte. 2. Mit einem Journal spielt ein neuer Lauf fertige Schritte ab und macht weiter. 3. Ein Idempotenzschlüssel schließt die Lücke zwischen einem Effekt und seiner Zeile. Häufiger Fehler: zu glauben, das Journal allein liefere genau einmal. Material: das Lab und sein Terminal. Tipp: Lassen Sie die Lernenden vor jedem neuen Lauf vorhersagen, welche Zeilen replay sagen werden. Kopieren Sie die Lektion in Ihr eigenes Modul und ändern Sie sie, oder bauen Sie im Lektionseditor über das Menü Lab eine neue von Grund auf.