Skip to Content

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: preview hoặc prod để 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_control với run.

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ó trong cron_runs.
    • pause: dừng các lượt theo lịch.
    • resume: chạy lại theo lịch.
  • Trả về: run_id với run; paused với pause và 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

Cập nhật