cronでジョブを登録・確認する手順|書き方・環境変数・ログの確認
cronでのジョブの登録は、「スクリプトを手で実行して確かめる → crontabに登録する → 実行されたことをログで確かめる」の順に進めます。cronは、ログインしたときとは違う最小限の環境で動くため、手で動いたスクリプトがcronでは動かない、ということがよく起こります。登録の前に、その違いを意識しておきましょう。
crontab の書き方
分 時 日 月 曜日 コマンド
30 2 * * * /opt/scripts/backup.sh >> /var/log/backup.log 2>&1
*/5 * * * * /opt/scripts/check.sh
0 9 * * 1-5 /opt/scripts/report.sh
左から、分(0〜59)・時(0〜23)・日(1〜31)・月(1〜12)・曜日(0〜7、0と7が日曜)です。*は「毎」、*/5は「5ごと」、1-5は「1から5」を表します。上の例は、毎日2時30分、5分ごと、平日の9時0分に実行します。書き方に迷ったら、cron書き方チェッカーで次の実行日時を確かめられます。
ステップ1:スクリプトを、cronに近い環境で試す
$ /opt/scripts/backup.sh # まずは手で実行
$ env -i /bin/sh -c '/opt/scripts/backup.sh' # 環境変数をほぼ空にして実行
cronのPATHは/usr/bin:/bin程度の最小限で、~/.bashrcも読み込まれません。env -iで環境変数を空にして試すと、cronで起きる「command not found」に事前に気付けます。スクリプトの中のコマンドはフルパスで書くか、先頭でPATHを設定しておきます。
ステップ2:crontab に登録する
$ crontab -l > ~/crontab_backup_$(date +%Y%m%d).txt # 変更前の内容を保存
$ crontab -e
$ crontab -l
変更の前に、今の内容を必ずファイルに保存します。crontab -r(全削除)を-eと打ち間違えると、すべてのジョブが消えてしまうためです。登録したらcrontab -lで内容を確認します。
crontab -rは、確認なしでその人のcrontabをすべて削除します。キーボードで
eとrは隣にあるため、打ち間違いに気を付けましょう。バックアップがあれば
crontab ファイル名で戻せます。ステップ3:出力をログに残す
cronで実行したコマンドの出力は、そのままでは捨てられるか、ローカルのメールに送られます。>> /var/log/backup.log 2>&1のように、標準出力とエラー出力の両方をファイルに残しておくと、失敗したときに原因を追えます。%はcrontabの中では特別な意味を持つため、date +%Y%m%dを書くときは\%とエスケープします。
ステップ4:実行されたかを確認する
$ grep CRON /var/log/syslog | tail # Ubuntu
$ sudo journalctl -u cron --since today # Ubuntu(RHEL系は -u crond)
$ tail /var/log/backup.log
システムのログで「cronがコマンドを起動したか」を、スクリプト自身のログで「中身が成功したか」を確認します。起動の記録が無ければ時刻の指定かcronの設定、記録はあるのに失敗していればスクリプトの中身が原因です。
登録のチェックリスト
| 確認すること | 方法 |
|---|---|
| 手で実行して成功するか | スクリプトを直接実行 |
| 最小限の環境でも動くか | env -i /bin/sh -c 'スクリプト' |
| 実行権限があるか | ls -l スクリプト |
| 変更前の内容を保存したか | crontab -l > ファイル |
| 時刻の書き方は正しいか | cron書き方チェッカー |
| 出力をログに残しているか | >> ログ 2>&1 |
| サーバーのタイムゾーン | timedatectl(UTCだと9時間ずれる) |
登録したのに動かないときは「cronが動かない」で切り分けの手順を解説しています。
よくある質問
root で実行したいジョブはどこに書きますか?
sudo crontab -eでrootのcrontabに書くか、/etc/cron.d/にファイルを置きます。/etc/cron.d/の書式は、コマンドの前に実行ユーザーの欄が入ります。
前のジョブが終わる前に、次が始まってしまいます
flock -n /tmp/backup.lock /opt/scripts/backup.shのようにロックを使うと、前回が動いている間は新しく起動しないようにできます。
systemd のタイマーとどちらを使うべきですか?
単純な定期実行ならcronで十分です。ログをjournaldで一元管理したい、起動していなかった間の分を後から実行したい、といった場合はsystemdのタイマーが向いています。