クリーム色の背景、色付き表示、高コントラスト、大きな文字のほうが読みやすいですか?配色と文字を選ぶと、すべてのページに一度で反映されます。

無料レッスン

永続実行エンジンの選び方

このレッスンのあとで: ある仕事に、永続実行エンジンと、もっと単純な道具のどちらを使うか選べる。

60分のレッスンコマンド3件永続実行ラボ:ワークフローをわざと落とし、ジャーナルから再開する

どの永続実行エンジンを使うか

Temporal、Restate、DBOS、AWS Lambda durable functions は永続実行エンジンです。ラボの100行がすることを、たくさんのワークフローに対して一度に行います。どれもジャーナルを持ち、それをリプレイします。

違うのは、ジャーナルの置き場所と、プログラムからの届き方です。どれも使わないのが正解のこともあります。

このレッスンが終わると

メモ

ある仕事に、永続実行エンジンと、もっと単純な道具のどちらを使うか選べる。

キーワード

ことばいみ
エンジンワークフローを動かし、そのジャーナルを持つソフトウェア
ライブラリ自分のプログラムに取り込むコード
サーバー自分のコードが話しかける別のプログラム
アクティビティTemporal での、副作用のあるステップの呼び名
決定的動かすたびに同じ選択をすること

学生が入力するセルは、このプレビューでは空白です。

どのエンジンもジャーナルをリプレイする

ラボのエンジンは2つのファイルです。PostgreSQL のクライアントと、エンジンそのものです。考え方はすべて入っています。ステップは1回だけ動き、結果を書き、再実行はそれをリプレイします。

本物のエンジンは、ラボにないものを加えます。たくさんのワーカーが仕事を分け、キューが仕事を配り、タイマーはひとりでに起きます。コードを変えるための道具と、全体を見る Web ページもあります。

ラボのエンジンの行数を数える

コマンド
docker exec worker wc -l pg.py engine.py

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

例:ジャーナルの置き場所

エンジンジャーナルの置き場所コードからの届き方
TemporalTemporal サービス自身のデータベースワーカーがタスクキューに仕事をたずねる
RestateRestate サーバーのログサーバーがハンドラーを呼ぶ
DBOS自分の PostgreSQLプログラムの中のライブラリ
AWS Lambda durable functionsAWS が関数ごとに持つ関数のコードの中のステップと待ち
このラボPostgreSQL のジャーナルのテーブルライブラリ、engine.py

学生が入力するセルは、このプレビューでは空白です。

ワークフローのコードは決定的に

Temporal はプログラムを2つに分けます。ワークフローのコードは次に何をするかを決め、決定的でなければなりません。アクティビティは、カードへの課金のような副作用のある仕事をします。

理由はリプレイです。再開はワークフローのコードをもう一度動かし、各ステップをジャーナルと合わせます。次の Run は注文を落とし、領収書を先に送るように変えたバージョンのコードで再開します。

バージョン1で注文を落とす

コマンド
docker exec worker python3 order.py order-10 --fresh --crash-after 2

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

バージョン2で再開する

コマンド
docker exec worker python3 order.py order-10 --v2

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

よくある間違い

注意

途中の実行があるのに、ワークフローのコードを変える人が多くいます。その実行は新しいコードに対してジャーナルをリプレイし、ステップの順が変わると合わなくなります。コードはバージョンの確認つきで変えるか、古い実行を先に終わらせましょう。

試そう:安全な変更はどれか

コード: python
journal = ["reserve_stock", "charge_card"]   # バージョン 1 が書いた

version_1 = ["reserve_stock", "charge_card", "send_receipt", "book_courier"]
version_2 = ["reserve_stock", "send_receipt", "charge_card", "book_courier"]

def check(code):
    for seq in range(len(journal)):
        if journal[seq] != code[seq]:
            return "ステップ " + str(seq) + " で止まる"
    return "リプレイし、ステップ " + str(len(journal)) + " から続ける"

print("バージョン 1:", check(version_1))
print("バージョン 2:", check(version_2))
# version_2 を、最後に新しいステップを足す形に変えて、もう一度実行しましょう。

エンジンが要らないとき

エンジンは、動かし、学び、コードと合わせておくものが一つ増えることです。繰り返しても安全な1ステップの仕事には、単純なリトライで足ります。

効果がすべて冪等な仕事は、少なくとも1回届けるキューに置けます。エンジンを使うのは、効果のあるステップがいくつもあるとき、何時間や何日も待つとき、したことを取り消す必要があるときです。

例:3つの仕事、3つの道具

仕事必要なこと合う道具
アップロードされた写真を1枚縮小する1ステップ、繰り返しても安全単純なリトライ
新しい注文を注文番号をキーに倉庫へ送る繰り返しても害がないリトライつきのキュー
注文を受け、課金し、在庫を何日も待ち、失敗なら返金するステップ、長い待ち、取り消し永続実行エンジン

学生が入力するセルは、このプレビューでは空白です。

このラボとソースについて: 永続実行ラボ:ワークフローをわざと落とし、ジャーナルから再開する

授業で使いますか?このモジュールを学生に割り当てると、教員用ガイド、自動採点つきの課題、学生ごとのラボを使えます。