Terminal Linux dan jam meja untuk kerja berjadual

Anda menulis skrip sandaran pangkalan data, mengujinya dua kali di terminal, semuanya berjalan lancar. Kemudian anda masukkan ke dalam crontab supaya ia berjalan setiap pukul 3:00 pagi. Dua minggu berlalu dengan tenang tanpa sebarang mesej ralat. Sehinggalah satu hari anda perlukan fail sandaran itu—dan baru sedar fail terakhir di dalam folder simpanan bertarikh dua minggu lepas, hari pertama anda mula memasang jadual tersebut.

Inilah sifat paling berbahaya pada tugas berjadual (cron job): apabila berjaya ia senyap, dan apabila gagal pun ia sering kali kelihatan senyap melainkan anda sengaja memasang log dan pemantauan.

Kenapa skrip berjaya di terminal tetapi gagal dalam cron?

Punca paling kerap bukanlah sintaks jadual lima ruang (minit jam hari bulan hari_minggu) yang kita taip melalui crontab -e, tetapi persekitaran (environment) cron yang jauh lebih sempit berbanding sesi shell interaktif anda:

  1. $PATH yang terhad: Apabila anda log masuk melalui SSH, fail .bashrc atau .profile dimuatkan dengan laluan ke /usr/local/bin, Node.js (nvm), PHP versi tertentu, atau Python virtualenv. Di dalam cron, $PATH selalunya cuma /usr/bin:/bin. Arahan seperti node, wp, atau rclone terus gagal dengan ralat command not found.
  2. Direktori kerja berbeza: cron berjalan dari direktori $HOME pengguna, bukan daripada folder projek anda. Jika skrip anda menyebut ./backup.sql atau node scripts/sync.mjs, ia akan mencari fail itu di tempat yang salah.
  3. Pemboleh ubah .env tiada: Kunci API atau kata laluan pangkalan data yang dieksport dalam sesi terminal tidak wujud secara automatik dalam sesi cron.

Cara penyelesaian yang paling bersih ialah menggunakan laluan mutlak (absolute paths) untuk semua binari dan fail, serta menetapkan direktori kerja di awal skrip shell anda:

#!/usr/bin/env bash
set -euo pipefail

cd /var/www/projek-saya
/usr/bin/mysqldump --single-transaction nama_db > /var/backups/db-$(date +%F).sql

Simpan output ke log dan elakkan tugasan bertindih

Jangan biarkan output cron dibuang ke /dev/null jika anda belum pasti ia stabil. Halakan kedua-dua output biasa (stdout) dan mesej ralat (stderr) ke fail log supaya anda boleh memeriksa punca kegagalan apabila perlu:

0 3 * * * /usr/local/bin/backup-harian.sh >> /var/log/backup-harian.log 2>&1

Dua perkara tambahan yang patut diamalkan untuk tugas penting:

  • Gunakan flock untuk mengelakkan pertindihan: Jika satu tugas mengambil masa lebih lama daripada jangkaan (contohnya tugasan berjalan setiap 5 minit tetapi hari ini sambungan rangkaian perlahan sehingga mengambil masa 8 minit), cron akan melancarkan salinan kedua di atas salinan pertama yang belum tamat. Membungkus arahan dengan /usr/bin/flock -n /tmp/backup.lock /usr/local/bin/backup-harian.sh memastikan hanya satu salinan berjalan pada satu-satu masa.
  • Putar fail log (logrotate): Fail log yang bertambah setiap hari tanpa had boleh memenuhkan ruang cakera keras pelayan dalam beberapa bulan. Tetapkan konfigurasi ringkas di /etc/logrotate.d/ supaya log lama dimampatkan dan dibuang selepas beberapa minggu.

Pantau hasil sebenar, bukan sekadar semak cron berjalan

Menyemak grep CRON /var/log/syslog cuma membuktikan sistem cron telah memulakan skrip anda pada pukul 3:00 pagi—ia tidak membuktikan skrip itu berjaya atau fail sandarannya tidak kosong.

Untuk tugasan kritikal seperti sandaran harian, pengiraan invois, atau pembersihan data, tambah satu langkah akhir yang menghantar notifikasi ringkas (ke Telegram, e-mel, atau pemantau heartbeat seperti Healthchecks.io) hanya jika proses tamat dengan kod keluar 0 dan saiz fail melebihi had minimum yang masuk akal. Jika tiada laporan masuk pada pukul 3:15 pagi, anda terus tahu hari itu juga—bukan dua minggu kemudian ketika bencana sudah berlaku.