無停止で入れ替える — そして期末の切り分け

設定を変えたあと、それを反映させる操作は「再起動」と呼ばれがちです。しかし実際に起きているのは入れ替えです。

新しい設定のワーカーが立ち上がり、古いワーカーは処理中の接続を捌き切ってから終了します。処理中のリクエストが一律に切られる再起動とは、ここが違います。公式によれば、古いワーカーは listen ソケットを閉じ、既存のクライアントを捌き終えてから終了します。上限は worker_shutdown_timeout(1.11.11〜)で決められますが既定値は無く、長い接続があれば古いワーカーは残ります。

この違いは言葉の綾ではなく、切り分けに直結します。反映の途中では、新旧の設定が同居するからです。「設定を変えたのに古い挙動が見える」は、異常とは限りません。入れ替えが終わっていないだけ、という正常な経過でも同じ症状になります。ここで反射的に再起動をかけると、切れないはずの接続を自分で切ることになります。