*.job.ts
Mỗi file *.job.ts là một việc chạy nền. Code server đưa việc vào hàng đợi bằng enqueue, manh.run chạy nó sau và thử lại khi lỗi.
app/invoices/
├── repository.ts
├── send.job.ts # enqueue("app/invoices/send.job.ts", …)
└── [id:int]/
└── send/
└── post.ts # trả lời ngay, gửi hoá đơn trong jobVai trò
Request phải trả lời nhanh. Việc chậm (gửi nhiều email, gọi AI, xử lý nhiều dòng, xuất file lớn) chuyển sang job: handler ghi phần chính, gọi enqueue với id, rồi trả response. File đặt ở thư mục nào cũng được, thường cạnh repository.ts của resource mà job xử lý.
Export
default: hàmasyncnhậnpayloadmàenqueuetruyền vào. Giá trị trả về không dùng.
Ví dụ
app/invoices/send.job.ts
import { email } from "manh/email";
import { getInvoice, markSent } from "./repository";
export default async function (payload: { invoiceId: number }) {
const inv = await getInvoice(payload.invoiceId);
if (inv.sentAt) return; // đã gửi ở lần chạy trước
await email({ to: inv.customerEmail, subject: `Hoá đơn ${inv.code}`, html: renderInvoice(inv) });
await markSent(inv.id);
}app/invoices/[id:int]/send/post.ts
import { enqueue } from "manh/jobs";
export default async (c, { param }) => {
enqueue("app/invoices/send.job.ts", { invoiceId: param.id });
return { queued: true };
};Cần biết
- Job dùng chung
app/dbvàmanh/*với handler, nhưng không cócvà không có người dùng. Truyền id trong payload rồi đọc dữ liệu trong job. - Job lỗi được thử lại, tổng cộng tối đa 3 lần, cách nhau 30 rồi 60 giây. Job phải an toàn khi chạy hai lần.
- Hẹn giờ chạy bằng
delaySeconds, tối đa 30 ngày. Việc lặp theo lịch cố định thì dùng *.cron.ts. - Xem các lần chạy và lỗi ở mục Vận hành › Việc nền của không gian làm việc.
Bước tiếp theo
Cập nhật