サーバーが途中で落ちたら?
ネットショップがあなたの注文を受けます。在庫を確保し、カードに課金し、領収書をメールし、配送を手配します。課金の直後にサーバーが落ちたらどうなるでしょう。ジョブを最初からやり直すと、2回払うことになります。永続実行は、長いジョブがクラッシュを乗り越える方法です。終わったステップを一つずつ書いておくので、再実行は最初からではなく続きから進みます。
このレッスンが終わると
メモ
終わったステップのジャーナルがあれば、落ちたワークフローが同じステップを2回せずに続けられる理由を説明できます。
キーワード
- ワークフロー:すべてを順に行う必要があるステップでできたジョブ。
- ステップ:ジョブの一部分。たとえばカードへの課金。
- ジャーナル:終わったステップとその結果を書くテーブル。
- リプレイ:ステップをもう一度動かさず、結果をジャーナルから読むこと。
- 冪等性キー:1つの要求の名前。2回行っても1回と同じ効果にするためのもの。
- サガ:後のステップが失敗すると、終わったステップを取り消すワークフロー。
はじめに:もう知っていること
メモ
頭の中で答えましょう。1. データベースのテーブルには何が入っていますか。2. プロセスが止まると、プログラムの変数はどうなりますか。3. お店はなぜ注文ごとに番号を付けるのですか。答え: データの行です。消えます。その注文を見つけて、その注文について話せるようにするためです。
始める前に
メモ
レッスンの上のバーにある ラボを起動 を押し、動いていると表示されるまで待ちます。コンテナーは2つあります。worker が Python を動かし、db が PostgreSQL です。ターミナルは docker exec でそこに届きます。これは、コンテナーの中でコマンドを1つ動かすものです。下の 実行 ボタンは、それぞれのコマンドをラボのターミナルに、同じセッションの中で順番に入力します。様子を見たいときや自分で入力したいときは、バーの ターミナルを開く を押します。
単純なジョブは最初からやり直す
1つ目のコマンドは、ジャーナルのない注文のジョブを動かし、カードに課金した直後に落とします。done の行を2つ出し、落ちた行を出します。2つ目はリトライです。最初から始め、もう一度課金します。3つ目は PostgreSQL に order-1 の支払いをたずねます。2500 の行が2つあります。客は2回払いました。
docker exec worker python3 naive.py order-1 --fresh --crash-after charge_cardここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
docker exec worker python3 naive.py order-1ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
docker exec db psql -U durable -c "SELECT workflow, amount FROM payments WHERE workflow = 'order-1'"ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
ジャーナルは終わったステップを覚える
order.py は同じ注文を、エンジンを使って書いたものです。ステップが終わるたびに、エンジンはステップとその結果を journal テーブルに書きます。このコマンドは、新しいステップ2つのあとで落ちます。するとジャーナルには2行あります。ステップ 0 が reserve_stock、ステップ 1 が charge_card で、それぞれ結果を持っています。
docker exec worker python3 order.py order-7 --fresh --crash-after 2ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
docker exec db psql -U durable -c "SELECT seq, step, result FROM journal WHERE workflow = 'order-7' ORDER BY seq"ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
再開はジャーナルをリプレイして続ける
同じワークフローを、オプションなしでもう一度動かします。ジャーナルの行を2つ見つけるので、ステップ 0 と 1 には replay と出し、結果を行から取ります。本当に動くのはステップ 2 と 3 だけです。課金は1回でした。
docker exec worker python3 order.py order-7ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
確認
ヒント
order.py の2回目の実行が、もう一度課金しなかったのはなぜですか。答え: ステップ 1 の charge_card にはジャーナルの行がもうあったので、エンジンは動かさずに結果をリプレイしたからです。
冪等性キーで繰り返しを無害にする
すき間が一つ残っています。課金のあと、そのジャーナルの行の前に落ちる場合です。1つ目のコマンドは、ちょうどそこで落ちます。再実行には課金の行がないので、もう一度課金します。--keyed を付けると、課金はキー order-9:charge_card を持ち、カード会社はキーごとに支払いを1件だけ取ります。2回目の答えは "repeat": true で、それ以上は何も取られません。
docker exec worker python3 order.py order-9 --fresh --keyed --crash-inside charge_cardここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
docker exec worker python3 order.py order-9 --keyedここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
サガはしたことを取り消す
旅行には、飛行機、ホテル、車が要ります。このコマンドは車で失敗させます。エンジンは失敗も書き、それから補償を新しいものから実行します。cancel_hotel、次に cancel_flight です。最後の行は、何も予約が残っていないと言います。
docker exec worker python3 saga.py trip-2 --fresh --fail-at book_carここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
よくある間違い
注意
ジャーナルがあれば、どの効果もちょうど1回になると思う人が多くいます。そうではありません。効果とそのジャーナルの行のあいだで落ちると、再実行でその効果が繰り返されます。ちょうど1回には両方が要ります。終わったステップをやり直さないためのジャーナルと、繰り返された効果を無視させる冪等性キーです。
最後の確認
ヒント
前に戻らずに答えましょう。1. エンジンは終わったステップをどこに書きますか。2. 再実行は、行のあるステップをどうしますか。3. まだ効果を繰り返しうるのは、どんなクラッシュですか。4. ステップが失敗すると、サガは何をしますか。答え: ジャーナルのテーブルです。結果をリプレイします。効果のあと、その行の前のクラッシュです。終わったステップを新しいものから取り消します。
先生へ
ヒント
このレッスンは、ラボの中で進めるレッスンの小さな見本です。手順と実行ボタンがレッスンで、ラボは生徒ひとりひとりのコピーです。ラボは PostgreSQL と、約100行のエンジンを持つ Python のワーカーの2つのサービスで、自動採点はありません。生徒は自分のワークフロー、落とした実行、その再開、ジャーナルの行を提出します。要点:1. ジャーナルのないジョブは、落ちたあとステップを繰り返す。2. ジャーナルがあれば、再実行は終わったステップをリプレイして続けられる。3. 冪等性キーが、効果とその行のあいだのすき間をふさぐ。よくある間違い:ジャーナルだけでちょうど1回になると思うこと。準備:ラボとそのターミナル。ヒント:再実行の前に毎回、どの行が replay と出るか予想させてください。自分のモジュールにコピーして変更するか、レッスンビルダーのラボメニューから一から作ってください。