build เว็บ static ใหม่เมื่อเผยแพร่

สิ่งที่จะได้

เว็บที่สร้างตอน build (Astro, Nuxt generate, Next.js export, Hugo…) ที่ build ใหม่เองเมื่อมีการเผยแพร่เนื้อหา ใช้: webhooks

1. ขอ deploy hook

ผู้ให้บริการ hosting จะให้ URL ที่เริ่ม build เมื่อได้รับ POST:

• Netlify: Site configuration → Build & deploy → Build hooks
• Vercel: Project Settings → Git → Deploy Hooks
• Cloudflare Pages: Settings → Builds → Deploy hooks

เก็บเป็นความลับ ใส่ไว้ใน environment variable เช่น DEPLOY_HOOK_URL

2. เรียกเมื่อมีอะไรขึ้นเว็บ

webhooks: [
  {
    url: process.env.DEPLOY_HOOK_URL as string,
    // เฉพาะการเปลี่ยนที่ผู้เยี่ยมชมเห็น ไม่ใช่ทุกครั้งที่บันทึกฉบับร่าง
    events: ['publish', 'unpublish', 'delete'],
    collections: ['posts', 'pages'],
  },
],

collection ที่ไม่มี drafts ให้เพิ่ม 'update' และ 'create' เพราะทุกการบันทึกขึ้นเว็บทันที

Easy CMS ส่ง request หลังบันทึกเสร็จ และส่งซ้ำประมาณหนึ่งวันถ้า hosting ล่ม (1 นาที, 5 นาที, 30 นาที, 2, 6 และ 12 ชั่วโมง) แม้ server จะรีสตาร์ต

3. build พร้อมเนื้อหา

ตอน build ให้อ่านเนื้อหาที่เผยแพร่จาก API เช่นใน Astro:

const res = await fetch(`${import.meta.env.CMS_URL}/api/cms/posts?limit=100&sort=-publishedAt`)
const { docs: posts } = await res.json()

เคล็ดลับ

• เผยแพร่หลายครั้งติดกันจะเริ่ม build หลายครั้ง hosting ส่วนใหญ่จะยกเลิกหรือต่อคิว build เก่าให้
• การเผยแพร่ตามเวลาก็ส่ง publish บทความที่ตั้งไว้ 9 โมงจึง build เว็บใหม่ตอน 9 โมง
• ครั้งที่ส่งไม่สำเร็จจะถูกบันทึก log บน server (Webhook <url> failed for publish …; will retry later) และการส่งจะถูกเก็บไว้จนสำเร็จหรือครบจำนวนครั้งที่ส่งซ้ำ