cron式を解説:スケジュール、特殊文字列、落とし穴
5つの小さなフィールドが、インターネットのバックグラウンドジョブの半分を動かしています。午前2時のバックアップ、月曜のレポート、5分ごとのキャッシュ削除。cronの読み書きを学び、日にちの罠を回避しましょう。
このガイドで学べること
- 5フィールドのcron式を声に出して読めるようになる
- リスト、範囲、ステップ、名前を正しく使う
- 誰もが必要とする10のスケジュールを書く
- @daily、@weeklyなどの特殊文字列を使う
- 「日」と「曜日」の罠、サマータイムのスキップ、タイムゾーンのバグを避ける
- cronとは
- 構造:5つのフィールド
- 特殊文字列:ショートカット
- 誰もが必要とする10のスケジュール
- タイムゾーン、サマータイム、環境
- よくあるミス
- 試してみる:Cron Explainer
- よくある質問
cronとは
Cron は、1970年代からUnix系システムに組み込まれている時間ベースのジョブスケジューラです。次のように1行書きます。 crontab — スケジュールとコマンドの組み合わせです。cronデーモンは、スケジュールに一致するたびにそのコマンドを実行します。バックアップ、ログローテーション、証明書の更新、レポートメール。インターネットの退屈で不可欠な雑務のほとんどは、誰かが一度書いて忘れたcronの行です。
この仕組みは意図的に小さく作られています。プログラミングもキューもリトライロジックもありません。「時計がこの状態になったら、あれを実行する」だけです。そのシンプルさこそが生き残っている理由であり、クセを回避するのではなく学ぶ価値がある理由です。
構造:5つのフィールド
┌───────── minute (0–59) │ ┌─────── hour (0–23) │ │ ┌───── day of month (1–31) │ │ │ ┌─── month (1–12) │ │ │ │ ┌─ day of week (0–7, both 0 and 7 are Sunday) │ │ │ │ │ * * * * * command to run
| フィールド | 値 | 例 |
|---|---|---|
| 分 | 0–59 | 0 = 毎時0分 |
| 時 | 0–23 | 2 = 午前2時 |
| 日 | 1–31 | 1 = 1日 |
| 月 | 1–12 or JAN–DEC | 1 = 1月 |
| 曜日 | 0–7 or SUN–SAT | 1 = 月曜日 |
各フィールドは4つの表記法を受け付けます。単一の値(2)、リスト(1,15)、範囲(1-5)、ステップ(*/5 = 5分ごと、 2-30/10 = 2時、12時、22時)。名前も使えます — MON-FRI のほうが読みやすいですが、 1-5 — ただし、1つのフィールドで名前と数字を混ぜるのはトラブルのもとです。
特殊文字列:ショートカット
| 文字列 | 意味 | 同等 |
|---|---|---|
@reboot | 起動時に1回 | — |
@yearly / @annually | 年に1回 | 0 0 1 1 * |
@monthly | 月に1回 | 0 0 1 * * |
@weekly | 週に1回 | 0 0 * * 0 |
@daily / @midnight | 1日に1回 | 0 0 * * * |
@hourly | 1時間に1回 | 0 * * * * |
これらはVixie cron(Linuxの標準)やほとんどのクラウドスケジューラでサポートされていますが、すべての実装で使えるわけではありません。頼る前に確認してください、 @reboot あまり一般的でない環境では特に。
誰もが必要とする10のスケジュール
0 2 * * * every day at 2:00am (the classic backup slot) */5 * * * * every 5 minutes 0 9 * * 1-5 weekdays at 9:00am 0 0 1 * * the 1st of every month at midnight 0 0 * * 0 Sundays at midnight 30 4 1,15 * * 1st and 15th at 4:30am 0 8-18 * * * every hour from 8am to 6pm 0 0 * * 6 Saturdays at midnight 15 3 * * * every day at 3:15am 0 12 25 12 * Christmas Day at noon
なぜバックアップは午前2時なのでしょうか。その時間はシステムを使っている人が最も少なく、ジョブが長引いても誰かが気づくまでに最も多くの時間が残っているからです。この慣習は、それに従うほとんどのエンジニアよりも古いものです。
タイムゾーン、サマータイム、環境
cronは システムのローカル時間で動作します。UTCではありません。デーモンの設定が別になっていない限りそうです。サーバー上のタイムゾーンは、あなたが思っているものとは限りません。午前2時に予定したジョブが午前10時に実行されるのは、通常はスケジュールの不具合ではなくタイムゾーンの不一致です。必ずそのマシン上で date を確認してください。
サマータイムは年に2回、厄介なケースをもたらします。春には午前2:00~2:59が存在しないため、午前2:30のジョブはその日まったく実行されません。秋にはその時間帯が2回訪れるため、ジョブが2回実行されます。重要なジョブを午前2:30に予定すると、このことを痛い目に遭って知ることになります。午前3時のほうが安全です。
cronは最小限の環境で実行されることも覚えておいてください。シェルの PATH、変数、エイリアスはありません。絶対パスを使い(/usr/bin/python3 /opt/backup.py)、出力をログファイルにリダイレクトしてください。そうしないと失敗が黙って消えてしまいます。静かに失敗するcronジョブは、まったく動かないジョブよりたちが悪いです。
よくあるミス
- 「日」フィールドの罠。 Vixie cronでは、「日」と「曜日」の両方が指定されている場合、ジョブは どちらか一方 に一致したとき(OR)に実行され、両方に一致したときではありません。
0 0 1 * 1は毎月1日に実行され そして 毎週月曜日にも実行されます。「1日である月曜日」ではありません。これはcronで最も誤解されているルールです。 */5と5. 前者は5分ごと、後者は1時間に1回、5分に実行されます。抜けた*/があると、頻繁なジョブがまれなジョブになってしまいます。- crontabの末尾の改行を忘れること。 一部のcronでは、ファイルが改行で終わっていないと最後の行が黙って無視されます。
%がコマンドの中にある場合。 crontabでは、%は改行を意味します。コマンドが分割されてしまいます。次のようにエスケープするか、\%ロジックをスクリプトに移してください。- 秒フィールドがあると思い込むこと。 古典的なcronには5つのフィールドがあり、秒はありません。Quartzや一部のクラウドスケジューラは6つまたは7つ(秒が最初)を使います。6フィールドの式を5フィールドのcrontabにコピーすると、すべてのフィールドがずれて、まったく別のスケジュールになってしまいます。
- ログを取らないこと。
* * * * * /opt/job.sh >> /var/log/job.log 2>&1— 常にそうしてください。
試してみる:Cron Explainer
Cron Explainerに任意の式を入力すると、平易な英語でいつ実行されるかを教えてくれます。さらに次の10回の実行時刻も表示されます。このガイドの難しい例は、まずそこで試してみてください。
さらに学ぶ
よくある質問
2時間ごとに何かを実行するにはどうすればいいですか?
0 */2 * * * — 分は0、2時間ごと。90分ごとにはきれいなcron式がありません。30分ごとに実行し、スクリプト側で90分経ったかを確認するか、systemdタイマーを使ってください。
平日のみジョブを実行するにはどうすればいいですか?
0 9 * * 1-5 — 曜日フィールドの1-5は月曜から金曜です。名前も使えます:0 9 * * MON-FRI。0と7はどちらも日曜日です。
コンピュータの電源が切れていてもcronは実行されますか?
いいえ。cronはマシンが動いている間のみ実行されます。午前2時にスリープしていたノートパソコンは、そのジョブを単に逃してしまいます。ノートパソコンでは、復帰時に追いつくツール(Linuxのanacron、macOSのlaunchd)を使うか、稼働時間に合わせてスケジュールしてください。
crontabを編集するにはどうすればいいですか?
crontab -eでスケジュールをエディタで開きます。crontab -lで一覧表示、crontab -rで削除します(注意:取り消しはできません)。システム全体のジョブは/etc/crontabと/etc/cron.d/にあり、各行にユーザー欄が追加されています。
待たずにcron式をテストするにはどうすればいいですか?
Cron Explainerツールに貼り付けると、式が平易な英語に翻訳され、次の10回の実行時刻が一覧表示されます。間違ったフィールドが、来週の火曜日ではなくすぐに分かります。