คุณจะ implement graceful shutdown ได้อย่างไร

Question

Accepted Answer

**Graceful shutdown** หมายถึงการหยุดเซิร์ฟเวอร์อย่างสะอาดเมื่อรับสัญญาณยุติ — จบคำขอที่กำลังอยู่ในการบิน ปิดการเชื่อมต่อ (ฐานข้อมูล ฯลฯ) และปล่อยทรัพยากร — แทนที่จะฆ่าอย่างกะทันหันและหยุดงานที่ใช้งานอยู่ มีความสำคัญสำหรับ zero-downtime deploys และความน่าเชื่อถือ

## ทำไมการปิดแบบกะทันหันจึงเป็นปัญหา

```text
Without graceful shutdown, when the process is killed (deploy, scale-down, crash):
  ✗ In-flight requests are dropped → users get errors
  ✗ DB transactions left incomplete
  ✗ Connections not closed cleanly → leaks/locks
```

ในระหว่าง deploys และ autoscaling กระบวนการต่างๆ ถูกหยุดอย่างต่อเนื่อง — การทำเช่นนั้นอย่างสะอาดคือสิ่งที่ทำให้ deployments เป็นไปอย่างราบรื่น

## การ implement

```js
import http from "http";
const server = http.createServer(app);
server.listen(3000);

async function shutdown(signal) {
  console.log(`${signal} received — shutting down gracefully`);

// 1. Stop accepting NEW connections; finish existing ones
  server.close(async () => {
    // 2. This callback runs once all active requests have completed
    await db.end();            // close database pool
    await redis.quit();        // close other connections
    console.log("clean shutdown complete");
    process.exit(0);           // exit successfully
  });

// 3. Safety net: force-exit if cleanup hangs too long
  setTimeout(() => {
    console.error("forced shutdown — cleanup timed out");
    process.exit(1);
  }, 10_000).unref();
}

// Listen for termination signals
process.on("SIGTERM", () => shutdown("SIGTERM")); // sent by orchestrators (k8s, Docker)
process.on("SIGINT", () => shutdown("SIGINT"));   // Ctrl+C in dev
```

ลำดับ: catch สัญญาณ → `server.close()` (หยุดการเชื่อมต่อใหม่ drain ของที่มีอยู่) → ปิด DB/Redis/ทรัพยากรอื่นๆ → exit timeout fallback ให้ force-exit หากมีบางอย่างค้าง เพื่อไม่ให้การเชื่อมต่อที่ค้างไม่ได้บล็อก shutdown ตลอดไป

## สัญญาณ

```text
SIGTERM → the standard "please terminate" signal from orchestrators on deploy/scale-down
SIGINT  → Ctrl+C (development)
SIGKILL → cannot be caught (force kill) — graceful shutdown can't help here
```

## ในสภาวะแวดล้อมแบบ containerized

```text
Kubernetes/Docker send SIGTERM, wait a grace period (e.g. 30s), THEN SIGKILL.
Your app must finish within that window → keep the shutdown timeout shorter.
Readiness probes should mark the pod unready so the load balancer stops sending traffic.
```

## ทำไมสิ่งนี้จึงสำคัญ

Graceful shutdown คือสิ่งที่เปิดใช้งาน **zero-downtime deployments** และการดำเนินการที่เชื่อถือได้ในสภาวะแวดล้อมสมัยใหม่ (โดยเฉพาะสภาวะแวดล้อมแบบ containerized/orchestrated) ซึ่งกระบวนการต่างๆ ถูกหยุดและเริ่มต้นใหม่อย่างสม่ำเสมอ

โดยไม่มีมัน deployment หรือ scale-down ทุกครั้งจะปล่อยให้คำขอที่ใช้งานอยู่และเสี่ยงต่อความไม่สอดคล้องของข้อมูล

การ implement ลำดับ catch-signal → stop-accepting → drain → close-resources → exit (พร้อม timeout safety net) เป็นลักษณะของบริการ Node ที่พร้อมสำหรับ production และความกังวล operational ที่สำคัญแต่มักถูกมองข้าม