Cara Menulis Crontab yang Benar di VPS Linux: 7 Jebakan yang Bikin Cron Gagal Diam-Diam
Anda sudah menulis crontab dengan benar. Syntax-nya valid, sudah dicek di validator online, sudah disimpan. Tapi script Anda tidak pernah berjalan di waktu yang dijadwalkan.
Ini adalah salah satu masalah paling frustrasi dalam administrasi server Linux. Cron tidak memberikan pesan error. Tidak ada log yang jelas. Script diam, server diam, dan Anda hanya bisa bertanya-tanya apa yang salah.
Jawabannya hampir selalu adalah satu (atau beberapa) dari tujuh jebakan ini.
[GAMBAR INLINE 1]
Jebakan 1: PATH Berbeda dari Shell Interaktif
Ini penyebab nomor satu kegagalan cron yang tidak terdeteksi.
Ketika Anda menjalankan perintah di terminal interaktif, shell Anda memiliki PATH yang kaya: /usr/local/bin:/usr/bin:/bin:/home/user/.local/bin dan sebagainya, termasuk semua yang didefinisikan di .bashrc atau .profile Anda.
Cron tidak memuat .bashrc atau .profile. Cron menjalankan perintah dengan PATH minimal: hanya /usr/bin:/bin. Perintah seperti python3, node, wp, atau composer yang ada di /usr/local/bin tidak akan ditemukan.
Solusi: Selalu gunakan path absolut, atau definisikan PATH di baris atas crontab:
“`
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
0 2 * * * /usr/bin/python3 /home/user/script.py
“`
Cara cek path absolut sebuah perintah:
“`
which python3
Output: /usr/bin/python3
“`
Jebakan 2: Output Hilang ke Mana-Mana
Cron mencoba mengirim output perintah via email ke pengguna sistem. Pada VPS tanpa mail transfer agent (MTA) terkonfigurasi—yang merupakan kondisi normal hampir semua VPS baru—output ini dibuang begitu saja. Tanpa log, tanpa error, tanpa jejak.
Solusi: Redirect output ke file log secara eksplisit:
0 2 * * * /usr/local/bin/backup.sh >> /var/log/backup.log 2>&1
>> /var/log/backup.log menambahkan stdout ke file log (tidak menimpa).
2>&1 mengirim stderr ke tempat yang sama dengan stdout.
Tanpa ini, Anda tidak akan pernah tahu apakah cron berjalan atau gagal.
Jebakan 3: Karakter % di Dalam Perintah
Dalam sintaks crontab, karakter % adalah karakter khusus yang diartikan sebagai newline. Jika perintah Anda mengandung %—misalnya di format tanggal seperti date +%Y%m%d—crontab akan memotong perintah di titik itu.
Solusi: Escape setiap % dengan backslash \:
“`
SALAH – akan gagal:
0 2 * * * echo $(date +%Y%m%d) > /tmp/today.txt
BENAR – escape % dengan \:
0 2 * * * echo $(date +\%Y\%m\%d) > /tmp/today.txt
“`
[GAMBAR INLINE 2]
Jebakan 4: Dua Instance Cron Berjalan Bersamaan
Jika sebuah cron job membutuhkan waktu lebih lama dari intervalnya—misalnya job backup berjalan 90 menit tapi dijadwalkan setiap jam—instance kedua akan mulai berjalan sebelum instance pertama selesai. Ini menyebabkan konflik data, penggunaan resource berlebih, dan output yang korup.
Solusi: Gunakan flock untuk mencegah overlap:
0 * * * * flock -n /tmp/backup.lock /usr/local/bin/backup.sh >> /var/log/backup.log 2>&1
flock -n mencoba mengambil lock. Jika gagal (artinya instance lain masih berjalan), perintah dilewati tanpa menunggu.
Jebakan 5: Script Tidak Executable
Sangat sederhana, sangat sering terlupakan. Jika script yang dipanggil oleh cron tidak memiliki permission executable, cron akan gagal tanpa pesan yang berguna.
Solusi:
chmod +x /home/user/script.sh
Dan pastikan baris pertama script memiliki shebang yang benar:
“`
!/bin/bash
“`
Tanpa shebang, sistem tidak tahu interpreter mana yang harus digunakan.
Jebakan 6: Direktori Kerja Tidak Seperti yang Diharapkan
Script yang bekerja sempurna saat dijalankan manual dari direktori /home/user/scripts/ mungkin gagal di bawah cron karena cron tidak otomatis masuk ke direktori tersebut. Cron menjalankan perintah dari direktori home pengguna atau / tergantung konfigurasi.
Jika script Anda menggunakan path relatif (./config.ini, ../data/), path tersebut akan merujuk ke direktori yang salah.
Solusi: Gunakan cd di awal perintah cron, atau gunakan path absolut di dalam script:
0 2 * * * cd /home/user/scripts && ./backup.sh >> /var/log/backup.log 2>&1
Jebakan 7: Cron Service Tidak Berjalan
Ini yang paling mudah dilupakan setelah reboot server atau pembaruan sistem:
“`
Cek apakah cron berjalan:
systemctl status cron
atau pada beberapa distro:
systemctl status crond
Aktifkan jika tidak berjalan:
systemctl enable cron
systemctl start cron
“`
| Perintah Diagnostik | Fungsi |
|---|---|
crontab -l |
Tampilkan daftar crontab pengguna saat ini |
crontab -e |
Edit crontab (simpan untuk aktivasi) |
grep CRON /var/log/syslog |
Lihat log kapan cron terakhir berjalan |
journalctl -u cron --since today |
Lihat semua job cron yang dimulai hari ini |
systemctl status cron |
Pastikan cron daemon aktif |
[GAMBAR INLINE 3]
Checklist Sebelum Memasang Cron Job Baru
Sebelum simpan di crontab, pastikan:
- [ ] Jalankan perintah secara manual terlebih dulu—pastikan berhasil
- [ ] Gunakan path absolut ke semua binary dan script
- [ ] Tambahkan
>> /var/log/nama-job.log 2>&1untuk capture output - [ ] Escape karakter
%jika ada di perintah - [ ] Script memiliki permission
+x - [ ] Gunakan
flockjika job bisa berjalan lebih dari intervalnya - [ ] Verifikasi dengan
crontab -lsetelah disimpan - [ ] Tunggu jadwal pertama dan cek log untuk konfirmasi
Catatan editor: Inspirasi dari debian.tips/commands/crontab dan cronvault.com/blog. Ditulis ulang total. Berbeda dari draft cara monitor uptime VPS (Nov-14) yang fokus pada UptimeRobot—ini fokus pada memperbaiki cron yang sudah ada tapi tidak jalan.