systemd timerの使い方|cronの代わりに定期実行する設定と確認方法

  • VPS で、証明書の更新やバックアップを決まった時間に自動で動かしたい
  • cron の代わりに systemd timer を使う方法を知りたい
  • タイマーがちゃんと動いたのか、結果をどこで見ればいいか分からない

systemd timer は、.service(何をするか)と .timer(いつするか)の2つのファイルを組で作るだけで使えます。

この記事では、僕の VPS で実際に回している5つのタイマーを例に、書き方と確かめ方を紹介します。

OnCalendar の書式、RandomizedDelaySec・Persistent の意味、cron との違いもまとめます。

項目内容
VPSKAGOYA CLOUD VPS(2コア・メモリ2GB)
OSUbuntu 26.04.1 LTS
DockerDocker Engine 29.9.3・Docker Compose 5.7.0
この記事の環境(2026年11月19日に確認)

僕の VPS で回しているタイマー

いま動かしているのは、次の5つです。中身はどれも、シェルスクリプトを1つ実行するだけです。

タイマーすることいつ(OnCalendar)
証明書の更新certbot renew を実行して nginx を reloaddaily
Docker の掃除72時間より古いビルドキャッシュを削除weekly
nginx イメージの更新固定したタグの修正版を pull し、変わっていたら作り直す*-*-01,11,21 04:30:00 Asia/Tokyo
ベースイメージの更新certbot と PostgreSQL のイメージを pull する*-*-01,11,21 05:15:00 Asia/Tokyo
DB のバックアップアプリの DB をバックアップし、3世代を残す*-*-01 03:00:00 Asia/Tokyo
僕の VPS の systemd タイマー(2026年11月19日)

nginx とベースイメージの更新は、同じ日に重ならないよう 45分ずらしています。

Docker の掃除のスクリプトは1行だけ

たとえば Docker の掃除は、次の1行のスクリプトをタイマーで呼んでいるだけです。

ShellScript
#!/bin/sh
set -eu

docker builder prune -af --filter "until=72h"

VPS でアプリのイメージをビルドしていると、ビルドキャッシュがたまってディスクを使います。これを週に1回消しています。

.service と .timer を組で作る

ここからは、証明書の更新を例に、ファイルの書き方を見ていきます。

ファイルは /etc/systemd/system/ に置きます。.service と .timer の名前(拡張子の前)をそろえると、タイマーが同じ名前のサービスを動かします。

.service:何をするかを書く

INI
# /etc/systemd/system/myserver-cert-renew.service
[Unit]
Description=Renew TLS certificates
Requires=docker.service
After=docker.service

[Service]
Type=oneshot
ExecStart=/srv/myserver/renew-certs.sh
項目意味
Requires=docker.serviceDocker が動いていることが前提
After=docker.serviceDocker が起動してから動かす
Type=oneshot1回動いて終わる処理(常駐しない)
ExecStart実行するコマンド(絶対パスで書く)
.service の主な項目

中で docker コマンドを使うので、Docker より先に動かないようにしています。

.timer:いつ動かすかを書く

INI
# /etc/systemd/system/myserver-cert-renew.timer
[Unit]
Description=Daily TLS certificate renewal check

[Timer]
OnCalendar=daily
RandomizedDelaySec=1h
Persistent=true

[Install]
WantedBy=timers.target

[Timer] に動かす時刻を書き、[Install] の WantedBy=timers.target で、起動時にタイマーが有効になるようにします。

有効にするのは .timer の方です。.service は enable しません。

OnCalendar の書き方

OnCalendar は「曜日 年-月-日 時:分:秒 タイムゾーン」の形で書きます。

daily・weekly などの短い書き方

よく使う間隔には、短い書き方があります。

書き方意味
daily毎日 0時0分(*-*-* 00:00:00)
weekly毎週月曜の 0時0分(Mon *-*-* 00:00:00)
monthly毎月1日の 0時0分
OnCalendar の短い書き方

日と時刻を指定する

僕の nginx イメージの更新は、毎月1・11・21日の 4時30分に動かしています。

INI
OnCalendar=*-*-01,11,21 04:30:00 Asia/Tokyo

* は「すべて」、01,11,21 のようにカンマで並べると「そのどれか」です。

末尾にタイムゾーンを書くと、サーバーのタイムゾーンの設定に関係なく、日本時間で動きます。

月に3回なので、21日から翌月1日までだけは、月の長さによって 8〜11日の間隔になります。

systemd-analyze calendar で書式を確かめる

書いた OnCalendar が正しいか、次にいつ動くかは、systemd-analyze calendar で確かめられます。

ShellScript
systemd-analyze calendar "*-*-01,11,21 04:30:00 Asia/Tokyo"

正しく読めれば、正規化した書き方(Normalized form)と、次に動く日時(Next elapse)が表示されます。

書き間違えていると、エラーになります。タイマーを置く前に確かめておくと安心です。

RandomizedDelaySec:開始を少しずらす

RandomizedDelaySec=1h は、決めた時刻から最大1時間の範囲で、毎回ランダムに開始を遅らせる設定です。

証明書の更新のように外のサービスへアクセスする処理は、みんなが同じ時刻にアクセスしないよう、ずらしておくのが向いています。

僕の証明書の更新は daily で 1時間までずらしているので、11月19日は 0時37分に動いていました。

Persistent=true:止まっていた間の分を起動後に動かす

Persistent=true にすると、予定の時刻にサーバーが止まっていた場合、次に起動したときにすぐ1回動きます。

月に1回のバックアップのように間隔が長いものは、1回抜けると次まで長く空きます。僕は全部のタイマーに付けています。

タイマーを有効にして、動いたか確かめる

ファイルを置いたら、読み込んで有効にします。

読み込んで有効にする

ShellScript
sudo systemctl daemon-reload
sudo systemctl enable --now myserver-cert-renew.timer

--now を付けると、有効にするのと同時にタイマーを動かし始めます。

systemctl list-timers で次の予定を見る

ShellScript
systemctl list-timers

NEXT(次に動く日時)、LEFT(あとどれくらいか)、LAST(前に動いた日時)、PASSED(それからどれくらいか)が、タイマーごとに並びます。

自分のタイマーが一覧にあり、NEXT に日時が入っていれば、予定どおり待っている状態です。

手動で1回動かしてみる

タイマーを待たずに試すときは、.service の方を start します。

ShellScript
sudo systemctl start myserver-cert-renew.service

僕もタイマーを入れたときに、証明書の更新とバックアップのサービスを手動で動かし、成功することを確かめました。

journalctl -u で結果を見る

スクリプトが出した表示は、systemd のログに残ります。

ShellScript
journalctl -u myserver-cert-renew.service -n 50
systemctl status myserver-cert-renew.service

スクリプトが 0 以外で終わると、サービスは failed になります。失敗したサービスは、まとめて一覧で見られます。

ShellScript
systemctl --failed

僕の nginx イメージの更新は、新しいイメージで nginx -t が通らなければ、古いイメージのまま動かし続けて 1 で終わるようにしています。

こうしておくと、更新しなかったことが failed として残ります。

失敗したときにメールなどで知らせる仕組みは、まだ作っていません。ときどき list-timers と –failed を見るようにしてください。

長いログを読むときは、less を使うと便利です。

cron との違い

同じことは cron でもできます。違いをまとめると、次のとおりです。

systemd timercron
ファイル.service と .timer の2つcrontab に1行
ログjournalctl -u で見られる自分でファイルに出す必要がある
止まっていた間の分Persistent=true で起動後に動く動かない
開始をずらすRandomizedDelaySec で書ける自分で sleep などを入れる
前提の指定After=docker.service などが書ける書けない
手動で試すsystemctl start で同じ条件で動くコマンドを手で打つ
systemd timer と cron の違い

書くファイルは増えますが、ログが残るのと、止まっていた間の分を取り戻せるのが大きいです。

VPS の運用で、結果を後から確かめたい処理には systemd timer が向いていると思います。

Docker の処理を回すときに便利な点

僕のタイマーは、どれも中で docker コマンドを使います。

After=docker.service を書いておけば、再起動の直後に Docker より先に動いて失敗する、ということを避けられます。

Docker Compose の基本的な使い方は、こちらの記事にまとめています。

よくある質問

タイマーを止めたいときは?

sudo systemctl disable –now で、.timer の方を止めます。

.service は、タイマーが止まれば呼ばれなくなります。

OnCalendar の時刻はどのタイムゾーンで動きますか?

タイムゾーンを書かなければ、サーバーのタイムゾーンで動きます。

末尾に Asia/Tokyo のように書くと、その時刻で動きます。

まとめ:.service と .timer を組で置き、list-timers と journalctl で確かめる

systemd timer は、何をするかを .service に、いつするかを .timer に書いて、.timer を enable すれば動きます。

OnCalendar は systemd-analyze calendar で確かめ、動いた結果は list-timers と journalctl -u で見ておけば安心です。

証明書の更新そのものの手順は、こちらの記事にあります。

VPS を借りてから Docker で運用するまでの流れは、こちらにまとめています。

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

この記事を書いた人

普段は主にPython開発をしています。
最近はAI駆動開発にも関わっています。