तपाईंले graceful shutdown कसे लागू गर्नुहुन्छ?

Question

Accepted Answer

**Graceful shutdown** भनेको सर्भरलाई स्वच्छतापूर्वक बन्द गर्नु हो जब यसले termination signal प्राप्त गरे — चलिरहेको अनुरोधहरूलाई पूरा गर्नु, जडानहरू (DB, आदि) बन्द गर्नु र स्रोतहरू रिलिज गर्नु — यसको सट्टा अचानक मार्नु र सक्रिय काम गुमाउनु होइन। यो zero-downtime डिप्लोमेन्ट र विश्वसनीयताको लागि आवश्यक छ।

## अचानक बन्द किन समस्या हो

```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
```

डिप्लोमेन्ट र अटोस्केलिङको समयमा, प्रक्रियाहरूलाई निरन्तर रोक दिइन्छ — यो स्वच्छतापूर्वक गर्नु नै हो जसले डिप्लोमेन्टहरूलाई सुचारु बनाउँछ।

## यो लागू गर्दै

```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
```

क्रम: signal पक्रनु → `server.close()` (नयाँ जडानहरू रोक्नु, अवस्थित हरू ड्रेन गर्नु) → DB/Redis/अन्य स्रोतहरू बन्द गर्नु → बाहिर निस्कनु। **Timeout fallback** कुनै कुरा अलमल भएमा बलपूर्वक निस्क्नु, ताकि अड्किरहेको जडान शटडाउनलाई चिरकाल अवरुद्ध गर्न नसकोस्।

## संकेतहरू

```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
```

## कन्टेनरयुक्त वातावरणमा

```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 डिप्लोमेन्टहरू** र आधुनिक (विशेषतः कन्टेनरयुक्त/अर्केस्ट्रेटेड) वातावरणमा विश्वसनीय सञ्चालन सक्षम गरे, जहाँ प्रक्रियाहरूलाई नियमित रूपमा रोक दिइन्छ र पुनः सुरु गरिन्छ।

यो बिना, हरेक डिप्लोमेन्ट वा स्केल-डाउनले सक्रिय अनुरोधहरू गुमाउँछ र डेटा असंगतिको जोखिम लिन्छ।

Catch-signal → stop-accepting → drain → close-resources → exit क्रम लागू गर्नु (timeout safety net सहित) उत्पादन-तयार Node सेवाहरूको विशेषता र बारम्बार बिर्सिएको तर महत्त्वपूर्ण परिचालन चिन्ता हो।