re:re:actable
Урок 011 минута чтения

Что такое graceful shutdown?

На этой странице
Кратко

Graceful shutdown - корректное завершение приложения: перестать принимать новые запросы, дождаться текущих, закрыть соединения с БД, остановить очереди и завершить процесс с правильным кодом.

Вопрос

Что такое graceful shutdown и как его реализовать в Node.js?

Почему это важно?

В production процесс может получить сигнал завершения:

  • при деплое;
  • при рестарте контейнера;
  • при autoscaling;
  • при ручной остановке;
  • при падении health check.

Если завершить процесс резко, можно оборвать запросы и потерять данные.

Пример для HTTP-сервера

import http from 'node:http';
 
const server = http.createServer((req, res) => {
  res.end('ok');
});
 
server.listen(3000);
 
process.on('SIGTERM', () => {
  server.close(() => {
    console.log('HTTP server closed');
    process.exitCode = 0;
  });
});

Что еще закрывать?

  • database pool;
  • Redis connections;
  • message queue consumers;
  • timers;
  • file handles;
  • telemetry exporters.

Timeout на shutdown

Нельзя ждать бесконечно. Обычно ставят deadline, после которого процесс завершается принудительно.

Что важно помнить

  • По SIGTERM перестаньте принимать новые запросы: server.close().
  • Дождитесь завершения текущих запросов, закройте соединения с БД и очередями.
  • Поставьте общий таймаут и принудительно завершите процесс, если очистка зависла.
  • server.closeIdleConnections() закрывает простаивающие keep-alive соединения.

Мини-шпаргалка

  • SIGTERM - типичный сигнал остановки в production.
  • server.close перестает принимать новые соединения.
  • Нужно закрыть внешние ресурсы.
  • Shutdown должен иметь timeout.
  • Process manager или orchestrator перезапустит приложение при необходимости.

Документация

Node.js: server.close, Node.js: Signal events.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам