तुम्ही 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 तैनातीस** आणि आधुनिक (विशेषतः containerized/orchestrated) वातावरणात विश्वसनीय ऑपरेशन सक्षम करते, जेथे प्रक्रिया नियमितपणे थांबविल्या जातात आणि पुन्हा सुरू केल्या जातात.

त्याशिवाय, प्रत्येक तैनातीकरण किंवा स्केल-डाउन सक्रिय विनंत्या सोडून देतो आणि डेटा विसंगतीचा जोखीम घेते.

catch-signal → stop-accepting → drain → close-resources → exit क्रम (timeout safety net सह) लागू करणे हे उत्पादन-तयार Node सेवांचे वैशिष्ट्य आणि वारंवार दुर्लक्षित परंतु महत्वाचे ऑपरेशनल चिंता आहे.