Menulis ekspresi cron yang tidak memicu kejutan

Ekspresi cron klasik terdiri dari lima field yang dipisah spasi: menit (0–59), jam (0–23), tanggal (1–31), bulan (1–12), dan hari (0–7). Setiap field menerima satu nilai, daftar berkoma, rentang ber-tanda hubung, langkah setelah garis miring, atau tanda bintang untuk semua nilai.

Kebanyakan bug cron bukan sintaks eksotis melainkan field biasa yang dibaca ceroboh: langkah yang ter-reset di batas rentang, atau field jam yang ditulis untuk jam dua belas dalam sistem yang menghitung sampai dua puluh tiga.

• DaftarDaftar memilih nilai diskrit: 0,30 di field menit menyala pada menit nol dan menit tiga puluh setiap jam.
• Rentang dan langkahRentang memilih satu span: 9-17 di field jam mencakup jam kerja, dan langkah menipiskannya—9-17/2 menyala setiap dua jam di dalam span itu.
• Bintang cocok semuaTanda bintang bukanlah “abaikan field ini”; ia aktif mencocokkan setiap nilai, yang menjadi penting begitu dua field hari berinteraksi.

Field bulan dan hari menerima nama Inggris tiga huruf—JAN sampai DEC dan SUN sampai SAT—sebagai alias angkanya. 0 9 * JAN MON dan 0 9 * 1 1 adalah jadwal yang sama, tetapi versi bernama menjelaskan dirinya kepada pembaca berikutnya dan tahan terhadap edit off-by-one.

• Tanpa huruf besar-kecilNama diparse tanpa membedakan huruf besar-kecil—mon, Mon, dan MON semuanya bisa—tetapi huruf besar adalah konvensi yang terbaca disengaja.
• Nama dalam rentangNama juga bekerja di dalam rentang dan daftar: MON-FRI adalah span hari kerja standar, dan JAN,APR,JUL,OCT memilih bulan-bulan triwulanan.
• Baca penjelasannyaPembuat dan penjelas Cron menormalkan ekspresi dan menjelaskan setiap field secara terpisah—“month: every value”, “weekday: 1, 2, 3, 4, 5”—sehingga Anda bisa memastikan parser membaca nama persis seperti maksud Anda.

Alat ini mengikuti aturan hari bergaya Vixie: bila kedua kolom hari tidak diawali *, kecocokan salah satu kolom sudah cukup. 0 9 13 * FRI bukan berarti “Jumat tanggal 13”; artinya tanggal 13 setiap bulan dan setiap hari Jumat.

Output penjelas eksplisit soal ini: ia melaporkan semantiknya sebagai dom-dow-or di samping eksekusi yang dihitung, sehingga ekspresi yang akan menyala jauh lebih sering dari maksudnya menunjukkan belangnya sebelum masuk crontab.

• Langkah wildcard tetap membatasiJika kolom hari diawali *, termasuk langkah seperti */2, alat ini mensyaratkan kedua kolom hari cocok; pembatasan langkah tetap berlaku.
• Tanpa wildcard awal berarti ORBila tidak ada kolom hari yang diawali *, alat ini menerapkan OR: tanggal dalam bulan atau hari dalam pekan boleh cocok.
• AND butuh akal-akalanUntuk benar-benar mengenai Jumat tanggal 13, biarkan cron memilih tanggal 13 dan minta perintahnya sendiri memeriksa hari—atau pakai penjadwal dengan semantik AND, yang bukan cron klasik.

Field hari menomori Minggu sebagai 0, Senin sebagai 1, dan seterusnya sampai Sabtu sebagai 6. Sebagian besar implementasi juga menerima 7 sebagai Minggu kedua bagi yang menghitung dari Senin—parser Toolars menormalkan 7 menjadi 0 secara internal—tetapi sebagian sistem hanya menerima salah satu, dan penomoran gaya ISO yang memulai Senin di 1 ada di tempat lain.

• 0 dan 70 dan 7 sama-sama Minggu di tempat 7 diterima; menulis 0 adalah pilihan yang portabel lintas penjadwal.
• Off-by-one diam-diamHari bernilai 7 pada sistem yang menolaknya gagal dengan keras saat deploy, tetapi hari yang salah dibaca sebagai “hari ketujuh dihitung dari Senin” gagal diam-diam di hari yang salah.
• Konfirmasi per platformKetika ekspresi berpindah antar implementasi—crontab sistem, platform kontainer, penjadwal CI—konfirmasi ulang penomoran harinya alih-alih mengasumsikannya selamat dalam perjalanan.

Peralihan waktu musim panas menciptakan menit lokal yang hilang atau berulang. Pratinjau ini melewatkan waktu yang tidak ada, seperti 02:30 saat jam maju, dan menampilkan menit cocok yang berulang dua kali saat jam mundur. Penjadwal yang diterapkan mungkin mengejar jadwal yang terlewat atau menekan duplikat; periksa kebijakannya.

• Jam yang hilangCelah saat jam maju: pratinjau tidak menemukan menit 02:30 yang cocok; sebagian penjadwal menjalankan tugas yang terlewat setelah peralihan.
• Jam yang menggandaTumpang tindih saat jam mundur: pratinjau dapat menampilkan kedua waktu yang cocok, sedangkan penjadwal nyata mungkin menekan eksekusi kedua.
• UTC tanpa DSTJalan keluar yang bersih adalah UTC: tidak ada transisi daylight saving, jadi 30 2 * * * berarti momen yang sama setiap hari sepanjang tahun. Penjelas menawarkan UTC, zona lokal perangkat, dan zona bernama seperti America/New_York dan Europe/London.

Perbedaan antara ekspresi yang benar dan yang kelihatan masuk akal adalah daftar waktu penyalaan yang konkret. Pembuat dan penjelas Cron menghitung sepuluh eksekusi berikutnya dari sekarang dalam zona waktu pilihan Anda, mencari hingga 366 hari ke depan, dan mengevaluasi di worker latar sehingga ekspresi berat tidak bisa menghentikan tab.

• Baca eksekusinyaBaca beberapa eksekusi pertama terhadap maksud: “hari kerja pukul 09:00” harus menampilkan Senin sampai Jumat pukul sembilan, dan satu Sabtu di daftar adalah jebakan OR yang mengumumkan dirinya.
• Lintasi satu transisiPilih zona waktu bernama dan periksa jadwal berikutnya bila peralihan waktu musim panas mendatang berada dalam pratinjau 366 hari. Ruang kerja memulai dari sekarang; Anda tidak dapat memilih tanggal awal sendiri.
• Error eksplisitEkspresi tidak valid menghasilkan kesalahan. Nol kecocokan dalam 366 hari menghasilkan kesalahan batas pencarian; satu hingga sembilan kecocokan dikembalikan sebagai hasil parsial, bukan daftar kosong.