7.6.3 未決着トランザクション待機スクリプト（wait_transactions.sh）
Orchestrator-Service、Entity-Service(SQL)、Entity-Service(TCC)、Orchestrator-Service(SQL)、Alternate-Service、Alternate-Service(SQL)、Mediator、およびTP1-Bridgeがスケールインなどによってシャットダウンする際に、未決着トランザクションがなくなるまで待機するスクリプトです。各KubernetesアプリケーションのpreStopフックで使用します。
＜コマンド処理内容＞
このコマンド開始直後に20秒間待機します。これは、KubernetesがPod終了開始直後に実施する「Serviceのリクエスト転送先リストからのPodの宛先の削除」が完了するのを待つためです。これによって、このコマンドが後続で未決着トランザクションの待機処理を開始するまでに、新規トランザクション処理のリクエストの流入がない状態にできます。
そのあと、未決着トランザクションの有無を判定するために、localhostに対してコマンド引数で指定されたHTTPポート番号の「グレースフルシャットダウン確認API（/hmppcto/graceful）」へGETリクエストを実行し、JSONレスポンスに含まれる「グレースフルシャットダウンできるかを表す値（"status"キー）」の値が「true」の場合は、ステータスコード「0」で正常終了します。
一方、値が「false」の場合は、コマンド引数で指定されたリトライ回数・リトライ間隔秒数でリトライします。最大リトライ回数を超えた場合は、ステータスコード「1」で異常終了します。
preStopフックが正常終了した場合および異常終了した場合のどちらの場合も、Podは削除されます。
＜コマンド構文＞
wait_transactions.sh△<リトライ回数>△<リトライ間隔秒数>△<接続タイムアウト秒数>△<応答タイムアウト秒数> △<HTTPポート番号>[△<コンテキストパス>]
- （凡例）
-
△：半角スペース1文字
＜実行例＞
wait_transactions.sh 30 10 10 10 20555
＜実行例（コンテキストパス指定時）＞
wait_transactions.sh 30 10 10 10 20555 /path
＜コマンド引数チェック仕様＞
次の記条件をどちらか1つでも満たしていない場合は、KFSG62101-Eメッセージを出力し、ステータスコード「1」で異常終了します。
-
コマンド引数の数が「5 以上」である
-
第1引数〜第5引数の値が「整数値」である
＜バージョン表示オプション＞
次のようにコマンドに「--version」オプションを指定して実行すると、該当するスクリプト名およびバージョン番号を表示して終了します。
wait_transactions.sh△--version
- （凡例）
-
△：半角スペース1文字
＜コマンドの実行結果＞
wait_transactions.sh△V.R.S
- （凡例）
-
△：半角スペース1文字
V.R.S：バージョン番号
＜コマンドの実行結果の例＞
wait_transactions.sh 1.0.0