Triển khai graceful shutdown như thế nào?

Question

Accepted Answer

**Graceful shutdown** (tắt nhẹ nhàng) nghĩa là dừng một server sạch sẽ khi nó nhận tín hiệu kết thúc — hoàn tất các request đang xử lý, đóng kết nối (DB, v.v.) và giải phóng tài nguyên — thay vì giết đột ngột và bỏ rơi công việc đang chạy. Đây là điều thiết yếu cho triển khai không-downtime và độ tin cậy.

## Vì sao tắt đột ngột là vấn đề

```text
Không có graceful shutdown, khi tiến trình bị giết (triển khai, scale-down, crash):
  ✗ Request đang xử lý bị bỏ rơi → user nhận lỗi
  ✗ Giao dịch DB dở dang
  ✗ Kết nối không đóng sạch → rò rỉ/khóa
```

Trong lúc triển khai và autoscaling, tiến trình bị dừng liên tục — làm việc đó sạch sẽ là điều khiến triển khai liền mạch.

## Triển khai nó

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

async function shutdown(signal) {
  console.log(`Nhận ${signal} — đang tắt nhẹ nhàng`);

// 1. Ngừng nhận kết nối MỚI; hoàn tất các kết nối hiện có
  server.close(async () => {
    // 2. Callback này chạy khi mọi request đang hoạt động đã hoàn tất
    await db.end();            // đóng pool database
    await redis.quit();        // đóng các kết nối khác
    console.log("tắt sạch hoàn tất");
    process.exit(0);           // thoát thành công
  });

// 3. Lưới an toàn: ép thoát nếu dọn dẹp treo quá lâu
  setTimeout(() => {
    console.error("ép tắt — dọn dẹp hết thời gian");
    process.exit(1);
  }, 10_000).unref();
}

// Lắng nghe các tín hiệu kết thúc
process.on("SIGTERM", () => shutdown("SIGTERM")); // gửi bởi orchestrator (k8s, Docker)
process.on("SIGINT", () => shutdown("SIGINT"));   // Ctrl+C trong dev
```

Trình tự: bắt tín hiệu → `server.close()` (ngừng kết nối mới, rút cạn cái hiện có) → đóng DB/Redis/tài nguyên khác → thoát. Một **timeout dự phòng** ép thoát nếu cái gì đó treo, để một kết nối kẹt không thể chặn việc tắt mãi mãi.

## Các tín hiệu

```text
SIGTERM → tín hiệu "vui lòng kết thúc" chuẩn từ orchestrator khi triển khai/scale-down
SIGINT  → Ctrl+C (phát triển)
SIGKILL → không thể bắt (ép giết) — graceful shutdown không giúp được ở đây
```

## Trong môi trường container

```text
Kubernetes/Docker gửi SIGTERM, chờ một khoảng grace (vd 30 giây), RỒI gửi SIGKILL.
App của bạn phải hoàn tất trong cửa sổ đó → giữ timeout tắt ngắn hơn.
Readiness probe nên đánh dấu pod chưa sẵn sàng để load balancer ngừng gửi traffic.
```

## Tại sao điều này quan trọng

Graceful shutdown là điều cho phép **triển khai không-downtime** và vận hành tin cậy trong các môi trường hiện đại (đặc biệt container/orchestrate), nơi tiến trình bị dừng và khởi động lại thường xuyên.

Không có nó, mỗi lần triển khai hay scale-down bỏ rơi request đang hoạt động và mạo hiểm bất nhất dữ liệu.

Triển khai trình tự bắt-tín-hiệu → ngừng-nhận → rút-cạn → đóng-tài-nguyên → thoát (với lưới an toàn timeout) là dấu hiệu của service Node sẵn sàng production và là một mối lo vận hành thường bị bỏ qua nhưng quan trọng.