Skip to Content

Việc chạy định kỳ

Khoảng 10 phút. Làm xong, bạn có một job chạy theo lịch, như huỷ đơn treo mỗi giờ hay gửi báo cáo mỗi sáng, và chạy lại nhiều lần cũng không sinh dữ liệu trùng.

Cron job là một hàm manh.run tự gọi theo lịch, không cần ai mở app. Mỗi file đuôi .cron.ts là một job, tên file cũng là tên job.

1. Tạo file job

File export hai thứ: schedule (cú pháp cron 5 trường, tính theo giờ UTC) và một hàm async mặc định. Hàm này không phải trả response.

app/orders/ ├── repository.ts └── cancel-stale.cron.ts job "cancel-stale", chạy mỗi giờ
app/orders/cancel-stale.cron.ts
import { cancelStalePending } from "./repository"; export const schedule = "0 * * * *"; // phút 0 của mỗi giờ export default async function () { const n = await cancelStalePending(Date.now() - 24 * 3600 * 1000); console.log(JSON.stringify({ job: "cancel-stale", cancelled: n })); }

Job gọi hàm trong repository như handler vẫn làm, nên luật huỷ đơn chỉ nằm ở một chỗ.

2. Đổi giờ Việt Nam sang UTC

Lịch tính theo giờ UTC. Giờ Việt Nam là UTC+7, nên bạn lấy giờ Việt Nam trừ đi 7.

  • 08:00 mỗi ngày → 0 1 * * *
  • 18:00 mỗi ngày → 0 11 * * *
  • 09:00 thứ Hai đến thứ Sáu → 0 2 * * 1-5
  • Mỗi 15 phút → */15 * * * *
  • 07:00 ngày 1 hằng tháng → 0 0 1 * *

Thứ trong tuần: 0 hoặc 7 là Chủ nhật, 1 là thứ Hai. Nếu đặt cả ngày trong tháng lẫn thứ trong tuần, job chạy khi một trong hai khớp. Hai lần chạy cách nhau ít nhất 1 phút.

3. Chỉ xử lý phần mới

Hàm nhận { lastRunAt, scheduledAt }. lastRunAt là thời điểm chạy thành công gần nhất (lần đầu là undefined), nên bạn không cần tự lưu mốc thời gian.

app/reports/daily-digest.cron.ts
import { email } from "manh/email"; import { salesSince, managerEmails } from "./repository"; export const schedule = "0 1 * * *"; // 08:00 giờ Việt Nam export default async function ({ lastRunAt, scheduledAt }: { lastRunAt?: Date; scheduledAt: Date }) { const since = lastRunAt ?? new Date(scheduledAt.getTime() - 86_400_000); // lần đầu: 24 giờ qua const s = await salesSince(since); for (const to of await managerEmails()) { await email({ to, subject: `Doanh thu từ ${since.toLocaleDateString("vi-VN")}`, html: `<meta charset="utf-8"><p>${s.count} đơn · ${s.revenue.toLocaleString("vi-VN")} đ</p>`, }); } }

4. Viết job chạy lại an toàn

Lần chạy nào lỗi, tức là ném lỗi, trả 5xx hoặc quá giờ, thì manh.run chạy lại tối đa 3 lần, chờ 30 giây rồi 60 giây giữa các lần. Vì vậy job phải chạy lại không gây trùng lặp: chạy hai lần cũng ra kết quả như chạy một lần.

app/orders/repository.ts
// import { db, eq, and, lt } from "app/db"; … export async function cancelStalePending(before: number) { const rows = await db.update(orders) .set({ status: "cancelled" }) .where(and(eq(orders.status, "pending"), lt(orders.createdAt, before))) // chỉ đơn còn pending .returning({ id: orders.id }); return rows.length; }

Nhờ điều kiện status = "pending", lần chạy thứ hai không đụng lại những đơn đã huỷ.

5. Theo dõi và chạy tay

Mở Vận hành › Cron trong project để xem lịch sử chạy, tạm dừng một job hoặc bấm Chạy ngay. Agent cũng làm được các việc này qua MCP.

Cần biết

  • Job không đi qua middleware.ts, không có c và không gắn với người dùng nào. Job cần dữ liệu gì thì tự đọc lấy.
  • Mỗi lần chạy được dùng tối đa 30 giây CPU. Việc lâu hơn thì chia nhỏ hoặc chuyển sang chạy nền.
  • Nếu lần chạy trước của job chưa xong, lần kế tiếp sẽ bị bỏ qua.
  • Số job mỗi app tuỳ gói, xem Hạn mức theo gói.

Bước tiếp theo

Cập nhật