🎯 ภารกิจ — สาย Cloudflare: แอปมีสถานะและงานเบื้องหลัง

ลงมือทำจริงในบัญชี AWS หรือ Cloudflare ของคุณ แล้วติ๊กรายการที่ทำได้ครบ ภารกิจที่มีป้าย “บังคับ” ต้องผ่านทุกข้อจึงจะเลื่อนระดับ อย่าลืมลบทรัพยากรที่สร้างเมื่อทำเสร็จ

ภารกิจบังคับ 0/3

  1. ระบบนับคิวร้านกาแฟแบบ real-time ด้วย Durable Objects

    บังคับ

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

    สร้าง Worker + Durable Object หนึ่งตัวต่อหนึ่งสาขา (getByName("branch-<รหัส>")) - POST /branches/:id/tickets ออกเลขคิวถัดไป (เก็บใน SQLite ของ DO) - POST /branches/:id/next เรียกคิวถัดไป - GET /branches/:id/ws เปิด WebSocket แบบ hibernation ให้จอหน้าร้านเห็นเลขคิวปัจจุบันทันที - ตั้ง alarm ล้างคิวทุกเที่ยงคืน (เวลาไทย) โดยทำซ้ำได้ไม่พัง deploy ขึ้น workers.dev แล้วทดสอบด้วย curl และ wscat สองหน้าต่าง

    คำสั่ง/โค้ดเริ่มต้น

    ลองในCloudflare ↗
    npm create cloudflare@latest -- queue-counter
    # Hello World example → Worker + Durable Objects → TypeScript → Deploy: No
    cd queue-counter
    
    # wrangler.jsonc (ส่วนสำคัญ)
    # "compatibility_date": "2026-10-01",
    # "observability": { "enabled": true },
    # "durable_objects": { "bindings": [{ "name": "BRANCH", "class_name": "Branch" }] },
    # "exports": { "Branch": { "type": "durable-object", "storage": "sqlite" } }
    
    # โครง class (เติมเอง)
    # export class Branch extends DurableObject<Env> {
    #   constructor(ctx, env) { super(ctx, env); this.ctx.storage.sql.exec("CREATE TABLE IF NOT EXISTS tickets (...)"); }
    #   async issue(): Promise<number> { ... }            // RPC
    #   async callNext(): Promise<number | null> { ... }  // RPC + broadcast ด้วย this.ctx.getWebSockets()
    #   async fetch(req) { /* acceptWebSocket + serializeAttachment */ }
    #   async alarm() { /* ล้างคิว แล้ว setAlarm เที่ยงคืนถัดไป (UTC+7) */ }
    # }
    
    npx wrangler types && npx wrangler dev
    curl -s -X POST http://localhost:8787/branches/siam/tickets
    npx wscat -c ws://localhost:8787/branches/siam/ws

    เช็กลิสต์

  2. ส่งใบเสร็จผ่าน Queue พร้อม DLQ และ Workflow คืนเงิน

    บังคับ

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

    สร้าง Worker ที่ 1) POST /receipts ส่งงาน { jobId, email, orderId } เข้า Queue "receipts" แล้วตอบ 202 ทันที 2) consumer สร้างใบเสร็จ (จำลอง) แล้ว ack ทีละข้อความ พังให้ retry แบบ backoff ตั้ง max_retries 3 และ dead_letter_queue "receipts-dlq" 3) POST /refunds เริ่ม Workflow ที่ step "ตรวจสิทธิ์" → waitForEvent "approval" (timeout 1 hour) → step "คืนเงิน" ถ้าไม่อนุมัติให้ throw NonRetryableError ทดลองทำให้ข้อความหนึ่งตกไป DLQ และ refund หนึ่งรายการผ่าน/หนึ่งรายการถูกปฏิเสธ

    คำสั่ง/โค้ดเริ่มต้น

    ลองในCloudflare ↗
    npx wrangler queues create receipts
    npx wrangler queues create receipts-dlq
    
    # wrangler.jsonc
    # "queues": {
    #   "producers": [{ "queue": "receipts", "binding": "RECEIPTS" }],
    #   "consumers": [
    #     { "queue": "receipts", "max_retries": 3, "dead_letter_queue": "receipts-dlq", "max_concurrency": 2 },
    #     { "queue": "receipts-dlq" }
    #   ]
    # },
    # "workflows": [{ "name": "refund-flow", "binding": "REFUND", "class_name": "RefundFlow" }]
    
    # ใช้โค้ดบท c5c-02 เป็นแม่แบบ แล้วทดสอบ:
    npx wrangler deploy
    npx wrangler tail --format pretty
    npx wrangler workflows instances send-event refund-flow [instanceId] --type approval --payload '{"approved":true}'
    npx wrangler workflows instances describe refund-flow [instanceId]

    เช็กลิสต์

  3. เทสต์ใน workerd + pipeline GitHub Actions ที่มี Preview

    บังคับ

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

    นำโปรเจกต์จากภารกิจ m01 หรือ m02 มาเพิ่ม - เทสต์ด้วย @cloudflare/vitest-plugin อย่างน้อย 5 เคส รวมเทสต์ DO (runInDurableObject หรือ runDurableObjectAlarm) หรือ queue consumer (createMessageBatch + getQueueResult) - GitHub Actions: PR รัน typecheck + test แล้ว wrangler preview, push main แล้ว wrangler deploy - API token สิทธิ์เฉพาะ Workers ของบัญชีนี้ เก็บใน GitHub Secrets

    คำสั่ง/โค้ดเริ่มต้น

    ลองในCloudflare ↗
    ช่วยเขียนเทสต์ Vitest สำหรับ Cloudflare Worker ที่แนบมา โดยใช้ @cloudflare/vitest-plugin
    (vitest.config.ts ใช้ cloudflareTest({ wrangler: { configPath: "./wrangler.jsonc" } }))
    - import { env, exports } from "cloudflare:workers"
    - ใช้ runInDurableObject / runDurableObjectAlarm สำหรับ Durable Object
    - ใช้ createMessageBatch / createExecutionContext / getQueueResult สำหรับ queue consumer
    ขอเคส: เส้นทางปกติ, input ผิด (400/404), การทำงานพร้อมกัน, retry/ack ของ queue, alarm
    ห้ามเรียกบริการภายนอกจริง ให้ mock fetch ด้วย vi.spyOn(globalThis, "fetch")
    [วางโค้ด src/index.ts และ wrangler.jsonc ที่นี่]

    เช็กลิสต์

  4. Dashboard ของตัวเองด้วย Analytics Engine + ประเมินบิล

    โบนัส

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

    เพิ่ม telemetry ให้ Worker จากภารกิจก่อนหน้า: log เป็น object ที่มี event/route/status/ms/ray เขียน data point ลง Analytics Engine แล้ว query p95 latency และ error rate ต่อ route ของชั่วโมงล่าสุดด้วย SQL API ทำตารางประเมินบิลรายเดือนที่ 1 ล้าน, 10 ล้าน และ 100 ล้าน request พร้อมระบุบริการที่แพงที่สุดในแต่ละระดับ

    คำสั่ง/โค้ดเริ่มต้น

    ลองในCloudflare ↗
    export CF_ACCOUNT_ID=[account-id]
    read -s CF_ANALYTICS_TOKEN && export CF_ANALYTICS_TOKEN
    curl -s "https://api.cloudflare.com/client/v4/accounts/$CF_ACCOUNT_ID/analytics_engine/sql" \
      --header "Authorization: Bearer $CF_ANALYTICS_TOKEN" \
      --data "SELECT blob1 AS route, SUM(_sample_interval) AS hits, SUM(IF(blob2 >= '500', _sample_interval, 0)) AS errors FROM [dataset] WHERE timestamp > NOW() - INTERVAL '1' HOUR GROUP BY route ORDER BY hits DESC"

    เช็กลิสต์