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のタイマーが向いています。

この記事を書いた人:
こすけ(コマンド学習道場 運営者)。
AWSの運用保守に携わるエンジニアで、保有資格はCCNA・AWS-SAA・LPIC-3(305)。
詳しくは運営者情報をご覧ください。

← 現場ガイドの一覧へ戻る