Checklist trước khi deploy app Node.js lên production

Deploy nhanh chỉ thật sự hữu ích khi mỗi lần release đều có thể kiểm soát được. Trước khi đưa app Node.js ra production, team nên có một checklist ngắn để giảm lỗi lặp lại và giúp rollback rõ ràng hơn.

1. Tách cấu hình khỏi source code

Các giá trị như database URL, token, API key và endpoint nội bộ không nên nằm trong repository. Hãy đưa chúng vào biến môi trường và đặt tên nhất quán giữa local, staging và production.

Một cấu hình tối thiểu thường gồm:

NODE_ENV
PORT
DATABASE_URL
APP_URL
LOG_LEVEL

2. Build phải chạy lại được

Pipeline deploy nên chạy cùng một lệnh build với local hoặc CI. Nếu app cần generate client, compile TypeScript hoặc bundle frontend, các bước đó nên nằm trong package.json để không phụ thuộc trí nhớ của người deploy.

{
  "scripts": {
    "build": "tsc -p tsconfig.json",
    "start": "node dist/server.js"
  }
}

3. Luôn có health check

Endpoint health check giúp platform biết app đã sẵn sàng nhận traffic hay chưa. Endpoint này không nên query quá nhiều dịch vụ bên ngoài; chỉ cần trả về trạng thái cơ bản và kiểm tra nhẹ các dependency quan trọng.

4. Log đủ để debug sau release

Log production nên có timestamp, request id và mức độ lỗi. Khi release lỗi, điều quan trọng nhất là biết lỗi bắt đầu từ version nào, endpoint nào và request nào.

5. Rollback là một phần của deploy

Trước khi bấm deploy, cần biết cách quay lại version trước đó. Một bản release tốt không chỉ là bản chạy được, mà còn là bản có đường lui rõ ràng khi phát hiện lỗi ngoài production.