cronは動かなくても何も言わない — 定期実行とsystemd timer

定期実行と失敗の検知。カレンダーと時計、実行ログの書類と通知ベル。

※本記事はアフィリエイト広告(PR)を含みます。

cronは動かなくても何も言いません。定期実行をcronとsystemd timerの両方で作り、動かないときの確認箇所を決めます。

前回: スクレイピングは技術より先に線引き — 練習は自分のVMで

作業場所はVMの中(Ubuntu Server)です。 Windows の PowerShell で打つところは、その都度「Windows で」と書きます。

前提: systemctlのstartとenableの違い|サービスの状態を確認する手順、シェルスクリプトの書き方|変数・引数・実行権限の基本、Linuxのパーミッション|Permission deniedの原因とrwx・755の読み方、Lokiでログを集約する|複数のログを1画面で追う を一度触っていることを前提にします。 作品をデプロイして運用に入る|切り戻せる状態を先に作るで backup.sh を cron に1行載せましたが、この記事はそこから独立して読めます。 題材のスクリプトはこの記事の中で作り直します。

crontab -e を開いて、1行書いて、保存する。

15 4 * * * /home/ubuntu/hitokoto/scripts/backup.sh

これで毎日 4:15 にバックアップが走る、はずです。書いた本人は、そう思っています。

問題は、そのあと誰もこの行を見ないことです。

翌朝、何も起きません。エラーも出ません。画面も変わりません。成功したときと、失敗したときと、そもそも実行すらされなかったときの見え方が、全部同じです。何も起きない。

そして3か月後、データが消えた日にバックアップを取りに行って、最後のファイルが3か月前の日付だと気づきます。

自動化して一番怖いのは、失敗することではありません。動かなかったことに気づかないことです。

手でやっている作業は、やり忘れたら自分で気づきます。「あれ、今日やってないな」と。自動化した瞬間に、その感覚が消えます。 動いているつもりの期間が、静かに伸びていきます。

だからこの記事は、こういう組み立てになっています。

動かすより、気づける形にするほうが難しい。

cron の書き方そのものは10分で終わります。時間を使うのは、後半の「気づける形にする」ところです。そこがこの記事の山場です。

対象レベル: 中級 / 区分: 必修

目次

この記事でわかること

  • cron の曜日と日にちを両方書くと、AND ではなく OR になること(月末バックアップのつもりが毎週走る)
  • 手で打つと動くのに cron だと動かない理由が、ほぼ PATH・%・カレントディレクトリの3つに絞れること
  • >/dev/null 2>&1 を安易に書くと、失敗を自分の手で消していること
  • 「失敗を知らせる」より「成功を記録する」ほうが強いこと。通知は失敗すると届かないが、古い記録は残る
  • systemd timer は cron の置き換えではなく、ログと依存関係と再実行を持った別物だということ
  • サーバーが UTC のままだと、指定した時刻が9時間ずれること

この記事でやること

  1. crontab -e に1本書いて、5つのフィールドの意味を確かめる
  2. cron でハマる3つを、わざと起こして直す(PATH・%・カレントディレクトリ)
  3. 失敗に気づける形にする(出力をログへ・終了コードを見る・最後に成功した時刻を残す)
  4. 同じジョブを systemd timer(.service + .timer)に書き換える
  5. 多重起動を防ぐ(flock と systemd の性質)
  6. タイムゾーンを確認する
  7. 作ったジョブを全部止める

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
cron(クーロン)決まった時刻にコマンドを実行し続ける、Linux に最初から入っている仕組み。常駐しているプログラムが毎分1回、時計と設定表を突き合わせている
crontab(クーロンタブ)cron に「いつ・何を」を書いた表そのもの。ユーザーごとに1つ持てる
ジョブcron や timer が実行する1つの仕事。ここでは backup.sh 1本のこと
systemd timersystemd が持っている cron の代わり。.service(何をするか)と .timer(いつやるか)の2ファイルで1つのジョブになる
終了コード(exit status)コマンドが終わるときに返す数字。0 が成功、それ以外は失敗。echo $? で直前の値が見える
ハートビート「生きている」ことを一定間隔で残す信号。届かなくなったこと自体を異常とみなすために使う
死活監視対象が生きているかを外から見張ること。「異常の通知」ではなく「正常の不在」で気づくのが基本
flockファイルに鍵をかけて、同じスクリプトが同時に2つ走らないようにするコマンド
UTC世界標準時。日本時間(JST)はここから9時間進んでいる

まず1本、cron に載せる

題材を作ります。中身は何でもいいので、いちばん単純な「日付を書き足すだけ」のスクリプトにします。

bash
$ mkdir -p ~/jobs ~/state
$ nano ~/jobs/hello.sh
bash
#!/bin/bash
  set -euo pipefail

  echo "hello $(date)" >> "$HOME/state/hello.log"

実行できるようにします。chmod +x を忘れると Permission denied になります(権限の回でやったところです)。

bash
$ chmod +x ~/jobs/hello.sh
$ ~/jobs/hello.sh
$ cat ~/state/hello.log

1行増えていれば、手ではちゃんと動いています。 ここが出発点です。

crontab を開く

bash
$ crontab -e

初回はエディタを選ばされます。nano を選んでください(番号で選びます)。

一番下に、この1行を足します。

* * * * * /home/ubuntu/jobs/hello.sh

Ctrl + O → Enter → Ctrl + X で保存します。crontab: installing new crontab と出れば入っています。

* * * * * は「毎分」です。 練習中は毎分にしておくと、1分待てば結果が見られます。本番の時刻でテストしてはいけません。 「明日の4時に確かめる」は、確かめないのと同じです。

1分待って、見ます。

bash
$ tail -3 ~/state/hello.log

行が増えていれば、cron は動いています。

[スクリーンショット: 01_crontab編集.png] crontab -e で nano が開き、* * * * * /home/ubuntu/jobs/hello.sh の1行が入っている画面を撮ってください。

5つのフィールド

先頭の * * * * * は、5つの数字が空白で区切られたものです。

#フィールド範囲備考
1分0〜59
2時0〜2324時間表記。午後4時は 16
3日1〜31月の中の日にち
4月1〜12jan などの英字も可
5曜日0〜70 と 7 がどちらも日曜。sun などの英字も可

書き方は4つ覚えれば足ります。

書き方意味例
*毎回* * * * * = 毎分
5その値のとき15 4 * * * = 毎日 4:15
1,15列挙0 9,18 * * * = 毎日 9時と18時
*/10その間隔ごと*/10 * * * * = 10分おき

いくつか読んでみます。

書いたものいつ走るか
0 3 * * *毎日 3:00
30 2 * * 0毎週日曜の 2:30
0 0 1 * *毎月1日の 0:00
*/5 9-18 * * 1-5平日の 9時〜18時台に5分おき

@daily @weekly @reboot という省略形もあります。@reboot は起動のたびに1回です。

日と曜日を両方書くと OR になる

ここが、cron でいちばん有名な罠です。

0 0 13 * 5

これを「13日が金曜日のとき」と読んだ人は、間違えます。実際は「毎月13日」と「毎週金曜日」の両方で走ります。

3番目(日)と5番目(曜日)の両方に * 以外を書くと、条件は AND ではなく OR になります。

理由は cron の仕様がそう決まっているからで、覚えるしかありません。「月末に近い平日だけ」のような指定は、cron の式では書けないと思ってください。

書けないものは、スクリプトの中で判定します。

bash
#!/bin/bash
  # 毎日走らせて、13日の金曜以外は何もせずに終わる
  [ "$(date +%d)" = "13" ] && [ "$(date +%u)" = "5" ] || exit 0

cron 側の式を凝らないほうが、後で読めます。

cron で必ずハマる3つ

「手で打つと動くのに、cron だと動かない」。これは cron を使い始めた全員が通ります。 原因はほぼこの3つです。

読むだけだと絶対に忘れるので、1つずつ実際に起こします。

① PATH が違う

cron が使う環境変数は、あなたがログインしたときのものとは別物です。これを目で見ます。

crontab に、env の中身を書き出すだけの行を足します。

bash
$ crontab -e
* * * * * /usr/bin/env > /home/ubuntu/state/cron-env.txt

1分待って、自分の環境と並べます。

bash
$ cat ~/state/cron-env.txt
$ echo "---- ここから、いま自分がいる環境 ----"
$ env | grep -E '^(PATH|HOME|SHELL|USER)='

PATH の行を見比べてください。 cron 側は、たいていこれだけです。

PATH=/usr/bin:/bin

一方、ログインした自分の PATH には /usr/local/bin や /snap/bin、Node.js をバージョン管理ツールで入れているなら ~/.nvm/versions/... まで入っています。

cron から見ると、それらのコマンドは「存在しない」のと同じです。

node や docker compose、自分で /usr/local/bin に置いたコマンドが、command not found で静かに落ちます。

実際に起こします。スクリプトを1行足して、node を呼ばせます。

bash
$ nano ~/jobs/hello.sh
bash
#!/bin/bash
  set -euo pipefail

  node -e 'console.log("ok")' >> "$HOME/state/hello.log"
  echo "hello $(date)" >> "$HOME/state/hello.log"

手では動きます。

bash
$ ~/jobs/hello.sh

cron では、hello.log に何も増えません。 後で「気づける形」を入れると、ここに node: command not found が残るようになります。

直し方は3つあります。上から順に安全です。

やり方書き方評価
絶対パスで書く/usr/bin/node -e ...一番確実。command -v node で調べて貼る
スクリプトの先頭で PATH を宣言するexport PATH="/usr/local/bin:/usr/bin:/bin"スクリプトが自分で完結する。おすすめ
crontab の先頭で PATH を宣言するPATH=/usr/local/bin:/usr/bin:/bincrontab を見た人にしか伝わらない

パスは自分で調べます。

bash
$ command -v node
$ command -v docker

「自分の環境に入っていたから動く」は、cron には通用しません。

② % が特別扱いされる

ファイル名に日付を入れたくなります。crontab に直接こう書くと、壊れます。

* * * * * /usr/bin/touch /home/ubuntu/state/backup-$(date +%Y%m%d).tar

1分後、state を見ます。

bash
$ ls ~/state/

日付が入っていないか、そもそも作られていません。

理由は、crontab の中では % が「ここから先は標準入力」を意味する特別な文字だからです。+%Y%m%d の最初の % でコマンドが打ち切られ、残りは実行するコマンドではなく入力データとして扱われます。

エスケープすれば動きます。

0 4 * * * /usr/bin/touch /home/ubuntu/state/backup-$(date +\%Y\%m\%d).tar

ただし、これは覚え方としておすすめしません。 バックスラッシュを1つ落とすだけで壊れて、しかも静かに壊れるからです。

crontab には、コマンドを直接書かない。スクリプトのパスだけを書く。

スクリプトの中は普通のシェルなので、% は何も特別ではありません。

bash
#!/bin/bash
  set -euo pipefail
  touch "$HOME/state/backup-$(date +%Y%m%d).tar"

crontab 側はこれだけです。

0 4 * * * /home/ubuntu/jobs/backup.sh

crontab の1行が短いほど、事故りません。

③ カレントディレクトリが違う

3つめ。cron はホームディレクトリで動きます。 スクリプトが置いてある場所ではありません。

確かめます。

bash
$ nano ~/jobs/where.sh
bash
#!/bin/bash
  {
    echo "pwd = $(pwd)"
    echo "whoami = $(whoami)"
  } >> "$HOME/state/where.log"
bash
$ chmod +x ~/jobs/where.sh
$ cd /var/tmp
$ ~/jobs/where.sh

crontab に足します。

* * * * * /home/ubuntu/jobs/where.sh

1分後に見比べます。

bash
$ cat ~/state/where.log

手で打ったときは /var/tmp、cron から走ったときは /home/ubuntu になっているはずです。

だから、相対パスは全部おかしくなります。

bash
$ # ❌ 「スクリプトと同じ場所の config を読む」つもりで壊れる
$ source ./config.env

$ # ❌ 出力先がホームにできてしまう
$ tar czf backup.tar.gz data/

直し方は2つです。

bash
#!/bin/bash
  set -euo pipefail

  # スクリプト自身のある場所へ移動する
  cd "$(dirname "$0")"

  # あるいは、全部を絶対パスで書く
  tar czf "$HOME/state/backup.tar.gz" -C "$HOME/hitokoto" data

cron に載せるスクリプトでは、相対パスを書かない。 これだけ守れば③は起きません。

3つとも、共通の原因は同じです。

cron は「あなたがログインしている状態」を再現しません。 対話的なシェルの設定ファイル(.bashrc など)も読まれません。 cron から走るスクリプトは、何も無い状態から始まると思って書きます。

失敗に気づける形にする

ここからが本題です。

出力を捨てない

ネットで cron の例を探すと、これが必ず付いてきます。

15 4 * * * /home/ubuntu/jobs/backup.sh >/dev/null 2>&1

>/dev/null 2>&1 は「標準出力も標準エラーも、全部捨てる」という意味です。これを付ける理由は、付けないと cron がメールを送ろうとするからです。ローカルにメールの仕組みが無いと、syslog に配送エラーが溜まります。

気持ちは分かりますが、これは「失敗を自分の手で消している」だけです。

node: command not found も、mysqldump の権限エラーも、全部ここで消えています。

捨てるのではなく、ログに送ります。

15 4 * * * /home/ubuntu/jobs/backup.sh >> /home/ubuntu/state/backup.log 2>&1

>> は追記、2>&1 は「標準エラーも、標準出力と同じ行き先へ」です。順番が逆(2>&1 >> file)だと、標準エラーはファイルに入らず、元の標準出力の行き先(手で打てば画面、cron の中ならメールの側)へ出てしまいます。 ここは丸暗記でいいです。

もう1つ、systemd のログ(journald)へ送る手もあります。

bash
#!/bin/bash
  set -euo pipefail
  exec 1> >(logger -t backup -p user.info) 2> >(logger -t backup -p user.err)

こうすると、journalctl -t backup で読めるようになります。 ファイルが際限なく太らないのと、ログ集約の回で入れた仕組みにそのまま乗るのが利点です。

ただしログファイルにするなら、放置しないでください。 追記し続けるとディスクを食います。サイズを見る習慣だけは付けます。

bash
$ du -h ~/state/backup.log

終了コードを見る

ログに残しても、読まなければ意味がありません。 毎朝ログを開く運用は、続きません。

そこで、スクリプトが自分で成否を判断するようにします。

bash
$ nano ~/jobs/backup.sh
bash
#!/bin/bash
  set -euo pipefail

  STATE="$HOME/state"
  OUT="$STATE/backup-$(date +%Y%m%d).tar.gz"

  mkdir -p "$STATE"

  # ここが本番の仕事。失敗すると 0 以外が返る
  tar czf "$OUT" -C "$HOME" jobs

  # 中身があるかまで確かめる(ファイルの存在は成功の証明にならない)
  if [ ! -s "$OUT" ]; then
    echo "backup: 出力が空です: $OUT" >&2
    exit 1
  fi

  echo "backup: ok $OUT"

大事なのは先頭の1行です。

書いたもの効果
set -eどこかのコマンドが失敗した時点で、そこで止まる
set -u未定義の変数を使ったらエラーにする(rm -rf "$DIR/" の事故を防ぐ)
set -o pipefailパイプの途中が失敗しても、全体を失敗にする

これが無いと、tar が失敗しても最後まで走り抜けて、終了コード 0(成功)を返します。 空のファイルが残り、記録上は成功です。バックアップで一番よくある事故がこれです。

手で確かめます。

bash
$ chmod +x ~/jobs/backup.sh
$ ~/jobs/backup.sh
$ echo $?

0 が出れば成功です。わざと失敗させてみます。

bash
$ mv ~/jobs ~/jobs-hidden
$ ~/jobs-hidden/backup.sh
$ echo $?
$ mv ~/jobs-hidden ~/jobs

0 以外が返れば、スクリプトは失敗を失敗として報告できています。

失敗したときだけ知らせる

終了コードが見えるようになったので、失敗したときだけ何かするラッパーを作ります。

bash
$ nano ~/jobs/run.sh
bash
#!/bin/bash
  # 使い方: run.sh <ジョブ名> <実行するコマンド...>
  set -uo pipefail

  NAME="$1"; shift
  STATE="$HOME/state"
  mkdir -p "$STATE"

  if "$@" >> "$STATE/$NAME.log" 2>&1; then
    # 成功したので、時刻を刻む(後述)
    date -Is > "$STATE/$NAME.last-success"
    logger -t "$NAME" -p user.info "ok"
  else
    CODE=$?
    logger -t "$NAME" -p user.err "FAILED exit=$CODE"
    tail -n 20 "$STATE/$NAME.log" | logger -t "$NAME" -p user.err
    exit "$CODE"
  fi
bash
$ chmod +x ~/jobs/run.sh
$ ~/jobs/run.sh backup /home/ubuntu/jobs/backup.sh
$ journalctl -t backup -n 5 --no-pager

crontab はこうなります。

15 4 * * * /home/ubuntu/jobs/run.sh backup /home/ubuntu/jobs/backup.sh

通知先はメールでも、チャットの Webhook でも構いません。 logger の行を curl に差し替えるだけです。ここでは「何で送るか」は本質ではありません。

なぜなら、この仕組みには、まだ致命的な穴があるからです。

一番効くのは「成功したことを記録する」

失敗通知には、構造的な弱点があります。

ジョブが1度も実行されなかったら、失敗通知も飛びません。

  • cron そのものが止まっていた
  • crontab の行を、別の作業のついでに消してしまった
  • サーバーが落ちていた
  • スクリプトのファイルごと消えていた
  • ネットワークが死んでいて、通知が送れなかった

このどれでも、あなたの受信箱は静かなままです。 そして静かなことを、あなたは「正常」だと解釈します。

通知が来ないこととすべて順調なことが、区別できません。

だから、異常を知らせるのではなく、正常を記録します。

さきほどの run.sh に、すでに1行入れてあります。

bash
$ date -Is > "$STATE/$NAME.last-success"

成功したときだけ、そのファイルが更新されます。

bash
$ cat ~/state/backup.last-success

この1ファイルが、「最後にうまくいったのはいつか」という、たった1つの真実です。あとはそれが古くなっていないかを見張るだけです。

見張り役を作ります。

bash
$ nano ~/jobs/check.sh
bash
#!/bin/bash
  # 使い方: check.sh <ジョブ名> <許容する経過秒数>
  set -uo pipefail

  NAME="$1"
  MAX="$2"
  FILE="$HOME/state/$NAME.last-success"

  if [ ! -f "$FILE" ]; then
    echo "STALE: $NAME は一度も成功していません"
    exit 1
  fi

  AGE=$(( $(date +%s) - $(stat -c %Y "$FILE") ))

  if [ "$AGE" -gt "$MAX" ]; then
    echo "STALE: $NAME の最終成功は $AGE 秒前です(許容 $MAX 秒)"
    exit 1
  fi

  echo "OK: $NAME は $AGE 秒前に成功しています"
bash
$ chmod +x ~/jobs/check.sh
$ ~/jobs/check.sh backup 93600
$ echo $?

93600 は26時間です。 毎日のジョブに対して、24時間ちょうどではなく少し余裕を持たせます。 実行が数分ずれただけで警報が鳴ると、人は警報を無視するようになります。

古いとどうなるかも、その場で確かめます。

bash
$ touch -d '3 days ago' ~/state/backup.last-success
$ ~/jobs/check.sh backup 93600
$ echo $?
$ ~/jobs/backup.sh && date -Is > ~/state/backup.last-success
$ ~/jobs/check.sh backup 93600

STALE が出て、戻したら OK に戻る。 ここまで見て、初めて「気づける」と言えます。

[スクリーンショット: 02_stale確認.png] touch -d '3 days ago' のあとに check.sh を実行し、STALE が出ている画面を撮ってください。

これが死活監視の考え方です。

考え方仕組み気づけないケース
異常を知らせる失敗したら通知を送る実行自体が消えたら、無音のまま
正常を記録する成功したら時刻を残し、古くなったら異常とみなす記録が更新されなければ、必ず気づく

この「一定間隔で信号が届き、届かなくなったら異常」という形を、ハートビート、あるいはデッドマンズスイッチと呼びます。監視の回で Prometheus を入れているなら、last-success の時刻をメトリクスとして出して、time() - 最終成功時刻 > しきい値 でアラートにするのが本筋です。外部の監視サービスにも、この用途の機能があります。

ただ、まずはこの1ファイルで十分です。大事なのは道具ではなく、「正常の不在で気づく」という向きのほうです。

systemd timer に書き換える

同じジョブを、systemd で書き直します。cron の上位互換ではなく、性格の違う道具です。

2ファイル作ります。 どちらも /etc/systemd/system/ に置きます。

まず「何をするか」。

bash
$ sudo nano /etc/systemd/system/backup.service
[Unit]
Description=hitokoto のバックアップ

[Service]
Type=oneshot
User=ubuntu
ExecStart=/home/ubuntu/jobs/backup.sh

Type=oneshot は「動き続けるサービスではなく、走って終わるもの」という宣言です。サービスの回で書いた Type=simple との違いがここです。

[Install] は書きません。 このサービスは自分で起動するものではなく、timer から呼ばれるだけだからです。

次に「いつやるか」。ファイル名の backup の部分を、.service と揃えます。 揃っていれば Unit= は書かなくても繋がります。

bash
$ sudo nano /etc/systemd/system/backup.timer
[Unit]
Description=hitokoto のバックアップを毎日回す

[Timer]
OnCalendar=*-*-* 04:15:00
Persistent=true
RandomizedDelaySec=300

[Install]
WantedBy=timers.target

時刻の書き方は、書く前に検算できます。

bash
$ systemd-analyze calendar '*-*-* 04:15:00'

次に走る時刻が表示されます。 cron の式にはこれがありません。「書いた式が意図どおりか」を、実行前に確かめられるのは大きいです。

有効にします。

bash
$ sudo systemctl daemon-reload
$ sudo systemctl enable --now backup.timer

まず、待たずに1回動かして確かめます。

bash
$ sudo systemctl start backup.service
$ systemctl status backup.service --no-pager
$ journalctl -u backup.service -n 20 --no-pager

ログが journalctl に入っています。 リダイレクトを書いていないのに、標準出力も標準エラーも全部拾われています。これが cron との一番大きな違いです。

次回の予定を見ます。

bash
$ systemctl list-timers --all
NEXT                        LEFT       LAST  PASSED  UNIT          ACTIVATES
Tue 2026-09-16 04:15:00 JST 9h left    -     -       backup.timer  backup.service

[スクリーンショット: 03_list-timers.png] systemctl list-timers --all の実行結果で、backup.timer の次回実行時刻が見えている画面を撮ってください。

「次にいつ走るか」が一覧で見える。 cron でこれを知るには、5つの数字を頭の中で計算するしかありません。

cron と systemd timer の違い

見るところcronsystemd timer
設定の場所crontab -e で1行.service と .timer の2ファイル
手間圧倒的に少ない2ファイル + daemon-reload
ログ自分でリダイレクトを書く。書かないと消えるjournalctl -u に自動で入る
次回実行見る手段が無いsystemctl list-timers
式の検算できないsystemd-analyze calendar
電源が落ちていた分実行されず、そのまま流れるPersistent=true で、起動後に取り返して走る
起動からの相対指定できない(@reboot のみ)OnBootSec= / OnUnitActiveSec=
依存関係書けないAfter=mysql.service などが書ける
実行ユーザー・環境crontab の持ち主User= / Environment= を明示できる
同時実行の抑止自分で flock同じユニットは2つ同時に走らない
失敗時の扱い何もしないOnFailure= で別ユニットを呼べる

とくに効くのが2つあります。

Persistent=true。サーバーが止まっていて実行時刻を過ぎてしまった分を、次に起動したときに走らせます。 cron はこれをしません。4:15 に電源が落ちていたら、その日のバックアップは単に無かったことになります。VM を毎回シャットダウンする学習環境では、ここが決定的に違います。

OnBootSec=。「起動の◯分後に走らせる」が書けます。時刻ではなく、起動からの経過で指定したいときに使います。

[Timer]
OnBootSec=15min
OnUnitActiveSec=6h

これで「起動15分後に1回、その後は前回実行から6時間ごと」になります。「◯時間ごと」を cron で正確に書くのは、実はできません(0 */6 * * * は「0時・6時・12時・18時」であって、「前回から6時間後」ではありません)。

RandomizedDelaySec=300 も入れてあります。指定時刻から最大5分の範囲でばらけさせるものです。台数が増えたときに、全台が同じ秒に一斉起動して負荷が跳ねるのを防ぎます。

多重起動を防ぐ

前回が終わっていないのに、次が始まる。 これは、時間が経ってから突然起きます。

5分おきのジョブが、データが増えたせいで7分かかるようになった。すると2つ目が動き出し、やがて3つ目が重なります。 重なるほど遅くなるので、加速度的に増えます。 バックアップなら出力ファイルの奪い合いになり、壊れたファイルが残ります。

起きたときの見え方が「サーバーが急に重い」なので、原因に辿り着きにくいのが厄介です。

cron 側 — flock

cron 自身は、この面倒を見てくれません。flock を挟みます。

*/5 * * * * /usr/bin/flock -n /home/ubuntu/state/backup.lock /home/ubuntu/jobs/backup.sh

-n は「鍵が取れなければ、待たずにすぐ諦める」です。

  • -n あり: 前回が走っていたら、今回は何もせず終わる(おすすめ)
  • -n なし: 前回が終わるまで待つ。待ちが積み上がるので、定期実行では使わない

確かめます。わざと長くかかるスクリプトを用意します。

bash
$ printf '#!/bin/bash\nsleep 60\n' > ~/jobs/slow.sh
$ chmod +x ~/jobs/slow.sh

端末を2つ開いて(VS Code から接続していれば、ターミナルを2つ出せます)、片方で走らせます。

bash
$ flock -n ~/state/slow.lock ~/jobs/slow.sh

すぐにもう片方で、同じものを打ちます。

bash
$ flock -n ~/state/slow.lock ~/jobs/slow.sh
$ echo $?

2つ目は即座に終わり、echo $? が 1 を返します。 何もせずに諦めた、ということです。

ロックファイルは /tmp に置かないでください。 起動時に消える環境があります。/var/lock か、いまのように自分の state の下が無難です。

systemd 側 — そもそも重ならない

systemd timer では、flock は要りません。

同じ名前のユニットは、同時に2つ起動しません。

前回の backup.service がまだ走っているうちに timer が発火しても、新しいプロセスは増えません。 ログにその旨が残ります。

ただし、終わらないジョブは放置されます。 上限を切っておきます。

[Service]
Type=oneshot
User=ubuntu
ExecStart=/home/ubuntu/jobs/backup.sh
TimeoutStartSec=30min

30分で終わらなければ、強制的に止めて失敗として記録されます。 「永遠に終わらないジョブ」は、失敗より厄介です。 失敗なら通知できますが、終わらないジョブは成功も失敗もしないまま、次の実行を全部ブロックし続けるからです。

時刻とタイムゾーン

cron も timer も、サーバーの時計を見ています。 そして、サーバーの時計はあなたの手元と同じとは限りません。

クラウドで借りたサーバーは、初期状態が UTC のことがよくあります。 EC2 の回で立てた1台も同じです。

bash
$ timedatectl
               Local time: Mon 2026-09-15 19:42:11 UTC
           Universal time: Mon 2026-09-15 19:42:11 UTC
                Time zone: Etc/UTC (UTC, +0000)
System clock synchronized: yes
              NTP service: active

Time zone: Etc/UTC のまま 15 4 * * * と書くと、実際に走るのは日本時間の 13:15 です。 「深夜に静かに走らせる」つもりのバックアップが、利用者が一番多い昼過ぎに、サーバーの負荷を上げながら走ります。

日本時間にします。

bash
$ sudo timedatectl set-timezone Asia/Tokyo
$ timedatectl

タイムゾーンを変えたら、cron を再起動してください。

bash
$ sudo systemctl restart cron

systemd timer は daemon-reload の必要すらなく追随しますが、確認はします。

bash
$ systemctl list-timers --all

「次回」が意図した時刻になっていれば大丈夫です。

注意が2つあります。

  1. タイムゾーンを変えた当日は、ジョブが2回走るか、1回飛びます。 時計が9時間進むので当然です。変更は、影響の無いタイミングでやります
  2. サーバーを UTC のまま運用するのも、選択として正しいです。複数拠点があるなら、UTC で統一したほうが混乱しません。 大事なのは、どちらかに決めて、それを知っていることです

systemd では、ユニット側でタイムゾーンを固定することもできます。

[Timer]
OnCalendar=Asia/Tokyo *-*-* 04:15:00

サーバーの設定に依存しなくなるので、こちらのほうが安全です。

手元の VM で動くようになったら、次はクラウドで借りたサーバーに同じ timer を置いて、時計のずれを自分の目で確かめる順が自然です。シンVPSのような月額の小さな VPS(2026-11 時点、大容量メモリプランの 1GB が 1ヶ月 750 円〜36ヶ月 451 円・税込)なら、壊しても作り直せる練習相手になります。無料のお試し期間は無く最低利用期間が 3ヶ月なので、数日だけ試したい場合には向きません。

どちらを使うか

両方を1つの表にします。

こういうとき選ぶもの
5分で試したい。ログも要らないcron
自分だけが使う雑用(ログの掃除、一時ファイルの削除)cron
落ちたら困る仕事(バックアップ・証明書の更新・集計)systemd timer
他のサービスが起動してから走らせたいsystemd timer(After=)
電源が落ちていた分を取り返したいsystemd timer(Persistent=true)
ログを journalctl / Loki に集めたいsystemd timer
コンテナの中で1本回したいcron(systemd が居ないことが多い)

このサイトでは、どちらも使います。

  • cron: hello.sh のような、消えても誰も困らないもの
  • systemd timer: バックアップ、証明書の更新、check.sh による死活監視

「systemd timer が正解だから全部そっちにする」は、やりません。 2ファイル作って daemon-reload する手間は、毎回かかります。その手間に見合う仕事かどうかで選びます。

判断の目安は1つです。

止まっていたことに、あとから気づきたいか。 気づきたいなら systemd timer。どうでもいいなら cron。

そして、どちらを選んでも、last-success は残します。 これは cron か timer かとは無関係の話です。

つまずいたところ

crontab -e を sudo を付けて開いてしまった。 sudo crontab -e は root の crontab で、crontab -e とは別の表です。「書いたのに動かない」と30分探して、crontab -l に何も出ないことで気づきました。ユーザーごとに別々です。

>/dev/null 2>&1 を最初から書いていた。 ネットの例をそのまま貼っていたので、node: command not found が1週間ずっと出ていたのに、1度も見ていませんでした。 外して初めて分かりました。この記事を「捨てない」から始めたのは、これが理由です。

% の罠に、date 以外で引っかかった。 printf '%s' を crontab に直接書いて壊しました。date の話だと思っていたのが間違いで、% そのものの話でした。crontab にコマンドを書かない、が結論です。

.service に [Install] を書いて enable してしまった。 そうすると起動のたびに走ります。 timer と両方で発火して、1日2回走っていました。timer から呼ばれるサービスは enable しません。

systemctl list-timers に出てこなかった。 enable だけして start を忘れていました。--now を付けるか、start も打ちます。 systemctl list-timers --all の --all を付けないと、止まっている timer は表示されません。

check.sh のしきい値を24時間ちょうどにした。 毎日ぎりぎりで STALE が出たり出なかったりして、2日で見なくなりました。 警報は、鳴ったら必ず異常という状態を保たないと、すぐ無視されます。

後片づけ

この記事で作ったものは、いま全部あなたのサーバーで動き続けています。 * * * * * を毎分回したままだと、ログが増え続けます。

止め忘れは、必ず起きます。 ここで全部消します。

1. cron を空にする

bash
$ crontab -l

中身を確認してから、消します。

bash
$ crontab -e

この記事で足した行を、すべて削除して保存します。

crontab -r は使わないでください。 確認なしで全部消えます。 -e(編集)と -r(全削除)はキーが隣です。実際にやらかす人が居ます。

2. systemd timer を止める

bash
$ sudo systemctl disable --now backup.timer
$ sudo rm /etc/systemd/system/backup.timer /etc/systemd/system/backup.service
$ sudo systemctl daemon-reload
$ systemctl list-timers --all | grep backup

何も出なければ、消えています。

3. 他に仕込まれていないか見る

cron の設定場所は、crontab -e だけではありません。

bash
$ crontab -l
$ sudo crontab -l
$ ls /etc/cron.d/
$ ls /etc/cron.daily/

/etc/cron.daily/ などには、OS やパッケージが入れたものがあります。 これは消さないでください。 見るのは「自分が置いたものが残っていないか」だけです。

システムに元から居る timer も確認します。

bash
$ systemctl list-timers --all

apt-daily.timer や logrotate.timer が並びます。Ubuntu は最初から systemd timer を使っています。 これも触りません。

4. 練習で作ったファイルを消す

bash
$ rm -rf ~/jobs ~/state

run.sh と check.sh は、この先も使える形にしてあります。 残しておきたければ、rm は打たずに ~/jobs だけ残してください。

まとめ

理解できたこと。

cron の書き方は、本当に10分で終わりました。 5つのフィールドと、日と曜日が OR になる罠。それだけです。

時間を使ったのは、全部その先でした。

「手で打つと動くのに cron だと動かない」の正体は、3つとも同じでした。cron は、あなたがログインしている状態を再現しない。 PATH が違うのも、% が特別なのも、カレントディレクトリがホームなのも、「自分の環境を前提にした書き方が通らない」という1つの話です。

そして山場。失敗を知らせる仕組みには、構造的な穴がありました。

実行されなかったら、失敗通知も飛びません。

通知が来ないことと、順調なことが区別できない。 これを埋めたのが last-success の1ファイルでした。成功した瞬間だけ時刻を刻み、それが古かったら異常とみなす。 異常を検知するのではなく、正常が途切れたことを検知する。 この向きの違いが、この記事で一番持ち帰る価値のあるところだと思っています。

systemd timer は cron の上位互換ではありませんでした。 ログが journalctl に入る、次回が list-timers で見える、式が systemd-analyze calendar で検算できる、Persistent=true で落ちていた分を取り返す。どれも「あとから確かめられる」方向の機能です。手軽さを捨てて、確かめやすさを買っているだけで、雑用には cron のほうが向いています。

多重起動、タイムゾーン、そして後片づけ。どれも「時間が経ってから効いてくる」話でした。書いた日には何も起きません。

最後に1つだけ。

自動化は、仕事を減らす道具ではありません。 「やり忘れ」を「気づかない」に変える道具です。 気づける形にして初めて、手を離せます。

参考リンク


次に読む

この記事は 【第9段階】作品を1つ完成させる の 10 / 10 本目です。

記事
← 前の記事スクレイピングは技術より先に線引き — 練習は自分のVMで
→ 次の記事Windows Server評価版の導入|180日の期限とslmgr /rearmでの延長

本筋でいま読める記事は、ここまでです。 本筋は roadmap.sh に沿って並べていて、まだ書かれていない段階は はじめに に並んでいます。 ここから先は番外編で、roadmap.sh には無い話です。読まなくても順路は繋がります。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

自動化。定期実行は roadmap.sh の項目ではないが、運用では必ず出てくる。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次