どの永続実行エンジンを使うか
Temporal、Restate、DBOS、AWS Lambda durable functions は永続実行エンジンです。ラボの100行がすることを、たくさんのワークフローに対して一度に行います。どれもジャーナルを持ち、それをリプレイします。
違うのは、ジャーナルの置き場所と、プログラムからの届き方です。どれも使わないのが正解のこともあります。
このレッスンが終わると
メモ
ある仕事に、永続実行エンジンと、もっと単純な道具のどちらを使うか選べる。
キーワード
| ことば | いみ |
|---|---|
| エンジン | ワークフローを動かし、そのジャーナルを持つソフトウェア |
| ライブラリ | 自分のプログラムに取り込むコード |
| サーバー | 自分のコードが話しかける別のプログラム |
| アクティビティ | Temporal での、副作用のあるステップの呼び名 |
| 決定的 | 動かすたびに同じ選択をすること |
学生が入力するセルは、このプレビューでは空白です。
どのエンジンもジャーナルをリプレイする
ラボのエンジンは2つのファイルです。PostgreSQL のクライアントと、エンジンそのものです。考え方はすべて入っています。ステップは1回だけ動き、結果を書き、再実行はそれをリプレイします。
本物のエンジンは、ラボにないものを加えます。たくさんのワーカーが仕事を分け、キューが仕事を配り、タイマーはひとりでに起きます。コードを変えるための道具と、全体を見る Web ページもあります。
ラボのエンジンの行数を数える
docker exec worker wc -l pg.py engine.pyここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
例:ジャーナルの置き場所
| エンジン | ジャーナルの置き場所 | コードからの届き方 |
|---|---|---|
| Temporal | Temporal サービス自身のデータベース | ワーカーがタスクキューに仕事をたずねる |
| Restate | Restate サーバーのログ | サーバーがハンドラーを呼ぶ |
| DBOS | 自分の PostgreSQL | プログラムの中のライブラリ |
| AWS Lambda durable functions | AWS が関数ごとに持つ | 関数のコードの中のステップと待ち |
| このラボ | 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ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
よくある間違い
注意
途中の実行があるのに、ワークフローのコードを変える人が多くいます。その実行は新しいコードに対してジャーナルをリプレイし、ステップの順が変わると合わなくなります。コードはバージョンの確認つきで変えるか、古い実行を先に終わらせましょう。
試そう:安全な変更はどれか
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ステップ、繰り返しても安全 | 単純なリトライ |
| 新しい注文を注文番号をキーに倉庫へ送る | 繰り返しても害がない | リトライつきのキュー |
| 注文を受け、課金し、在庫を何日も待ち、失敗なら返金する | ステップ、長い待ち、取り消し | 永続実行エンジン |
学生が入力するセルは、このプレビューでは空白です。