cron

どのようなものか

cronは、起動する人がログインしていなくても、決めた時刻にコマンドを開
始するUnixのサービスです。利用者ごとの予定は、crontabに保存します。
一行に一つのジョブを書く、プレーンテキストの表です。同じ名前の
`crontab`コマンドで、その表の登録、表示、削除を行います。

POSIXが標準化しているのは、コマンドと表の形式であり、表を読むプログ
ラムではありません。その根拠説明にも、「cronデーモンとcronファイルへ
の言及は、すべて省いた」と明記しています。どのデーモンがジョブを実行
するかは、各システムに委ねています。このページが参照するcronのマニュ
アルはcronieのものです。そのcrontab(5)は、著者としてPaul
Vixieを挙げ、互換性を保つ拡張を加えたV7形式と説明しています。

一行は、空白で区切る六つのフィールドからなります。最初の五つが時刻で
す。分（0から59）、時（0から23）、日（1から31）、月（1から12）、曜日
（0から6で、0は日曜日）を表します。各フィールドには、すべての値を表
すアスタリスク、数値、`1-5`のようなハイフンで区切る範囲、または、そ
れらをコンマで並べた一覧を書きます。六つ目は、`sh`が実行するコマンド
です。標準が定めるのは、ここまでです。`*/15`のような間隔の指定、
`mon`のような三文字の名前、日曜日を表す`7`、システム用の表の利用者名
の列、`@daily`のような省略形は、cronieの拡張です。それらを使う表は、
ほかのシステムへそのまま移せるとは限りません。

`crontab -e`は表をエディターで開き、`crontab -l`は表示し、
`crontab -r`は削除します。`crontab
file`は、ファイルの内容で表を置き換えます。cronieは、システム用の表
を`/etc/crontab`と`/etc/cron.d/`にも保持します。そこでは、時刻とコマ
ンドの間に、実行する利用者を指定するフィールドを追加します。POSIX
も、そのような実装を想定していました。根拠説明は、BSD由来のシステム
では、利用者のフィールドを追加する可能性が高いと述べています。

なぜ重要なのか

サーバーの保守の多くは、誰も見ていない間に行います。古いファイルの削
除、レポートのメール送信、データベースのダンプ、バックアップです。
cronは、「これを午前三時に実行する」と指定する標準的な方法です。
POSIXのページの変更履歴によると、このユーティリティーはIssue
2から標準に含まれています。POSIXのフィールドだけを使う表なら、準拠す
るどのシステムでも、同じ意味で読めます。

弱点も、仕組みそのものにあります。定期実行するジョブを見届ける人はい
ないため、不具合が起きても画面が赤くなるわけではありません。POSIX
は、コマンドがリダイレクトしなかった出力とエラーを、各実装の選ぶ方法
で利用者へメール送信すると定めています。ローカルメールがどこにも届か
ないホストでは、エラーの通知も届かないままです。cronの問題の多くは、
この沈黙に行き着きます。

現在は、近い役割を持つ二つの仕組みも、この仕事を担います。systemdで
動くLinuxシステムでは、タイマーユニットで同じジョブを開始でき、cron
にない機能も加わります。電源が切れていた間の未実行分を後から実行で
き、開始時刻をランダムに分散でき、実行中のサービスを二重に起動するこ
ともありません。PostgreSQL内では、`pg_cron`拡張が、同じ五フィールド
の予定を読み、データベース内のバックグラウンドワーカーがジョブを管理
します。当社のRiverジョブキューのプロジェクトが一例です。そのページ
は、2026年10月時点で、キューの下に20個の`pg_cron`ジョブがあると記し
ています。パーティションの削除、ソルトの更新、集計値の再計算を行い、
ページがデータベースの責務とする保守を担います。

実際の活用例

平日のファイル整理と、毎晩のデータベースのダンプという二つのジョブを
考えます。ジョブはログインシェルの設定を引き継がないため、表の先頭で
実行環境を設定します。`NAME=value`の行と`MAILTO`変数は、POSIXではな
くcronieの機能です。

```text
SHELL=/bin/sh
PATH=/usr/local/bin:/usr/bin:/bin
MAILTO=ops@example.com
i# 分 時 日 月 曜日 コマンド		engineer.company	70
15 3 * * 1-5 find "$HOME" -name core -exec rm -f {} +
30 2 * * * flock -n /var/lock/dump-db dump-db >> "$HOME/dump.log" 2>&1
0 * * * * date +\%s >> "$HOME/hourly.log"
```

最初のジョブは、「月曜日から金曜日の03:15」と読みます。二つ目は毎晩
02:30に実行し、出力とエラーをログへ書きます。全体を`flock
i-n`で囲んでいるため、ロックが既に取られていれば、待たずにすぐ終了し		engineer.company	70
iます。ダンプに時間がかかっても、同じ処理が重複して動くことはありませ		engineer.company	70
iん。三つ目は、エスケープしたパーセント記号の例です。バックスラッシュ		engineer.company	70
iがなければ、cronは`%`の位置でコマンドを区切ります。		engineer.company	70

現在登録されている表を直接編集するのではなく、バージョン管理するファ
イルに保存し、全体を登録します。

```sh
crontab jobs.cron
crontab -l
```

二つ目のコマンドは、cronが実際に読むものを表示します。cronieの`-T`オ
プションでは、登録前にファイルの構文を検査できます。ファイルの末尾に
は、改行が必要です。

同じ毎晩のダンプをsystemdタイマーで行うには、二つのユニットを使いま
す。サービスが実行する内容を、タイマーが時刻を定めます。

```ini
i# /etc/systemd/system/dump-db.service		engineer.company	70
[Service]
Type=oneshot
ExecStart=/usr/local/bin/dump-db

i# /etc/systemd/system/dump-db.timer		engineer.company	70
[Timer]
OnCalendar=*-*-* 02:30:00
Persistent=true
RandomizedDelaySec=10min

[Install]
WantedBy=timers.target
```

`Persistent=true`は、最後の実行時刻をディスクに保存し、タイマーが再
開するとすぐに未実行分を開始します。`RandomizedDelaySec=`は、最大で
10分のランダムな遅延を加えます。同じファイルを配った多数のマシンが、
同じ秒にデータベースサーバーへアクセスしないようにするためです。
`systemd-analyze
calendar '*-*-*
02:30:00'`は、正規化した式と次の発火時刻を表示します。予定を信頼する
前に確かめる、最も手早い方法です。

予定が示すのは、ジョブがいつ始まるかであり、仕事を果たしたかではあり
ません。当社の464
MBのホストでは、デッドマンズスイッチで、これを逆に捉えています。タイ
マーは、一時間に四回、時刻に揺らぎを加えてスクリプトを開始します。ス
クリプトが外部サービスへ生存通知を送るのは、メモリーもディスクも、残
量がしきい値を下回っていない場合だけです。通知が途絶えると、警報が鳴
ります。

問題が起きるところ

シェルでは動くコマンドが、cronでは動きません。
POSIXがジョブに保証する環境変数は、`HOME`、`LOGNAME`、`PATH`、
`SHELL`だけです。`PATH`も、標準のユーティリティーを見つけられれば十
分です。プロファイルの設定は、一切読み込みません。絶対パスを使うか、
表の先頭で`PATH`を設定し、同じ最小限の環境でジョブを試します。

エラーが消えます。
リダイレクトしない出力は、メールで送ります。cronieでは、表の所有者
か、`MAILTO`で指定したアドレスへ送信し、`MAILTO=""`なら、どこにも送
りません。誰かが読むログへ出力をリダイレクトします。重要なジョブで
は、先ほどのデッドマンズスイッチのように、成功を報告し、その報告が止
まると異常を知らせる仕組みも使います。

パーセント記号がコマンドを分断します。
コマンドのフィールドでは、`%`は改行となります。最初の行だけを実行
し、残りは標準入力としてそのコマンドへ渡すため、`date
+%s`は壊れます。`\%`とエスケープするか、コマンドをスクリプトへ移して
呼び出します。

日と曜日は、両方に一致する必要はなく、どちらかに一致すれば実行しま
す。
日と曜日の両方を制限すると、どちらかに一致する日にジョブを実行しま
す。POSIX自身の例である`0 0 1,15 *
1`は、1日、15日、毎週月曜日に動きます。制限するのを片方だけにする
か、systemdのカレンダーを使います。`Mon
i*-*-01..07 09:00`なら、曜日と日付の両方が合う場合、つまり、その月の		engineer.company	70
i最初の月曜日だけに一致します。		engineer.company	70

間隔の指定は、毎時、先頭から始まります。
cronieは、間隔を、そのフィールドの範囲内だけで評価します。そのため、
分の`*/35`は、35分おきではなく、:00と:35に動きます。時の`*/23`は、午
前零時と23:00に動きます。範囲を等分できる間隔にするか、最後にサービ
スを開始した時点から数える、systemdタイマーの`OnUnitActiveSec=`を使
います。

時計が切り替わります。
cronieの説明では、夏時間への切り替えで飛ばされた時刻は、一致しないた
め、ジョブを実行しません。同じ時刻が繰り返されれば、二回実行します。
使うタイムゾーンで時刻が切り替わる時間帯を避けるか、`CRON_TZ`を夏時
間のない地域に設定します。

最後の行に改行がありません。
cronieは、すべての項目の末尾に改行を求めます。最後の行にないと、表の
少なくとも一部が壊れていると扱い、syslogに警告を書きます。対策は、末
尾の改行です。エディターの設定や、レビュー時の検査で保証できます。

実行が重複します。
crontabの形式には、前の実行が続いている場合の振る舞いを指定する
フィールドがありません。systemdタイマーは、実行中のサービスには手を
加えません。サービスの実行中に次の予定時刻が過ぎていれば、
`DeferReactivation=`を設定しない限り、完了した瞬間に再びサービスを開
始します。`pg_cron`では、最初の実行が終わるまで、二つ目の実行を待た
せます。通常のcronでは、先ほどの例の`flock
i-n`のように、ロックを使います。		engineer.company	70

マシンの電源が切れていました。
crontabの行が指定するのは、一つの時点です。「その時点を過ぎていた
ら、後で実行する」と指定する方法はありません。systemdで動くマシンな
ら、`OnCalendar=`タイマーに`Persistent=true`を設定します。

すべてのマシンが、一斉に動きます。
百台のホストに同じ表を配ると、同じ分に百個のジョブが始まります。
systemdタイマーでは`RandomizedDelaySec=`を、cronieでは`RANDOM_DELAY`
変数か、`6~15`のようなチルダによる範囲を使います。後者は、表を読んだ
時点で、範囲内から一つの分をランダムに選びます。

引数のない`crontab`が、表を消します。
引数を付けずに実行すると、コマンドは標準入力から新しい表を待ちます。
入力の終わり、通常はCtrl-Dを送ると、現在の表を空の内容で置き換えま
す。代わりに割り込みキーを押します。表は、`crontab
file`で登録するファイルに保持します。

参考資料

  * crontab、POSIX.1-2024 — 標準の六フィールド、既定の環境、メールの
規則、根拠説明を示します。

  * crontab(5)、cronie —
間隔の指定、`MAILTO`、`CRON_TZ`、`RANDOM_DELAY`、夏時間、注意点を説
明します。

  * systemd.timer(5) —
`OnCalendar=`、`Persistent=`、`RandomizedDelaySec=`、実行中のサービ
スを説明します。

  * systemd.time(7) — カレンダーイベントの構文、省略形、検証方法を説
明します。

  * flock(1) — コマンド全体にロックを掛け、取得済みなら`-n`で終了す
る方法を説明します。

  * pg_cron — PostgreSQLの拡張としてデータベース内に保持する、SQL
ジョブ用のcron形式の予定です。

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/cron/	engineer.company	70
