Chạy cron job và worker nền trên cloud cho Node.js, Python, PHP
Để chạy tác vụ định kỳ trên ZoCloud, bạn tạo một service từ cùng repo với app, đổi Loại service thành Cron job, nhập Lịch chạy (cron) theo giờ Việt Nam (ví dụ 0 2 * * *) và đặt Lệnh chạy là lệnh của tác vụ. Việc chạy liên tục như xử lý hàng đợi, bot Telegram hay đồng bộ dữ liệu thì dùng loại Worker: không có cổng, không có địa chỉ, chạy suốt và tự có log, số liệu. Cả hai dùng chung biến môi trường, database và mạng nội bộ với web service.
Bài này đi qua cách chọn loại service, cách cấu hình từng loại, và ví dụ cụ thể với Node.js, Python và Laravel.
Ba loại service: web, worker, cron
Trên ZoCloud, mỗi chương trình trong project là một service. Loại service quyết định cách nó chạy:
| Loại | Chạy thế nào | Dùng cho |
|---|---|---|
| Web | Liên tục, nhận request HTTP, có địa chỉ HTTPS | Website, API |
| Worker | Liên tục, không có cổng, không có địa chỉ | Xử lý hàng đợi, bot, consumer, scheduler |
| Cron job | Theo lịch, chạy tới khi xong rồi dừng | Sao lưu, gửi báo cáo, dọn dữ liệu, đồng bộ |
Đổi loại ở tab Cấu hình → Loại service, rồi deploy lại để áp dụng. Thường bạn có một repo và nhiều service dùng chung repo đó: một web, một worker, vài cron job, mỗi service một Lệnh chạy khác nhau.
Vì sao không chạy cron bên trong web app? Khi web chạy 2 bản trở lên (khuyến nghị cho production), mỗi bản sẽ chạy cron một lần, nên báo cáo gửi hai lần. Web cũng có thể bị tắt khi bật chế độ ngủ hay khởi động lại khi deploy. Tách ra service riêng thì mỗi việc chạy đúng một lần, có log riêng.
Tạo worker nền
- Trên canvas project, bấm Thêm → Từ repo GitHub, chọn cùng repo với app web, đặt tên
worker. (Deploy từ thư mục trên máy:zo deploy -to myorg/shop/worker.) - Tab Cấu hình → Loại service → Worker.
- Ở Build và chạy, đặt Lệnh chạy là lệnh của worker (ví dụ bên dưới).
- Tab Biến môi trường: thêm các biến cần dùng bằng biến tham chiếu, ví dụ
DATABASE_URL=${{pg.DATABASE_URL}},REDIS_URL=${{cache.REDIS_URL}}. - Bấm Deploy.
Worker có tab Log và Số liệu (CPU, RAM, mạng) riêng. Khi hàng đợi dài, tăng Số bản chạy ở tab Cấu hình, hoặc bật Tự động scale theo CPU với tối thiểu, tối đa và CPU mục tiêu.
Một số điều cần biết:
- Worker không ngủ. Chế độ ngủ khi không có truy cập chỉ áp dụng cho web service.
- Dừng êm khi deploy. Khi bạn deploy bản mới, bản cũ nhận tín hiệu
SIGTERM. Worker nên bắt tín hiệu này, làm xong việc đang dở rồi thoát, để không bỏ dở một việc giữa chừng. - Việc phải làm lại được. Nếu một việc có thể bị chạy hai lần (do lỗi mạng, khởi động lại), hãy thiết kế để chạy hai lần vẫn đúng: kiểm tra trạng thái trước khi gửi e-mail, dùng khoá duy nhất khi ghi.
- Bị dừng đột ngột thì có báo. Khi một service dừng đột ngột, chủ sở hữu và quản trị viên của tổ chức nhận e-mail kèm liên kết tới log; bạn có thể thêm kênh Slack, Discord hay webhook ở mục Thông báo.
Tạo cron job
- Tạo service từ cùng repo như trên, đặt tên theo việc, ví dụ
report-daily. - Tab Cấu hình → Loại service → Cron job.
- Nhập Lịch chạy (cron) và Tối đa (phút) (thời gian tối đa một lần chạy, từ 1 tới 1440 phút; quá thời gian thì lần chạy bị dừng).
- Đặt Lệnh chạy là lệnh của tác vụ, ví dụ
node scripts/report.js. - Deploy. Từ đó ZoCloud tự chạy theo lịch.
Mỗi lần chạy là một container chạy tới khi xong, với cùng biến môi trường và mạng của environment, nên cron job đọc được database và gọi được service nội bộ (http://api.internal). Tab Lần chạy liệt kê các lần chạy với mã thoát và các dòng log cuối; nút Chạy ngay chạy tay để thử mà không phải chờ tới giờ.
Quy tắc quan trọng: chương trình phải tự thoát. Script xong việc mà còn giữ kết nối database mở thì tiến trình không kết thúc, và lần chạy sẽ kéo dài tới giới hạn Tối đa (phút). Đóng kết nối, rồi thoát với mã 0 khi thành công, mã khác 0 khi lỗi, để tab Lần chạy phản ánh đúng.
Cú pháp lịch chạy
Lịch có 5 trường phút giờ ngày tháng thứ, tính theo giờ Việt Nam:
| Lịch | Nghĩa |
|---|---|
0 2 * * * |
2:00 sáng mỗi ngày |
*/15 * * * * |
Mỗi 15 phút |
30 8 * * 1-5 |
8:30 sáng thứ Hai tới thứ Sáu |
0 9,17 * * * |
9:00 và 17:00 mỗi ngày |
0 0 1 * * |
0:00 ngày 1 hằng tháng |
@daily, @hourly, @weekly, @monthly |
Viết tắt (lúc 0:00, đầu mỗi giờ, Chủ nhật, ngày 1) |
Trường thứ nhận 0 hoặc 7 là Chủ nhật. Dùng được dấu *, danh sách 1,15, khoảng 1-5 và bước */10.
ZoCloud đặt khoảng cách tối thiểu giữa hai lần chạy; nếu lịch dày quá, portal báo khi lưu. Lần trước chưa xong thì lần sau bị bỏ qua, nên không bao giờ có hai lần chạy chồng nhau.
Khai báo trong file thay vì portal
Nếu muốn lịch nằm cùng code, đặt zocloud.json ở gốc repo (hoặc thư mục gốc của service):
{
"deploy": {
"start": "node scripts/report.js",
"cron_schedule": "0 7 * * *"
}
}
Giá trị trong file được ưu tiên hơn ô trên portal ở mỗi lần build. Chuyển từ Railway thì cronSchedule trong railway.json cũng được đọc. Với AI agent, MCP server có công cụ set_cron (biến service thành cron job) và run_cron (chạy ngay và lấy kết quả); xem MCP server là gì.
Ví dụ với Node.js
Cron job gửi báo cáo (scripts/report.js):
import pg from "pg";
const pool = new pg.Pool({ connectionString: process.env.DATABASE_URL });
try {
const { rows } = await pool.query(
"select count(*) as orders from orders where created_at >= now() - interval '1 day'"
);
await sendReport(rows[0]); // gửi e-mail / Slack
console.log("Đã gửi báo cáo", rows[0]);
} catch (err) {
console.error(err);
process.exitCode = 1; // lần chạy hiện là lỗi
} finally {
await pool.end(); // đóng kết nối để tiến trình thoát
}
Worker xử lý hàng đợi trên PostgreSQL với pg-boss, có dừng êm:
import PgBoss from "pg-boss";
const boss = new PgBoss(process.env.DATABASE_URL);
await boss.start();
await boss.work("send-email", async ([job]) => {
await sendEmail(job.data);
});
process.on("SIGTERM", async () => {
await boss.stop({ graceful: true });
process.exit(0);
});
Lệnh chạy của worker: node worker.js. Nếu đã có Valkey, BullMQ cũng chạy được; chọn hàng đợi trên PostgreSQL khi muốn dữ liệu việc nằm cùng database có backup. Chi tiết trong bài Redis (Valkey) cho cache, session và hàng đợi. Với pg-boss, nên dùng DATABASE_URL_DIRECT nếu thư viện cần LISTEN/NOTIFY hay advisory lock (xem PostgreSQL cloud tại Việt Nam).
Ví dụ với Python
Worker Celery: service loại Worker, lệnh chạy
celery -A config worker --loglevel=info
với biến REDIS_URL=${{cache.REDIS_URL}} làm broker. Nếu app chạy trong virtualenv do ZoCloud tạo, dùng .venv/bin/celery. Tác vụ định kỳ của Celery (celery beat) có thể chạy trong một worker riêng, chỉ 1 bản chạy, để lịch không bị nhân đôi.
Cron job đơn giản bằng script:
# jobs/cleanup.py
import os, sys
import psycopg
try:
with psycopg.connect(os.environ["DATABASE_URL_DIRECT"]) as conn:
n = conn.execute(
"delete from sessions where expires_at < now()"
).rowcount
print(f"Đã xoá {n} phiên hết hạn")
except Exception as e:
print(e, file=sys.stderr)
sys.exit(1)
Lịch 0 3 * * *, lệnh chạy python jobs/cleanup.py. Với Django, lệnh quản lý cũng dùng được: python manage.py clearsessions. Hướng dẫn deploy Python đầy đủ ở bài deploy FastAPI, Django, Flask.
Ví dụ với PHP (Laravel)
Laravel có hai thứ chạy nền: queue worker và scheduler.
Queue worker: service loại Worker, lệnh chạy
php artisan queue:work --tries=3 --max-time=3600
Đặt QUEUE_CONNECTION=database và chạy php artisan queue:table (Laravel 10 trở về trước; bản mới có sẵn bảng jobs) rồi migrate. Nếu project có Valkey, driver redis (QUEUE_CONNECTION=redis) cũng chạy được. --max-time cho worker tự khởi động lại định kỳ, tránh rò rỉ bộ nhớ.
Scheduler: Laravel mong lệnh schedule:run chạy mỗi phút, dày hơn khoảng cách tối thiểu của cron job. Cách gọn nhất là chạy scheduler như một worker:
php artisan schedule:work
Service loại Worker, 1 bản chạy, lệnh như trên. schedule:work tự kiểm tra mỗi phút và chạy các tác vụ khai báo trong routes/console.php (hoặc app/Console/Kernel.php với bản cũ), đúng như cron truyền thống. Nếu bạn chỉ có một hai tác vụ thưa (ví dụ báo cáo mỗi sáng), tạo cron job riêng với lệnh php artisan report:daily cũng được.
Đặt APP_TIMEZONE=Asia/Ho_Chi_Minh (hoặc timezone trong config/app.php) để giờ trong ->dailyAt('08:00') khớp với giờ Việt Nam. Xem thêm bài deploy Laravel PHP.
Gỡ lỗi cron job và worker
| Hiện tượng | Nguyên nhân hay gặp |
|---|---|
| Lần chạy kéo dài tới giới hạn rồi bị dừng | Script không thoát: còn kết nối database, timer hay consumer đang mở |
| Mã thoát khác 0 | Xem các dòng log cuối trong tab Lần chạy; thường thiếu biến môi trường |
| Bấm Chạy ngay thì báo "Hãy deploy cron job trước." | Cron job cần được deploy ít nhất một lần |
| Lịch bị từ chối khi lưu | Sai cú pháp 5 trường, hoặc dày hơn khoảng cách tối thiểu |
| Worker khởi động lại liên tục | Lỗi khi khởi động (sai lệnh chạy, thiếu biến); xem tab Log |
| Tác vụ chạy hai lần | Scheduler chạy trong web hoặc worker có từ 2 bản chạy |
Biến môi trường có hiệu lực từ lần deploy sau, nên sau khi thêm biến, nhớ deploy lại cả worker và cron job. Biến dùng cho nhiều service (khoá API, DSN Sentry) đặt một lần ở Biến chung của environment rồi tham chiếu bằng ${{shared.KEY}}; xem bài biến môi trường.
Chi phí
Worker và cron job là service như web, tính vào số service của gói: Dùng thử 2 service, Hobby 5 (119.000 đ/tháng), Pro 20 (499.000 đ/tháng), Team 100 (1.990.000 đ/tháng), giá trước VAT. Cron job chỉ chạy khi tới lịch nên không giữ tài nguyên giữa các lần chạy. Ước tính chi phí cho cả app ở bài chi phí chạy app vibe coding và trang Thanh toán.
Tài liệu chi tiết: App: loại service và cron job, zo CLI và MCP.
Câu hỏi thường gặp
Cron job trên ZoCloud chạy theo múi giờ nào?
Theo giờ Việt Nam. Lịch 0 2 * * * chạy lúc 2 giờ sáng giờ Việt Nam mỗi ngày, bạn không phải quy đổi sang UTC.
Lần chạy trước chưa xong thì lần sau có chạy chồng lên không? Không. Nếu lần trước còn đang chạy, lần tới bị bỏ qua, nên hai lần chạy của cùng một cron job không bao giờ chồng nhau.
Có chạy cron mỗi phút được không?
ZoCloud đặt khoảng cách tối thiểu giữa hai lần chạy và portal báo nếu lịch dày quá. Việc cần chạy mỗi phút nên để trong một worker chạy liên tục, ví dụ php artisan schedule:work với Laravel.
Worker khác web service ở điểm nào? Worker không có cổng và không có địa chỉ HTTPS, chạy liên tục để xử lý hàng đợi hay bot. Nó dùng cùng biến môi trường, database và mạng nội bộ như web service.