graceful shutdown はどのように実装しますか？

Question

Accepted Answer

**graceful shutdown**（グレースフルシャットダウン）とは、終了シグナルを受け取ったときにサーバーをクリーンに停止すること — 処理中のリクエストを完了させ、接続（DB など）を閉じ、リソースを解放すること — を意味し、突然プロセスを終了させてアクティブな処理を破棄することの対極にあります。ゼロダウンタイムのデプロイと信頼性のために不可欠です。

## 突然のシャットダウンが問題になる理由

```text
graceful shutdown がないと、プロセスが kill されたとき（デプロイ、スケールダウン、クラッシュ）：
  ✗ 処理中のリクエストが破棄される → ユーザーにエラーが返る
  ✗ DB トランザクションが未完了のまま残る
  ✗ 接続がクリーンに閉じられない → リーク/ロック
```

デプロイやオートスケーリングの間、プロセスは絶えず停止されます。これをクリーンに行うことが、デプロイをシームレスにします。

## 実装方法

```js
import http from "http";
const server = http.createServer(app);
server.listen(3000);

async function shutdown(signal) {
  console.log(`${signal} received — shutting down gracefully`);

// 1. 新しい接続の受け付けを停止し、既存の接続を完了させる
  server.close(async () => {
    // 2. このコールバックはすべてのアクティブなリクエストが完了したら実行される
    await db.end();            // データベースプールを閉じる
    await redis.quit();        // その他の接続を閉じる
    console.log("clean shutdown complete");
    process.exit(0);           // 正常終了
  });

// 3. セーフティネット：クリーンアップが長くかかりすぎたら強制終了する
  setTimeout(() => {
    console.error("forced shutdown — cleanup timed out");
    process.exit(1);
  }, 10_000).unref();
}

// 終了シグナルをリッスンする
process.on("SIGTERM", () => shutdown("SIGTERM")); // オーケストレータ（k8s, Docker）が送る
process.on("SIGINT", () => shutdown("SIGINT"));   // 開発中の Ctrl+C
```

手順は次の通りです：シグナルを捕捉 → `server.close()`（新しい接続を停止し、既存をドレイン）→ DB/Redis/その他のリソースを閉じる → 終了。**タイムアウトのフォールバック**は何かがハングした場合に強制終了するので、詰まった接続がシャットダウンを永遠にブロックすることはありません。

## シグナル

```text
SIGTERM → デプロイ/スケールダウン時にオーケストレータが送る標準の「終了してください」シグナル
SIGINT  → Ctrl+C（開発）
SIGKILL → 捕捉できない（強制 kill）— graceful shutdown では対処できない
```

## コンテナ環境では

```text
Kubernetes/Docker は SIGTERM を送り、猶予期間（例：30 秒）待ってから SIGKILL を送ります。
アプリはその時間内に完了する必要があります → シャットダウンのタイムアウトはより短く保つこと。
readiness probe で pod を unready にし、ロードバランサーがトラフィックの送信を止めるようにします。
```

## なぜ重要なのか

graceful shutdown は、プロセスが日常的に停止・再起動される現代の（特にコンテナ化/オーケストレーションされた）環境において、**ゼロダウンタイムのデプロイ**と信頼性の高い運用を可能にするものです。

これがないと、すべてのデプロイやスケールダウンがアクティブなリクエストを破棄し、データの不整合のリスクを招きます。

シグナル捕捉 → 受け付け停止 → ドレイン → リソースのクローズ → 終了というシーケンス（タイムアウトのセーフティネット付き）を実装することは、本番対応の Node サービスの証であり、しばしば見落とされがちながら重要な運用上の関心事です。