Lässt es sich mit cremefarbenem Papier, einer Tönung, mehr Kontrast oder größerer Schrift besser lesen? Wählen Sie Ihre Farben und Ihre Schrift, einmalig für alle Seiten.

Kostenlose Lektion

Ein Schritt-Journal und Replay

Nach dieser Lektion: Ich kann mit einem Schritt-Journal herausfinden, wo ein abgestürzter Workflow weitermachen soll.

Lektion, 60 Min.4 BefehleLab zur dauerhaften Ausführung: einen Workflow absichtlich abstürzen lassen und aus seinem Journal fortsetzen

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

BegriffWas er bedeutet
Workflowein Job, dessen Schritte alle geschehen müssen, der Reihe nach
Journaleine Tabelle mit jedem fertigen Schritt und seinem Ergebnis
Schrittnummerder Platz eines Schritts im Workflow, ab 0 gezählt
Replaydas Ergebnis eines Schritts aus dem Journal nehmen, statt ihn auszuführen
Fortsetzeneinen 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

Befehl
docker exec worker python3 order.py order-7 --fresh --crash-after 2

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Die Journalzeilen von order-7 lesen

Befehl
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

Befehl
docker exec worker python3 order.py order-7

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

order-7 noch einmal fortsetzen

Befehl
docker exec worker python3 order.py order-7

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Beispiel: drei Läufe von order-7

LaufGefundene ZeilenAbgespieltAusgeführt
1, Absturz nach 20keine0 und 1
2, Fortsetzen20 und 12 und 3
3, noch einmal fortsetzen40 bis 3keine

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

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

Über dieses Lab und seinen Quellcode: Lab zur dauerhaften Ausführung: einen Workflow absichtlich abstürzen lassen und aus seinem Journal fortsetzen

Sie unterrichten eine Gruppe? Weisen Sie dieses Modul Ihren Studierenden zu, mit Handbuch für Lehrende, automatisch geprüften Aufgaben und einem Lab für jede Person.