Πώς εφαρμόζετε κομψό τερματισμό;

Question

Accepted Answer

**Ο κομψός τερματισμός** σημαίνει διακοπή ενός διακομιστή καθαρά όταν λάβει ένα σήμα τερματισμού — ολοκλήρωση σε εξέλιξη αιτημάτων, κλείσιμο συνδέσεων (DB κ.λπ.) και απελευθέρωση πόρων — αντί να τον σκοτώσετε απότομα και να χάσετε ενεργό έργο. Είναι απαραίτητο για αναπτύξεις χωρίς χρόνο διακοπής και αξιοπιστία.

## Γιατί ο απότομος τερματισμός είναι πρόβλημα

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

Η ακολουθία: σύλληψη του σήματος → `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.
```

## Γιατί έχει σημασία

Ο κομψός τερματισμός είναι αυτό που ενεργοποιεί **αναπτύξεις χωρίς χρόνο διακοπής** και αξιόπιστη λειτουργία σε σύγχρονα (ειδικά δοχείων/διοργανωμένα) περιβάλλοντα, όπου οι διεργασίες σταματάνε και επανεκκινούνται συνήθως.

Χωρίς αυτό, κάθε ανάπτυξη ή μείωση κλίμακας ρίχνει ενεργά αιτήματα και κινδυνεύει ασυνέπεια δεδομένων.

Η εφαρμογή της ακολουθίας σύλληψης-σήματος → διακοπή-αποδοχής → αποστράγγιση → κλείσιμο-πόρων → έξοδος (με ένα χρονοδιάγραμμα δικτύου ασφαλείας) είναι χαρακτηριστικό των υπηρεσιών Node που είναι έτοιμες για παραγωγή και ένα συχνά αγνοούμενο αλλά σημαντικό λειτουργικό ζήτημα.