Generator Crontab & Pembuat Ekspresi Cron

Apa Itu Ekspresi Cron?

# Linux crontab entry — runs every 15 minutes
*/15 * * * *  /usr/local/bin/poll-api.sh

# Kubernetes CronJob — weekdays at 9:00 AM UTC
apiVersion: batch/v1
kind: CronJob
metadata:
  name: daily-report
spec:
  schedule: "0 9 * * 1-5"
  timeZone: "UTC"
  jobTemplate:
    spec:
      template:
        spec:
          containers:
            - name: report
              image: report-runner:1.0
          restartPolicy: OnFailure

# GitHub Actions workflow — hourly
on:
  schedule:
    - cron: '0 * * * *'

# AWS EventBridge — first of each month
ScheduleExpression: cron(0 0 1 * ? *)
# (Note: AWS uses the Quartz 6-field form with '?' for day-of-week)

Fitur Utama

Varian Cron & Scheduler

Contoh Ekspresi Cron

*/15 * * * *

0 9 * * 1-5

0 0 1 * *

*/5 9-17 * * 1-5

0 0 1 JAN,APR,JUL,OCT *

0 0 1 * 5

30 2 * * *

@daily

Cara Membangun Ekspresi Cron

1. 1

   Ketik atau tempel ekspresi cron

   Masukkan ekspresi cron lima kolom di kolom masukan di atas (mis., */15 * * * *). Alat mengurai dan memvalidasi saat Anda mengetik — centang hijau untuk valid, kesalahan merah dengan nama kolom untuk yang tidak valid. Makro seperti @daily, @hourly, dll. juga diterima.

2. 2

   Atau sesuaikan lima input kolom

   Jangan menghafal urutan kolom — sunting Menit, Jam, Tanggal, Bulan, atau Hari secara individual menggunakan input berlabel. Ekspresi penuh di atas diperbarui secara otomatis. Gunakan * untuk wildcard, */N untuk langkah, a-b untuk rentang, dan 1,3,5 untuk daftar.

3. 3

   Pilih preset untuk memulai cepat

   Ketuk chip preset apa pun (Tiap 15 menit, Hari kerja pukul 09.00, dll.) untuk memuat jadwal umum, lalu sesuaikan kolom hingga sesuai kebutuhan. Sebelas preset mencakup pola yang akan Anda gunakan di produksi.

4. 4

   Verifikasi pratinjau jadwal berikutnya

   Lihat lima datetime jadwal mendatang — beralih antara Lokal dan UTC untuk memastikan jadwal menyala saat Anda inginkan. Inilah cara paling andal untuk menangkap jebakan OR tanggal/hari POSIX sebelum menggigit Anda di produksi.

5. 5

   Salin dan tempel ke scheduler Anda

   Klik Salin untuk mengambil ekspresi. Tempel ke crontab Anda, timer systemd, cron: GitHub Actions, AWS EventBridge, schedule Kubernetes CronJob, atau scheduler apa pun yang kompatibel dengan cron. Jangan lupa memverifikasi zona waktu scheduler target — lihat bagian Praktik Terbaik di bawah.

Kesalahan Cron yang Sering Terjadi

# Maksud: "Jumat pertama dalam bulan"
0 0 1-7 * 5
# Sebenarnya: menyala pada tanggal 1-7 ATAU setiap Jumat — kedua kondisi

# Gunakan wrapper untuk semantik AND yang sebenarnya
0 0 * * 5  [ $(date +\%d) -le 7 ] && /skrip-anda
# ATAU jatuhkan satu kondisi dan terima jadwal yang lebih longgar

# Ditulis oleh dev US East, di-deploy ke server UTC
0 9 * * *  /laporan-anda.sh
# Menyala pukul 09.00 UTC = 04.00 US East — bukan yang dimaksud dev

# Kunci zona waktu, atau tulis dalam UTC secara eksplisit
CRON_TZ=America/New_York
0 9 * * *  /laporan-anda.sh

# Maksud: tiap 15 menit
15 * * * *
# Sebenarnya: sekali per jam, pada menit 15 (4 jalanan/jam lebih sedikit dari yang dimaksud)

# Benar
*/15 * * * *
# Tiap 15 menit: menit 0, 15, 30, 45 tiap jam

# Quartz 6 kolom disalin ke crontab Linux
0 0 9 * * 1-5
# Linux membaca: menit=0, jam=0, tanggal=9, bulan=*, hari=1-5
# = tengah malam pada tanggal 9 di bulan yang cocok dengan hari kerja — kacau

# POSIX 5 kolom, jatuhkan detik
0 9 * * 1-5
# = hari kerja pukul 09.00

# 30 atau 31 Februari — tidak pernah berjalan
0 0 30 2 *
0 0 31 2 *
# Terurai tetapi tidak ada jadwal yang pernah menyala

# Gunakan pola 'hari kerja terakhir Februari' via skrip
0 0 28-29 2 *  [ $(date -d tomorrow +\%m) = 03 ] && /skrip-anda

# Quartz: 'Jumat terakhir bulan' — tidak valid di POSIX
0 0 ? * 6L *

# Pendekatan skrip wrapper POSIX untuk Jumat-terakhir
0 0 25-31 * 5  /skrip-anda
# Berjalan pada Jumat antara tanggal 25-31 bulan mana pun

Kasus Penggunaan Umum

Job Crontab Linux

Bangun dan verifikasi entri untuk /etc/crontab, /etc/cron.d/*, atau file crontab -e per pengguna. Gunakan pratinjau jadwal berikutnya untuk memastikan jadwal jatuh pada waktu yang tepat di zona waktu server Anda yang dikonfigurasi sebelum menyimpan.

Jadwal Kubernetes CronJob

Hasilkan kolom spec.schedule untuk Kubernetes CronJob. Kubernetes 1.27+ juga mendukung spec.timeZone — gunakan saklar UTC untuk merancang jadwal Anda dalam UTC, lalu setel timeZone secara eksplisit untuk menghindari waktu lokal node worker.

Alur Kerja Terjadwal GitHub Actions

Bangun entri cron: di bawah on.schedule. GitHub Actions selalu berjalan di UTC — alihkan pratinjau ke UTC untuk memastikan jadwal Anda. Hindari interval lebih pendek dari 15 menit; scheduler GitHub melewatkan job interval pendek di bawah beban.

Aturan AWS EventBridge

Susun ekspresi cron untuk aturan terjadwal EventBridge. Catatan: AWS menggunakan sintaksis enam kolom gaya Quartz dengan ? untuk hari — alat ini menghasilkan POSIX lima kolom, yang perlu Anda konversi dengan menambahkan detik (0) di depan dan mengganti * di salah satu kolom tanggal/hari dengan ?.

Pipeline Terjadwal GitLab CI

Verifikasi ekspresi cron untuk pipeline CI terjadwal di GitLab. GitLab menggunakan sintaksis POSIX lima kolom — yang dihasilkan alat ini — dan pemilih tanggal UI, tetapi bentuk cron memberi Anda kontrol lebih halus untuk interval non-standar.

Cloudflare Workers Cron Triggers

Bangun entri [triggers.crons] di wrangler.toml. Cloudflare menggunakan sintaksis POSIX lima kolom. Interval minimum satu menit; worker berjalan di UTC. Gunakan pratinjau untuk memverifikasi trigger menyala dalam jendela yang Anda harapkan.

Jadwal node-cron Node.js

Bangun ekspresi untuk pustaka node-cron, yang mendukung baik POSIX lima kolom maupun kolom detik di depan yang opsional. Pertahankan lima kolom kecuali Anda secara khusus memerlukan presisi di bawah menit — ekspresi enam kolom tidak portabel ke crontab Linux.

Tinjauan Kode dan Dokumentasi

Tempel ekspresi cron dari PR atau runbook untuk langsung melihat apa yang dilakukannya — tidak perlu lagi menebak 30 7 * * 1-5 atau mencari kartu referensi. Deskripsi bahasa biasa juga bagus untuk komentar inline dan file README.

Referensi Sintaksis Cron

Urutan Kolom: M J T B H

Menit (0-59), Jam (0-23), Tanggal (1-31), Bulan (1-12), Hari (0-6, 7 juga = Minggu). Mnemonik: "Menit Jam Tanggal Bulan Hari". Kolom hari menerima baik token numerik (0-6) maupun bernama (SUN-SAT, tidak case-sensitive).

Operator

* = sembarang nilai; , = pemisah daftar (1,3,5); - = rentang (1-5); / = langkah (*/15, 5/10); nama: JAN-DEC untuk bulan, SUN-SAT untuk hari (tidak case-sensitive).

Makro (Alias)

@yearly = 0 0 1 1 *; @annually = 0 0 1 1 *; @monthly = 0 0 1 * *; @weekly = 0 0 * * 0; @daily = 0 0 * * *; @midnight = 0 0 * * *; @hourly = 0 * * * *. @reboot merupakan non-jadwal khusus (hanya berjalan saat boot) dan ditolak dengan kesalahan yang menjelaskan.

Semantik Hari POSIX (Aturan OR)

Ketika KEDUA kolom tanggal dan hari dibatasi (tidak ada yang *), jadwal berjalan saat SALAH SATU cocok — semantik OR. Ketika hanya satu yang dibatasi, yang itulah yang menentukan. Ketika keduanya *, setiap hari cocok. Aturan OR ini berlaku untuk vixie cron, BSD cron, dan sebagian besar implementasi POSIX; Quartz menggunakan ? untuk membedakan AND vs OR.

Mode Enam Kolom (Quartz-Lite)

Jika masukan Anda memiliki enam token yang dipisahkan spasi, alat memperlakukan yang pertama sebagai kolom detik (0-59). Berguna untuk Quartz, Spring @Scheduled(cron=...), dan node-cron. TIDAK portabel ke crontab Linux atau scheduler POSIX — mereka akan memperlakukan detik Anda sebagai menit dan menggeser semuanya satu posisi.

Penambatan Operator Langkah

*/N ditambatkan ke nilai terendah kolom: */15 di menit = 0,15,30,45, bukan "tiap 15 mulai sekarang". Dengan basis non-wildcard: 5/15 di menit = 5,20,35,50. Nilai langkah yang tidak membagi rentang kolom secara merata akan melompat di dekat wraparound — ini benar, bukan bug.

Batas Validasi

menit ∈ [0,59], jam ∈ [0,23], tanggal ∈ [1,31], bulan ∈ [1,12], hari ∈ [0,7]. Nilai di luar rentang menghasilkan kesalahan pada level kolom. Tanggal TIDAK divalidasi terhadap bulan (0 0 31 2 * terurai baik tetapi tidak pernah cocok karena Februari tidak memiliki tanggal 31 — pratinjau jadwal berikutnya akan menunjukkan "Tidak ada jadwal mendatang").

Operator Quartz Ditolak

Cron POSIX tidak mendukung ? (tanpa nilai spesifik), L (terakhir), W (hari kerja terdekat), atau # (hari ke-n) milik Quartz. Alat ini menolaknya dengan pesan jelas "Operator Quartz tidak didukung" alih-alih diam-diam mengurainya sebagai POSIX yang tidak valid. Untuk jadwal Quartz, gunakan alat yang sadar Quartz atau scheduler Spring.

Batas Tahun pada Pencarian Jadwal Berikutnya

Perhitungan jadwal berikutnya mencari hingga 4 tahun ke depan; ekspresi yang cocok lebih jarang dari itu (mis., pola "29 Feb") akan menunjukkan "Tidak ada jadwal mendatang dalam 4 tahun ke depan". Ini disengaja untuk menghindari iterasi tak terbatas pada pola yang mustahil.

Praktik Terbaik untuk Jadwal Cron

Gunakan UTC di Server, Konversi saat Tampilan

Setel server Anda ke UTC (/etc/timezone atau TZ=UTC) dan tulis semua ekspresi cron dalam UTC. Konversi ke waktu lokal hanya saat tampilan di dasbor dan laporan Anda. Ini menghilangkan seluruh kategori bug zona waktu yang menghantam paling keras selama transisi daylight-saving, ketika jadwal waktu lokal diam-diam menyala dua kali atau melewatkan satu jalanan. Gunakan saklar UTC pada alat ini untuk merancang jadwal Anda dalam UTC sejak awal.

Hindari Jebakan OR Tanggal/Hari POSIX

Jangan pernah membatasi tanggal DAN hari kecuali Anda menginginkan semantik OR. Jika Anda ingin "setiap Senin di Januari", tulis 0 0 * 1 1 (tanggal adalah *); jika Anda ingin "tanggal 1 tiap bulan", tulis 0 0 1 * * (hari adalah *). Aturan OR POSIX berarti 0 0 1 * 1 berjalan tiap tanggal 1 DAN setiap Senin — hampir pasti bukan yang Anda inginkan. Pratinjau jadwal berikutnya akan menangkap ini jika Anda memeriksa sebelum deploy.

Kunci Zona Waktu Jadwal Secara Eksplisit

Scheduler modern mendukung penambatan zona waktu dalam definisi jadwal: CRON_TZ=America/New_York di bagian atas crontab (vixie cron 3.0+), spec.timeZone: "America/New_York" untuk Kubernetes CronJobs 1.27+, ekspresi jadwal dengan ScheduleExpressionTimezone untuk AWS EventBridge Scheduler. Kunci zona waktu secara eksplisit alih-alih mengandalkan default server — zona waktu server dapat berubah tanpa peringatan selama migrasi infrastruktur.

Sebarkan Beban di Antara Menit, Bukan pada :00

Hindari 0 * * * * (tiap jam pada menit 0) untuk job non-kritis — pada skala besar, menjadwalkan banyak hal tepat pada :00 menciptakan lonjakan beban. Pilih offset menit acak (23 * * * *, 41 * * * *) untuk tiap job untuk menyebarkan beban. Hal yang sama berlaku untuk job harian: 30 3 * * * lebih ramah pada basis data Anda dibanding 0 3 * * * ketika banyak job berkonvergensi pada pukul 03.00.

Buat Job Idempoten

Cron tidak memiliki retry bawaan, tidak ada pencegahan tumpang tindih, tidak ada pemulihan jalanan yang terlewat. Job Anda harus aman dijalankan berkali-kali (idempoten) dan memeriksa diri. Alih-alih "kirim laporan pukul 09.00", rancang sebagai "kirim laporan hari ini jika belum terkirim" — ini menyembuhkan diri setelah downtime, jadwal ganda tak sengaja, dan jalanan bersamaan. Idempotensi adalah properti job, bukan scheduler, dan inilah praktik keandalan paling penting.

Tambahkan Heartbeat untuk Jadwal Kritis

Mode kegagalan diam cron merupakan kelemahan terbesarnya — jika jadwal tidak menyala, tidak ada yang memberi tahu Anda. Untuk job kritis, minta job melakukan ping layanan heartbeat (Healthchecks.io, Cronitor, Dead Man's Snitch) di akhir tiap jalanan; layanan memperingatkan Anda jika ping yang diharapkan tidak tiba. Ini menangkap baik job yang gagal maupun jadwalnya sendiri yang salah nyala. Tier gratis mencakup sebagian besar kebutuhan personal dan tim kecil.

Verifikasi dengan Pratinjau Jadwal Berikutnya Sebelum Mengirim

Sebelum men-deploy jadwal cron baru, lihat lima datetime jadwal mendatang di pratinjau alat ini. Bolak-balik antara Lokal dan UTC. Pastikan jadwal jatuh saat Anda inginkan — bukan lima menit lebih awal, bukan di hari yang salah, bukan melewatkan akhir pekan yang Anda pedulikan. Pratinjau adalah uji produksi yang paling murah.

Pertanyaan yang Sering Diajukan