Корректное завершение процессов в Node.js

Корректное завершение процессов в Node.js — важнейшая часть продакшн‑инфраструктуры, особенно если приложение работает в Kubernetes. Правильная обработка сигнала остановки позволяет обеспечить предсказуемое поведение сервиса, избежать потери запросов и сократить время простоя при деплое.

Зачем важно корректное завершение процессов в Kubernetes

Kubernetes управляет жизненным циклом подов и при их остановке отправляет контейнеру сигнал SIGTERM. Если приложение не умеет его обрабатывать, процесс завершается принудительно — что может привести к ошибкам, оборванным запросам и неконсистентности данных.

• правильный graceful shutdown предотвращает потерю активных соединений;
• обеспечивает плавное выключение сервиса при деплое или масштабировании;
• уменьшает риск падения приложения из-за резкого прекращения работы;
• повышает стабильность API и качество пользовательского опыта.

Как Kubernetes завершает работу пода

При остановке пода Kubernetes посылает контейнеру SIGTERM и ждёт указанное время (обычно 30 секунд). Если процесс не завершился сам, отправляется SIGKILL — принудительное завершение.

Обработка SIGTERM в Node.js

В Node.js важно не просто завершить процесс, а сначала остановить приём новых запросов и корректно закрыть активные соединения.

Основные шаги graceful shutdown

1. Перестать принимать новые запросы — закрыть HTTP‑сервер через server.close().
2. Дождаться завершения текущих запросов — дать соединениям корректно отработать.
3. Корректно закрыть внешние ресурсы — базы данных, очереди, кэши.
4. Завершить процесс — вызвать process.exit() после успешного закрытия.

Пример кода обработки SIGTERM

process.on('SIGTERM', () => {
  console.log('Получен SIGTERM, начинаю завершение...');
  
  server.close(() => {
    console.log('HTTP-сервер остановлен.');
    
    db.close().then(() => {
      console.log('База данных закрыта.');
      process.exit(0);
    });
  });
});

Типичные ошибки при завершении процессов

• отсутствие обработки SIGTERM — процесс «умирает» слишком резко;
• блокировка event loop, из-за чего приложение не успевает завершиться;
• принудительное завершение соединений без ожидания;
• задержки при закрытии внешних ресурсов без таймаутов.

Рекомендации для продакшн‑окружения

Устанавливайте readiness/liveness пробки

Правильный статус readiness позволяет Kubernetes перестать отправлять трафик на под перед его остановкой.

Используйте таймауты завершения

Добавляйте собственные таймауты на закрытие ресурсов, чтобы не зависнуть в процессе shutdown.

Логируйте этапы завершения

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

Итоги

Корректное завершение процессов в Node.js — обязательная практика при работе в Kubernetes. Грамотная обработка SIGTERM обеспечивает надёжность, сохраняет активные соединения и делает деплой предсказуемым и безопасным. Освоив graceful shutdown, вы создаете фундамент для стабильной продакшн‑архитектуры.