Урок 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 перезапустит приложение при необходимости.
Документация
Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.