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ờ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.
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.
// 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ócvà 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
- Check và sửa lỗi — đọc lỗi
checkbáo và nhờ agent sửa trước khi deploy. - *.cron.ts — mọi export và quy tắc đặt tên job.
- Gửi và nhận email — gửi báo cáo ngay trong job.