Cron
Ba công cụ cron_jobs, cron_runs và cron_control để agent xem việc định kỳ đã deploy, đọc lịch sử chạy, chạy ngay một việc, tạm dừng hoặc chạy lại lịch.
Việc định kỳ là file app/<thư-mục>/<tên>.cron.ts có export const schedule (giờ UTC) và một hàm default. Deploy đăng ký lịch; lượt chạy lỗi được thử lại tối đa 3 lần.
cron_jobs
Liệt kê việc định kỳ đã deploy.
- Tham số:
project;env:previewhoặcprodđể lọc, mặc định lấy cả hai. - Trả về: mỗi việc có
id, lịch (UTC),paused, lần chạy tới và lần chạy gần nhất. Không có việc nào thì trả danh sách trống kèm ghi chú. - Khi nào gọi: sau deploy, để chắc lịch đã được đăng ký và lấy
job_id.
cron_runs
Lịch sử chạy của một việc, mới nhất trước.
- Tham số:
project;job_id;limit: 1–200, mặc định 20. - Trả về: mỗi lượt có trạng thái, thời gian chạy và lỗi nếu có.
- Khi nào gọi: khi một việc không làm điều nó phải làm, hoặc sau
cron_controlvớirun.
cron_control
Điều khiển một việc.
- Tham số:
project;job_id;action:run: chạy ngay một lượt, kể cả khi đang tạm dừng. Trảrun_id; khoảng 10 giây sau kết quả có trongcron_runs.pause: dừng các lượt theo lịch.resume: chạy lại theo lịch.
- Trả về:
run_idvớirun;pausedvớipausevàresume. - Khi nào gọi: để chạy thử một việc mới deploy mà không chờ tới giờ, hoặc dừng một việc đang gửi sai email.
Trạng thái tạm dừng được giữ qua các lần deploy. Mỗi lần run là một lượt chạy thật code của app, có thể gửi email hoặc gọi dịch vụ ngoài.
Bước tiếp theo
- Việc chạy định kỳ: viết file
.cron.ts. - Log: lượt chạy cron hiện trong
traces. - Hạn mức theo gói: số việc định kỳ mỗi gói.
Cập nhật