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

無料レッスン

永続実行の基本

レッスン全体が無料でインタラクティブです。ここで読むことも、「ラボを開始」を押してライブラボで実際に実行することもできます。アカウントは不要です。

コンテナラボ読了目安 15分コマンド9個

サーバーが途中で落ちたら?

ネットショップがあなたの注文を受けます。在庫を確保し、カードに課金し、領収書をメールし、配送を手配します。課金の直後にサーバーが落ちたらどうなるでしょう。ジョブを最初からやり直すと、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 と出るか予想させてください。自分のモジュールにコピーして変更するか、レッスンビルダーのラボメニューから一から作ってください。

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

授業で教えていますか?これらのレッスンを生徒に割り当て、採点と生徒ごとのラボを使えます。