Deploy Checklist: Edge Computing Next.js

Chuẩn bị Project

Thiết lập môi trường và dependencies

Bước 1

Cài đặt Node.js >= 18.x và npm/pnpm

Kiểm tra node -v và npm -v đảm bảo phiên bản tương thích Edge Runtime

Cấu hình Next.js với Edge Runtime

Thêm export const runtime = 'edge' vào các route cần chạy trên edge

Cài Wrangler CLI và đăng nhập Cloudflare

Chạy npm install -g wrangler rồi wrangler login để xác thực tài khoản

Kiểm tra và loại bỏ dependencies không tương thích

Các package dùng Node.js APIs (fs, path, crypto native) cần được thay thế bằng Web APIs hoặc polyfills

Thiết lập environment variables và secrets

Tạo file .env.local và chuẩn bị danh sách secrets để upload lên Cloudflare và Vercel

Cấu hình wrangler.toml

Định nghĩa Worker và bindings

Bước 2

Khai báo name, main, compatibility_date

Đặt compatibility_date mới nhất và compatibility_flags = ["nodejs_compat"] nếu cần

Cấu hình KV Namespaces và R2 Buckets

Khai báo [[kv_namespaces]] và [[r2_buckets]] với đúng binding name và ID

Thiết lập routes và custom domains

Định nghĩa [[routes]] để map domain hoặc URL patterns tới Worker, cấu hình workers_dev = false nếu dùng custom domain

Upload secrets qua Wrangler CLI

Dùng wrangler secret put SECRET_NAME cho từng biến nhạy cảm, không hardcode trong wrangler.toml

Deploy Cloudflare Worker

Publish Worker lên mạng lưới edge toàn cầu

Bước 3

Chạy build và preview local trước khi deploy

Dùng wrangler dev để test local, xác nhận Worker chạy đúng không có lỗi runtime

Deploy lên môi trường staging

Chạy wrangler deploy --env staging để kiểm tra trên môi trường thật trước production

Deploy production và xác nhận Worker đang hoạt động

Chạy wrangler deploy, sau đó vào Cloudflare Dashboard kiểm tra trạng thái Worker và logs

Kích hoạt và kiểm tra Cloudflare Analytics

Bật Worker Analytics Engine, kiểm tra request count, error rate, và CPU time trên dashboard trong 30 phút đầu

Deploy Next.js lên Vercel

Kết nối repository và publish ứng dụng

Bước 4

Kết nối GitHub/GitLab repository với Vercel

Import project từ Git provider, cấu hình Build Command next build và Output Directory .next

Cấu hình Environment Variables trên Vercel Dashboard

Thêm đầy đủ các env vars cho Production, Preview, và Development. Xác nhận NEXT_PUBLIC_ prefix đúng cho client-side vars

Gán custom domain và xác minh SSL certificate

Thêm domain vào Vercel, cập nhật DNS records, đợi SSL provisioning hoàn thành. Bật Edge Network và Vercel Edge Middleware nếu cần

Kiểm tra sau Deploy

Validate performance, giới hạn và tính ổn định

Bước 5

Test latency từ nhiều khu vực địa lý

Dùng tools như Pingdom, GTmetrix hoặc Cloudflare Observatory để đo TTFB từ US, EU, APAC. Mục tiêu TTFB edge dưới 50ms

Kiểm tra cold start time của Worker

Gửi request đầu tiên sau idle period, đo thời gian khởi động. Cloudflare Workers thường dưới 5ms cold start nhờ V8 isolates, cần xác nhận không vượt quá 50ms

Xác minh giới hạn CPU time (CPU Limit)

Free plan giới hạn 10ms CPU time/request, Paid plan 30s. Kiểm tra Cloudflare Dashboard xem CPU usage, tối ưu logic nếu gần giới hạn. Dùng wrangler tail để monitor realtime

Chạy Lighthouse audit trên Vercel deployment

Kiểm tra Performance, Accessibility, SEO scores. Mục tiêu Performance Score trên 90, LCP dưới 2.5s, CLS dưới 0.1

Thiết lập alerting và error monitoring

Cấu hình Cloudflare Notifications cho Worker errors, tích hợp Sentry hoặc Axiom để track exceptions, thiết lập uptime monitoring với khoảng ping mỗi 5 phút