本文へ移動
Senri

止め方(graceful shutdown)

SIGTERM を受けたら、処理中のリクエストを待ってから止まる

import {  } from "@senrijs/senri/serve";

await (, {
    : 30_000,     // 処理中のリクエストを、30 秒まで待つ
    : () => .(),
});

serve() は SIGTERM・SIGINT を受けると、次の順に止まります。

  1. health() の /readyz を 503 にする(ロードバランサーが、新しいリクエストを送ってこないように)
  2. 新しい接続を受けるのをやめ、処理中のリクエストが終わるのを待つ(shutdownTimeout、既定 10 秒。過ぎたら残りの接続を切る)
  3. onShutdown を呼んでから、プロセスを終える

待っている間にもう一度シグナルを受けたら、すぐに終わります(Ctrl+C を 2 回押したときなど)。

自分で止める

server.stop() は、同じ手順(1 と 2)で止めます。テストの後片付けなどに使います。

import {  } from "@senrijs/senri/serve";

const  = await (, { : 0 });
// ...
await .();

止め方を任せない

ランタイムの既定どおりにしたいときは、gracefulShutdown: false にします。シグナルを受けても、serve() は何もしません。

  • Deno には、待つのをやめたあとに残りの接続を切る方法がありません。shutdownTimeout を過ぎると待つのをやめ、プロセスが終わるときに接続も切れます

このページの内容