Cron 式ジェネレーター

Cron Expression Generator の使い方

1. 5 分ごと、1 時間ごと、毎日 0 時、平日 09:00、毎月 1 日といったプリセットから始めます。プリセットは下のフィールド操作部に反映されるので、そこから調整を続けられます。
2. 各フィールドは 5 つのモードで指定できます。アスタリスクだけの Every、*/15 のような刻みの Every N、9-17 のような範囲の Range、1,15,30 のような列挙の List、単一の数値を指定する Exact です。
3. 式がリアルタイムで更新されるので、それを確認してから crontab や CI 設定、CronJob マニフェストにコピーします。
4. 下に表示される次回以降 6 回の実行時刻を確認します。フィールドを取り違えた設定に気づく最短の方法です。

こんなときに使えます

• 業務時間が始まる前に終わらせる必要がある、夜間のデータベースバックアップをスケジュールする。
• ログを週次または月次の一定間隔でローテーションまたはアーカイブする。
• 1 日のトラフィックのピーク前にキャッシュを温めたり、検索インデックスを再構築したりする。
• 毎週月曜の朝にレポートを送る、あるいは請求のために毎月 1 日に処理を実行する。
• 夜間の CI ビルドや、定期的な証明書更新チェックを起動する。

間違いの原因になりやすい cron 構文のルール

5 つのフィールドは順に分・時・日・月・曜日です。意図しないスケジュールの多くは、誤読しやすいいくつかの意味論に起因します。

• 日と曜日の両方にアスタリスク以外を指定した場合、cron は AND ではなく OR で組み合わせます。したがって 0 0 13 * FRI は「毎月 13 日または毎週金曜日」であって、「13 日の金曜日だけ」ではありません。
• */15 のような刻みは 0 から始まり 15 単位ごとに繰り返すため、0、15、30、45 になります。5/15 と書いた場合は 5 から始まって上限まで進むため、5、20、35、50 になります。
• 曜日フィールドでは 0 と 7 のどちらも日曜日を意味するため、同じスケジュールを 2 通りに書けます。
• 月と曜日は JAN から DEC、MON から SUN といった 3 文字の名前も受け付けます。
• cron はスケジュールを保持しているマシンのローカルタイムゾーンで動作するため、デプロイ前にタイムゾーンを確認してください。夏時間の切り替え時には、時間単位の実行枠が飛んだり重複したりすることがあります。

cron ジェネレーターと cron パーサー

このサイトの cron パーサーは逆の課題を解きます。すでに式があり、その意味と次回の実行時刻を知りたい場合に使うものです。このジェネレーターはその反対方向で、言葉で説明できるスケジュールを正しい構文に変換します。両者は補完関係にあるため、式を生成した後にパーサーへ貼り付けて、独立した二重チェックとして使えます。

スケジュールをデプロイする前のチェック

一見正しそうな式でも、実際のサーバーでは意図しないタイミングで動くことがあります。短い見直しでその大半は防げます。

• 次回以降 6 回の実行時刻を意図と照らし合わせます。特に 1 回目は、フィールドのずれによる誤りをすぐに露呈させてくれます。
• 実行するマシンやコンテナーのタイムゾーンを確認し、地域をまたぐシステムでは UTC を優先してください。
• 負荷の重いジョブは 0 分に集中させず、異なる分に分散させてください。
• ホストが停止していて実行が飛んだ場合にどうすべきかを決めておきます。標準の cron は逃した実行を後から取り戻しません。