Deploy NodeJS bằng Docker trên VPS không downtime dễ hơn bạn nghĩ

FROM node:20-alpine AS builder
WORKDIR /app

COPY package*.json ./
RUN npm ci

COPY . .
RUN npm run build

FROM node:20-alpine
WORKDIR /app
ENV NODE_ENV=production

COPY package*.json ./
RUN npm ci --omit=dev

COPY --from=builder /app/dist ./dist
COPY --from=builder /app/node_modules ./node_modules

EXPOSE 3000
CMD ["node", "dist/server.js"]

upstream node_backend {
    server 127.0.0.1:3001;
}

server {
    listen 80;
    server_name yourdomain.com;

location / {
        proxy_pass http://node_backend;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

app.get('/health', async (req, res) => {
  res.status(200).json({ ok: true });
});

Tốt hơn:

– check DB connection
– check Redis nếu bắt buộc
– trả về 200 chỉ khi app thực sự sẵn sàng

Trong Docker Compose có thể thêm:

healthcheck:
  test: ["CMD", "wget", "-qO-", "http://localhost:3000/health"]
  interval: 10s
  timeout: 3s
  retries: 5

Ý nghĩa:

– Container up ≠ app ready
– Health pass → mới switch traffic

Quy trình deploy không downtime trên VPS

Đây là flow thực chiến, dễ automate:

Bước 1: Build image mới

Build trên CI hoặc ngay trên VPS đều được, nhưng tốt nhất là build trên CI rồi push registry.

docker build -t myapp:2025-08-20 .

Hoặc dùng tag theo commit SHA:

docker build -t myapp:git-abc123 .

Bước 2: Chạy container mới ở port phụ

Ví dụ container cũ đang map 3001, bản mới chạy 3002:

docker run -d --name myapp_green 
  -p 3002:3000 
  --env-file .env 
  myapp:git-abc123

Bước 3: Kiểm tra health

curl http://127.0.0.1:3002/health

Chỉ đi tiếp khi trả 200.

Bước 4: Switch Nginx upstream

Đổi 127.0.0.1:3001 thành 127.0.0.1:3002, rồi:

nginx -t && nginx -s reload

Bước 5: Theo dõi ngắn hạn

Kiểm tra:

– error log
– CPU/RAM
– tỷ lệ 5xx
– response time
– kết nối DB

Nếu ổn vài phút:

docker stop myapp_blue
docker rm myapp_blue

Bước 6: Giữ khả năng rollback

Không xóa image cũ ngay. Nếu bản mới lỗi:

– đổi upstream về bản cũ
– reload Nginx
– dừng bản mới

Rollback mất vài giây, không cần rebuild.

Docker Compose có giúp được không?

Có. Rất hợp với VPS nhỏ. Nhưng cần hiểu: Compose tự nó không đảm bảo zero-downtime. Nếu chỉ docker compose up -d --build, container cũ có thể bị thay thế trước khi bản mới sẵn sàng.

Compose phù hợp cho:

– quản lý nhiều service
– quản lý env/network/volume
– chuẩn hóa lệnh vận hành

Nhưng để không downtime, vẫn nên kết hợp:

– port song song
– health check
– reverse proxy switch

Nói cách khác:

– Compose → quản trị tiện
– Nginx + blue/green → cập nhật mượt

Những lỗi phổ biến làm deploy “không downtime” thành downtime

1. Chạy migration phá vỡ tương thích

Nếu code mới cần schema mới, nhưng code cũ chưa đọc được schema đó, quá trình chuyển đổi sẽ lỗi.

Cách xử lý:

– ưu tiên backward-compatible migrations
– deploy theo thứ tự: schema an toàn → app mới → cleanup sau

2. Session lưu trong memory

Nếu app lưu session trong RAM container:

– switch container → user logout
– scale nhiều container → session lệch

Fix:

– Redis/session store ngoài container
– hoặc dùng JWT/stateless auth

3. WebSocket/long connection bị cắt

App có WebSocket, SSE, upload dài → cần cấu hình timeout, graceful shutdown.

Fix:

– bắt SIGTERM
– ngừng nhận request mới
– chờ request cũ hoàn tất rồi mới exit

4. Không giới hạn tài nguyên

Container mới lên cùng lúc container cũ:

– RAM tăng gấp đôi tạm thời
– VPS yếu → OOM → cả hai cùng chết

Fix:

– đo tài nguyên trước
– chọn image gọn
– reserve đủ RAM/swap hợp lý

Tự động hóa bằng CI/CD

Khi flow đã ổn, hãy tự động hóa bằng GitHub Actions/GitLab CI:

– push code
– test
– build image
– push Docker registry
– SSH vào VPS
– pull image mới
– run container phụ
– health check
– switch Nginx
– cleanup image cũ

Lợi ích:

– giảm thao tác tay
– giảm lỗi người vận hành
– release nhanh hơn, đều hơn

Quan trọng nhất: script deploy phải idempotent. Chạy lại không được phá hệ thống.

Kết luận

Với phần lớn app NodeJS chạy trên VPS, bạn không cần Kubernetes để có deploy gần như zero-downtime. Một stack gọn gồm:

– Docker
– Nginx
– health check
– blue/green switching
– CI/CD cơ bản

…đã đủ tạo ra quy trình chuyên nghiệp, an toàn, dễ rollback.

Tư duy cốt lõi là: không cập nhật trực tiếp container đang phục vụ traffic. Thay vào đó, hãy khởi chạy phiên bản mới song song, xác minh nó khỏe, rồi mới chuyển hướng request. Mọi tối ưu khác đều xoay quanh nguyên tắc này.

Nếu đang deploy bằng git pull && pm2 restart, đây là lúc nâng cấp. Chỉ cần thêm một lớp Docker hóa và một reverse proxy cấu hình đúng, bạn sẽ giảm rõ rệt rủi ro downtime, tăng độ tin cậy cho mỗi lần release, và tiết kiệm rất nhiều thời gian xử lý sự cố sau deploy.