Deploy บน Cloudflare Workers

Worker ไม่มี disk และไม่มี process ที่รันค้างไว้ ฐานข้อมูลจึงต่อผ่าน HTTP (Turso) ไฟล์อัปโหลดไปอยู่ใน bucket (R2) และ Cloudflare เรียก Worker ทุกนาทีเพื่อรันงานตามเวลา easy-cms build --target workers เขียน Worker ให้ แล้ว Wrangler deploy

หน้านี้ใช้กับ standalone server เท่านั้น Easy CMS ที่อยู่ในแอป Next.js หรือ Nuxt ยังต้องใช้ Node.js

สิ่งที่ต้องมี

• โปรเจกต์ standalone: npm create easy-cms my-cms ในโฟลเดอร์ใหม่
• Workers Paid การตรวจรหัสผ่านตอนเข้าสู่ระบบใช้ CPU ราว 100 ms เกิน 10 ms ต่อ request ของ plan ฟรี
• ฐานข้อมูล Turso และ bucket ของ R2 พร้อม API token (R2 → Manage API tokens → Object Read & Write สำหรับ bucket นั้น)

1. ฐานข้อมูล: Turso

ใน easy-cms.config.ts เพิ่ม token:

db: sqlite({
  url: process.env.DATABASE_URL ?? 'file:./cms.db',
  authToken: process.env.DATABASE_AUTH_TOKEN,
}),

DATABASE_URL คือ URL libsql:// ของฐานข้อมูล บนเครื่องของคุณ ถ้าไม่ตั้งไว้ก็ใช้ไฟล์ SQLite เหมือนเดิม

2. ไฟล์อัปโหลด: R2

npm install @easy-cms/storage-s3

pnpm add @easy-cms/storage-s3

yarn add @easy-cms/storage-s3

bun add @easy-cms/storage-s3

import { s3Storage } from '@easy-cms/storage-s3'
 
upload: {
  storage: s3Storage({
    bucket: 'my-site-media',
    region: 'auto',
    endpoint: `https://${process.env.R2_ACCOUNT_ID}.r2.cloudflarestorage.com`,
    accessKeyId: process.env.R2_ACCESS_KEY_ID,
    secretAccessKey: process.env.R2_SECRET_ACCESS_KEY,
  }),
},

Worker อ่านตัวแปรเหล่านี้ตอนเริ่มทำงาน หน้า admin ส่งไฟล์ที่ใหญ่กว่า 4 MB จากเบราว์เซอร์ตรงไปที่ bucket จึงต้องตั้ง CORS ให้ origin ของเว็บ ดูไฟล์ขนาดใหญ่

3. Build Worker

npm install -D wrangler
npx easy-cms build --target workers

pnpm add -D wrangler
pnpm exec easy-cms build --target workers

yarn add -D wrangler
yarn easy-cms build --target workers

bun add --dev wrangler
bunx easy-cms build --target workers

จะได้:

• .easy-cms/workers/: entry ของ Worker และไฟล์ของหน้า admin เขียนใหม่ทุกครั้งที่ build ให้เพิ่ม .easy-cms/ ใน .gitignore
• wrangler.jsonc ครั้งแรกเท่านั้น: nodejs_compat, binding ASSETS สำหรับหน้า admin, Cron Triggers ทุกนาที, NODE_ENV=production และ alias ของแพ็กเกจที่รันบน Workers ไม่ได้ (sharp) ตรวจ name ให้ถูก หลังจากนั้นไฟล์นี้เป็น ของคุณ การ build จะไม่เขียนทับ

build ใหม่ทุกครั้งที่แก้ easy-cms.config.ts หรืออัปเดต Easy CMS เพราะ Worker รวม config ไว้ในตัว

4. Migration

สร้าง migration กับฐานข้อมูลใหม่แล้ว commit เหมือนโฮสต์อื่น (Migration และการ deploy):

npx easy-cms migrate:create init

pnpm exec easy-cms migrate:create init

yarn easy-cms migrate:create init

bunx easy-cms migrate:create init

แล้ว apply กับ Turso จากเครื่องของคุณหรือ CI ก่อน deploy ทุกครั้ง:

DATABASE_URL=libsql://… DATABASE_AUTH_TOKEN=… npx easy-cms migrate

Worker อ่านไฟล์ migration ไม่ได้ มันจะเริ่มทำงานเมื่อ migration ล่าสุดของฐานข้อมูลตรงกับ config ของมัน ถ้าไม่ตรงจะตอบ 500 พร้อมข้อความ "The config changed since the database's last migration"

5. Secret

npx wrangler secret put EASY_CMS_SECRET

6. Deploy

npx wrangler deploy

เปิด /admin ที่ address ของ Worker สร้าง admin คนแรกด้วย setup code อัปโหลดรูป (ไฟล์จะไปอยู่ใน R2) และเผยแพร่โพสต์ แล้วตั้ง serverURL เป็น address นั้น

งานตามเวลา

Cron Trigger ใน wrangler.jsonc รันงานเบื้องหลังทุกนาที: โพสต์ที่ตั้งเวลาไว้ ส่ง webhook ซ้ำ และอีเมลที่รอส่ง ไม่ต้องใช้ CRON_SECRET

ลองบนเครื่องของคุณ

npx wrangler dev

รัน Worker ใน workerd ซึ่งเป็น runtime ของ Cloudflare โดยใช้ตัวแปรจาก .env เพิ่ม --test-scheduled แล้วเปิด /__scheduled เพื่อรันงานตามเวลา

สิ่งที่ต่างไปบน Workers

• ไม่ย่อรูป: sharp ต้องใช้ Node.js upload.imageSizes จึงไม่สร้างรูปย่อ แต่รูปยังได้ความกว้างและความสูง
• อีเมล: SMTP ต้องใช้ Node.js ให้ใช้ Resend, Postmark หรือ Brevo จาก @easy-cms/plugin-email ซึ่งส่งผ่าน HTTP
• IP ของผู้เข้าชม อ่านจาก CF-Connecting-IP เอง ไม่ต้องตั้งอะไร
• แต่ละ request อาจไปถึง Worker คนละตัว เหมือนหลาย instance session, การจำกัดการเข้าสู่ระบบ และงาน เบื้องหลังเก็บอยู่ในฐานข้อมูล

CI ตรวจอะไร

ทุก pull request สร้างโปรเจกต์ด้วย npm create easy-cms เพิ่ม @easy-cms/storage-s3 และ Wrangler, migrate, build Worker แล้วรันด้วย wrangler dev กับ sqld (ตัวเดียวกับที่ Turso ใช้) และ S3 server จากนั้นเข้าสู่ระบบ อัปโหลดรูป สร้าง แก้ อ่าน ลบโพสต์ โหลดหน้า admin และรัน Cron Trigger ส่วนการ deploy ขึ้น Cloudflare จริงไม่ได้อยู่ในนี้

ถ้ามีปัญหา

• build บอกว่า config ต้องมี upload.storage: Worker ไม่มี disk ตั้งตามขั้นที่ 2
• 500 พร้อม "The config changed since the database's last migration" หรือ "No migrations found": รัน easy-cms migrate กับฐานข้อมูล Turso แล้ว deploy ใหม่
• เข้าสู่ระบบไม่ได้ ขึ้น error 1102 (Worker exceeded resource limits): บัญชียังใช้ plan ฟรี การเข้าสู่ระบบต้องใช้ Workers Paid

ขั้นต่อไป

• สถาปัตยกรรมสำหรับ production: สิ่งที่ CMS หลายตัวใช้ร่วมกัน
• ความปลอดภัย: checklist ก่อนเปิดใช้งานจริง