{"canonical_url":"https://engineer.company/ja/glossary/cron/","content_markdown":"# cron\n\n## どのようなものか\n\ncronは、起動する人がログインしていなくても、決めた時刻にコマンドを開始するUnixのサービスです。利用者ごとの予定は、crontabに保存します。一行に一つのジョブを書く、プレーンテキストの表です。同じ名前の`crontab`コマンドで、その表の登録、表示、削除を行います。\n\nPOSIXが標準化しているのは、コマンドと表の形式であり、表を読むプログラムではありません。その根拠説明にも、「cronデーモンとcronファイルへの言及は、すべて省いた」と明記しています。どのデーモンがジョブを実行するかは、各システムに委ねています。このページが参照するcronのマニュアルはcronieのものです。そのcrontab(5)は、著者としてPaul Vixieを挙げ、互換性を保つ拡張を加えたV7形式と説明しています。\n\n一行は、空白で区切る六つのフィールドからなります。最初の五つが時刻です。分（0から59）、時（0から23）、日（1から31）、月（1から12）、曜日（0から6で、0は日曜日）を表します。各フィールドには、すべての値を表すアスタリスク、数値、`1-5`のようなハイフンで区切る範囲、または、それらをコンマで並べた一覧を書きます。六つ目は、`sh`が実行するコマンドです。標準が定めるのは、ここまでです。`*/15`のような間隔の指定、`mon`のような三文字の名前、日曜日を表す`7`、システム用の表の利用者名の列、`@daily`のような省略形は、cronieの拡張です。それらを使う表は、ほかのシステムへそのまま移せるとは限りません。\n\n`crontab -e`は表をエディターで開き、`crontab -l`は表示し、`crontab -r`は削除します。`crontab file`は、ファイルの内容で表を置き換えます。cronieは、システム用の表を`/etc/crontab`と`/etc/cron.d/`にも保持します。そこでは、時刻とコマンドの間に、実行する利用者を指定するフィールドを追加します。POSIXも、そのような実装を想定していました。根拠説明は、BSD由来のシステムでは、利用者のフィールドを追加する可能性が高いと述べています。\n\n## なぜ重要なのか\n\nサーバーの保守の多くは、誰も見ていない間に行います。古いファイルの削除、レポートのメール送信、データベースのダンプ、バックアップです。cronは、「これを午前三時に実行する」と指定する標準的な方法です。POSIXのページの変更履歴によると、このユーティリティーはIssue 2から標準に含まれています。POSIXのフィールドだけを使う表なら、準拠するどのシステムでも、同じ意味で読めます。\n\n弱点も、仕組みそのものにあります。定期実行するジョブを見届ける人はいないため、不具合が起きても画面が赤くなるわけではありません。POSIXは、コマンドがリダイレクトしなかった出力とエラーを、各実装の選ぶ方法で利用者へメール送信すると定めています。ローカルメールがどこにも届かないホストでは、エラーの通知も届かないままです。cronの問題の多くは、この沈黙に行き着きます。\n\n現在は、近い役割を持つ二つの仕組みも、この仕事を担います。systemdで動くLinuxシステムでは、タイマーユニットで同じジョブを開始でき、cronにない機能も加わります。電源が切れていた間の未実行分を後から実行でき、開始時刻をランダムに分散でき、実行中のサービスを二重に起動することもありません。PostgreSQL内では、`pg_cron`拡張が、同じ五フィールドの予定を読み、データベース内のバックグラウンドワーカーがジョブを管理します。当社の[Riverジョブキューのプロジェクト](/ja/portfolio/moved-slow-work-onto-a-river-job-queue/)が一例です。そのページは、2026年10月時点で、キューの下に20個の`pg_cron`ジョブがあると記しています。パーティションの削除、ソルトの更新、集計値の再計算を行い、ページがデータベースの責務とする保守を担います。\n\n## 実際の活用例\n\n平日のファイル整理と、毎晩のデータベースのダンプという二つのジョブを考えます。ジョブはログインシェルの設定を引き継がないため、表の先頭で実行環境を設定します。`NAME=value`の行と`MAILTO`変数は、POSIXではなくcronieの機能です。\n\n```text\nSHELL=/bin/sh\nPATH=/usr/local/bin:/usr/bin:/bin\nMAILTO=ops@example.com\n# 分 時 日 月 曜日 コマンド\n15 3 * * 1-5 find \"$HOME\" -name core -exec rm -f {} +\n30 2 * * * flock -n /var/lock/dump-db dump-db \u003e\u003e \"$HOME/dump.log\" 2\u003e\u00261\n0 * * * * date +\\%s \u003e\u003e \"$HOME/hourly.log\"\n```\n\n最初のジョブは、「月曜日から金曜日の03:15」と読みます。二つ目は毎晩02:30に実行し、出力とエラーをログへ書きます。全体を`flock -n`で囲んでいるため、ロックが既に取られていれば、待たずにすぐ終了します。ダンプに時間がかかっても、同じ処理が重複して動くことはありません。三つ目は、エスケープしたパーセント記号の例です。バックスラッシュがなければ、cronは`%`の位置でコマンドを区切ります。\n\n現在登録されている表を直接編集するのではなく、バージョン管理するファイルに保存し、全体を登録します。\n\n```sh\ncrontab jobs.cron\ncrontab -l\n```\n\n二つ目のコマンドは、cronが実際に読むものを表示します。cronieの`-T`オプションでは、登録前にファイルの構文を検査できます。ファイルの末尾には、改行が必要です。\n\n同じ毎晩のダンプをsystemdタイマーで行うには、二つのユニットを使います。サービスが実行する内容を、タイマーが時刻を定めます。\n\n```ini\n# /etc/systemd/system/dump-db.service\n[Service]\nType=oneshot\nExecStart=/usr/local/bin/dump-db\n\n# /etc/systemd/system/dump-db.timer\n[Timer]\nOnCalendar=*-*-* 02:30:00\nPersistent=true\nRandomizedDelaySec=10min\n\n[Install]\nWantedBy=timers.target\n```\n\n`Persistent=true`は、最後の実行時刻をディスクに保存し、タイマーが再開するとすぐに未実行分を開始します。`RandomizedDelaySec=`は、最大で10分のランダムな遅延を加えます。同じファイルを配った多数のマシンが、同じ秒にデータベースサーバーへアクセスしないようにするためです。`systemd-analyze calendar '*-*-* 02:30:00'`は、正規化した式と次の発火時刻を表示します。予定を信頼する前に確かめる、最も手早い方法です。\n\n予定が示すのは、ジョブがいつ始まるかであり、仕事を果たしたかではありません。当社の464 MBのホストでは、[デッドマンズスイッチ](/ja/portfolio/built-dead-mans-switch-host-monitoring/)で、これを逆に捉えています。タイマーは、一時間に四回、時刻に揺らぎを加えてスクリプトを開始します。スクリプトが外部サービスへ生存通知を送るのは、メモリーもディスクも、残量がしきい値を下回っていない場合だけです。通知が途絶えると、警報が鳴ります。\n\n## 問題が起きるところ\n\n**シェルでは動くコマンドが、cronでは動きません。** POSIXがジョブに保証する環境変数は、`HOME`、`LOGNAME`、`PATH`、`SHELL`だけです。`PATH`も、標準のユーティリティーを見つけられれば十分です。プロファイルの設定は、一切読み込みません。絶対パスを使うか、表の先頭で`PATH`を設定し、同じ最小限の環境でジョブを試します。\n\n**エラーが消えます。** リダイレクトしない出力は、メールで送ります。cronieでは、表の所有者か、`MAILTO`で指定したアドレスへ送信し、`MAILTO=\"\"`なら、どこにも送りません。誰かが読むログへ出力をリダイレクトします。重要なジョブでは、先ほどのデッドマンズスイッチのように、成功を報告し、その報告が止まると異常を知らせる仕組みも使います。\n\n**パーセント記号がコマンドを分断します。** コマンドのフィールドでは、`%`は改行となります。最初の行だけを実行し、残りは標準入力としてそのコマンドへ渡すため、`date +%s`は壊れます。`\\%`とエスケープするか、コマンドをスクリプトへ移して呼び出します。\n\n**日と曜日は、両方に一致する必要はなく、どちらかに一致すれば実行します。** 日と曜日の両方を制限すると、どちらかに一致する日にジョブを実行します。POSIX自身の例である`0 0 1,15 * 1`は、1日、15日、毎週月曜日に動きます。制限するのを片方だけにするか、systemdのカレンダーを使います。`Mon *-*-01..07 09:00`なら、曜日と日付の両方が合う場合、つまり、その月の最初の月曜日だけに一致します。\n\n**間隔の指定は、毎時、先頭から始まります。** cronieは、間隔を、そのフィールドの範囲内だけで評価します。そのため、分の`*/35`は、35分おきではなく、:00と:35に動きます。時の`*/23`は、午前零時と23:00に動きます。範囲を等分できる間隔にするか、最後にサービスを開始した時点から数える、systemdタイマーの`OnUnitActiveSec=`を使います。\n\n**時計が切り替わります。** cronieの説明では、夏時間への切り替えで飛ばされた時刻は、一致しないため、ジョブを実行しません。同じ時刻が繰り返されれば、二回実行します。使うタイムゾーンで時刻が切り替わる時間帯を避けるか、`CRON_TZ`を夏時間のない地域に設定します。\n\n**最後の行に改行がありません。** cronieは、すべての項目の末尾に改行を求めます。最後の行にないと、表の少なくとも一部が壊れていると扱い、syslogに警告を書きます。対策は、末尾の改行です。エディターの設定や、レビュー時の検査で保証できます。\n\n**実行が重複します。** crontabの形式には、前の実行が続いている場合の振る舞いを指定するフィールドがありません。systemdタイマーは、実行中のサービスには手を加えません。サービスの実行中に次の予定時刻が過ぎていれば、`DeferReactivation=`を設定しない限り、完了した瞬間に再びサービスを開始します。`pg_cron`では、最初の実行が終わるまで、二つ目の実行を待たせます。通常のcronでは、先ほどの例の`flock -n`のように、ロックを使います。\n\n**マシンの電源が切れていました。** crontabの行が指定するのは、一つの時点です。「その時点を過ぎていたら、後で実行する」と指定する方法はありません。systemdで動くマシンなら、`OnCalendar=`タイマーに`Persistent=true`を設定します。\n\n**すべてのマシンが、一斉に動きます。** 百台のホストに同じ表を配ると、同じ分に百個のジョブが始まります。systemdタイマーでは`RandomizedDelaySec=`を、cronieでは`RANDOM_DELAY`変数か、`6~15`のようなチルダによる範囲を使います。後者は、表を読んだ時点で、範囲内から一つの分をランダムに選びます。\n\n**引数のない`crontab`が、表を消します。** 引数を付けずに実行すると、コマンドは標準入力から新しい表を待ちます。入力の終わり、通常はCtrl-Dを送ると、現在の表を空の内容で置き換えます。代わりに割り込みキーを押します。表は、`crontab file`で登録するファイルに保持します。\n\n## 参考資料\n\n- [crontab、POSIX.1-2024](https://pubs.opengroup.org/onlinepubs/9799919799/utilities/crontab.html) — 標準の六フィールド、既定の環境、メールの規則、根拠説明を示します。\n- [crontab(5)、cronie](https://man7.org/linux/man-pages/man5/crontab.5.html) — 間隔の指定、`MAILTO`、`CRON_TZ`、`RANDOM_DELAY`、夏時間、注意点を説明します。\n- [systemd.timer(5)](https://www.freedesktop.org/software/systemd/man/latest/systemd.timer.html) — `OnCalendar=`、`Persistent=`、`RandomizedDelaySec=`、実行中のサービスを説明します。\n- [systemd.time(7)](https://www.freedesktop.org/software/systemd/man/latest/systemd.time.html) — カレンダーイベントの構文、省略形、検証方法を説明します。\n- [flock(1)](https://man7.org/linux/man-pages/man1/flock.1.html) — コマンド全体にロックを掛け、取得済みなら`-n`で終了する方法を説明します。\n- [pg_cron](https://github.com/citusdata/pg_cron) — PostgreSQLの拡張としてデータベース内に保持する、SQLジョブ用のcron形式の予定です。\n\n\u003chttps://engineer.company/ja/glossary/cron/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"cronの役割とcrontabの行の読み方、POSIXがデーモンの実装に委ねる部分を解説します。定期実行する処理が、誰にも気付かれないまま仕事をしなくなる原因と、その対策も説明します。","formats":{"gemtext":"https://engineer.company/ja/glossary/cron/index.gmi","gopher":"https://engineer.company/ja/glossary/cron/gophermap","html":"https://engineer.company/ja/glossary/cron/","json":"https://engineer.company/ja/glossary/cron/index.json","markdown":"https://engineer.company/ja/glossary/cron/index.md","pdf":"https://engineer.company/ja/glossary/cron/index.pdf"},"kind":"page","language":"ja","title":"cronとは？","url":"https://engineer.company/ja/glossary/cron/","version":1}