كيف تصمم آلية Graceful Shutdown في تطبيق Node.js عند استقبال إشارات SIGTERM أو SIGINT؟

الإجابة المختصرة

يتم اعتراض الإشارة، التوقف عن استقبال طلبات جديدة عبر server.close()، انتظار إكمال الطلبات القائمة، إغلاق اتصالات قواعد البيانات، ثم الخروج بـ process.exit(0).

الشرح

في بيئات الحاويات السحابية، يرسل النظام إشارة SIGTERM لمنح التطبيق فرصة للإغلاق النظيف. الخطوات الصحيحة تشمل إيقاف الخادم، وضع مهلة قصوى تحسباً لتعلق أي طلبات، إغلاق حمامات اتصالات قواعد البيانات ومقابس الـ WebSockets، ثم الخروج برمز نجاح 0.

مثال بالكود

process.on("SIGTERM", async () => {
  server.close(async () => {
    await db.close();
    process.exit(0);
  });
});

أخطاء شائعة

• عدم وضع مهلة زمنية قسرية في حالة وجود طلب عالق أو اتصال مفتوح بلا نهاية.

أسئلة متابعة

• ما الفرق بين uncaughtException و unhandledRejection في Node.js وما التصرف الصحيح عند حدوثهما؟

المصادر

• Node.js docs — process: Signal events