Chuẩn bị

Bạn cần Node.js 18 trở lên, npm, và một tài khoản Cloudflare (miễn phí là đủ). Toàn bộ mã nguồn của blog Nhịp AI làm theo đúng các bước dưới đây.

Bước 1: Dựng project Astro

Khởi tạo project với output server và adapter @astrojs/cloudflare. Adapter này biến mỗi trang Astro thành một Worker có thể truy cập binding D1, R2 qua Astro.locals.runtime.env.

Bước 2: Khai báo binding trong wrangler.jsonc

Khai báo d1_databases với binding DB và r2_buckets với binding R2, cộng assets trỏ tới thư mục build của Astro. Bật nodejs_compat nếu dependency cần API Node.js, và bật observability để có log và trace.

Bước 3: Migration D1

Viết schema vào migrations/0001_init.sql rồi chạy:


npx wrangler d1 migrations apply nhip-ai-blog-db --local
npx wrangler d1 migrations apply nhip-ai-blog-db --remote

Bước 4: API bằng Hono

Đặt Hono app trong src/lib/api.ts, mount qua route catch-all src/pages/api/[...path].ts. API công khai chỉ đọc; API admin yêu cầu Bearer token từ biến ADMIN_TOKEN (đặt bằng wrangler secret put).

Bước 5: Deploy


npm run build
npx wrangler deploy

Kiểm tra trang chủ, một bài viết, RSS và sitemap sau khi deploy.

Kết luận

Mô hình Astro + Hono + D1 + R2 đủ nhẹ để chạy miễn phí, đủ mạnh để mở rộng khi lượng đọc tăng. Bài tiếp theo sẽ đi sâu vào upload ảnh lên R2 và tối ưu cache.