Wie übersteht ein Workflow einen Absturz?
Dauerhafte Ausführung schreibt jeden fertigen Schritt eines Workflows in ein Journal, damit ein neuer Lauf nach einem Absturz weitermachen kann. Das Journal ist eine Tabelle in einer Datenbank und überlebt den Prozess.
Bei einem neuen Lauf wird ein Schritt mit Zeile aus ihr abgespielt und nicht noch einmal ausgeführt. Die Arbeit beginnt beim ersten Schritt ohne Zeile. Die Engine im Labor schafft das in etwa hundert Zeilen.
Am Ende dieser Lektion
Notiz
Ich kann mit einem Schritt-Journal herausfinden, wo ein abgestürzter Workflow weitermachen soll.
Schlüsselwörter
| Begriff | Was er bedeutet |
|---|---|
| Workflow | ein Job, dessen Schritte alle geschehen müssen, der Reihe nach |
| Journal | eine Tabelle mit jedem fertigen Schritt und seinem Ergebnis |
| Schrittnummer | der Platz eines Schritts im Workflow, ab 0 gezählt |
| Replay | das Ergebnis eines Schritts aus dem Journal nehmen, statt ihn auszuführen |
| Fortsetzen | einen abgestürzten Workflow neu starten, damit er weitermacht |
Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.
Die Engine schreibt jedes Ergebnis zuerst auf
Im Labor ist ein Workflow gewöhnliches Python. Jeder Schritt ist ein Aufruf von wf.step mit einem Namen und einer Funktion. Die Engine gibt jedem Schritt eine Schrittnummer: 0 für den ersten, 1 für den nächsten.
Ist ein Schritt fertig, fügt die Engine eine Zeile in die Tabelle journal ein: Workflow, Nummer, Name und Ergebnis. Erst danach geht der Workflow weiter.
Den Bestell-Workflow nach zwei Schritten abstürzen lassen
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.
Die Journalzeilen von order-7 lesen
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.
Beim Fortsetzen werden gefundene Zeilen abgespielt
Starten Sie nun denselben Workflow ohne Optionen. Die Engine liest zuerst das Journal und findet zwei Zeilen.
Die Schritte 0 und 1 geben replay aus: Ihre Ergebnisse kommen aus den Zeilen, also wird nichts noch einmal reserviert oder abgebucht. Die Schritte 2 und 3 haben keine Zeilen und geben run aus. Ein weiterer Lauf spielt alle vier ab und tut nichts Neues.
order-7 fortsetzen
docker exec worker python3 order.py order-7Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
order-7 noch einmal fortsetzen
docker exec worker python3 order.py order-7Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Beispiel: drei Läufe von order-7
| Lauf | Gefundene Zeilen | Abgespielt | Ausgeführt |
|---|---|---|---|
| 1, Absturz nach 2 | 0 | keine | 0 und 1 |
| 2, Fortsetzen | 2 | 0 und 1 | 2 und 3 |
| 3, noch einmal fortsetzen | 4 | 0 bis 3 | keine |
Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.
Ein häufiger Fehler
Warnung
Viele glauben, das Fortsetzen springe direkt zum gescheiterten Schritt. Es führt den ganzen Workflow wieder von oben aus, und die Engine beantwortet jeden fertigen Schritt aus dem Journal. Code außerhalb eines Schritts läuft also jedes Mal: Legen Sie jeden Seiteneffekt in einen Schritt.
Probieren Sie es: ein Journal im Dictionary
journal = {} # im Labor ist das eine Tabelle in PostgreSQL
def schritt(nr, name, arbeit):
if nr in journal:
print("replay", nr, name, journal[nr])
return journal[nr]
ergebnis = arbeit()
journal[nr] = ergebnis # aufgeschrieben, bevor es weitergeht
print("run ", nr, name, ergebnis)
return ergebnis
def bestellung(absturz_nach):
schritt(0, "reserve_stock", lambda: "2 reserviert")
schritt(1, "charge_card", lambda: "2500 abgebucht")
if absturz_nach == 2:
print("Absturz")
return
schritt(2, "send_receipt", lambda: "gemailt")
bestellung(absturz_nach=2) # der erste Lauf stirbt nach zwei Schritten
bestellung(absturz_nach=0) # der neue Lauf spielt zwei ab und führt einen aus
# Ändern Sie den ersten Aufruf in absturz_nach=0 und vergleichen Sie.
Der Code muss dieselben Schritte verlangen
Replay funktioniert nur, wenn der Code bei jedem Lauf dieselben Schritte in derselben Reihenfolge verlangt. Die Engine im Labor vergleicht den Namen jedes Schritts mit seiner Zeile und hält an, wenn sie sich unterscheiden.
Ein Workflow darf also nicht nach Dingen entscheiden, die sich zwischen Läufen ändern, etwa der Uhrzeit oder einer Zufallszahl. Machen Sie einen solchen Wert zu einem Schritt, dann wird sein Ergebnis wie jedes andere aufbewahrt.