- VPS で、証明書の更新やバックアップを決まった時間に自動で動かしたい
- cron の代わりに systemd timer を使う方法を知りたい
- タイマーがちゃんと動いたのか、結果をどこで見ればいいか分からない
systemd timer は、.service(何をするか)と .timer(いつするか)の2つのファイルを組で作るだけで使えます。
この記事では、僕の VPS で実際に回している5つのタイマーを例に、書き方と確かめ方を紹介します。
OnCalendar の書式、RandomizedDelaySec・Persistent の意味、cron との違いもまとめます。
| 項目 | 内容 |
|---|---|
| VPS | KAGOYA CLOUD VPS(2コア・メモリ2GB) |
| OS | Ubuntu 26.04.1 LTS |
| Docker | Docker Engine 29.9.3・Docker Compose 5.7.0 |
僕の VPS で回しているタイマー
いま動かしているのは、次の5つです。中身はどれも、シェルスクリプトを1つ実行するだけです。
| タイマー | すること | いつ(OnCalendar) |
|---|---|---|
| 証明書の更新 | certbot renew を実行して nginx を reload | daily |
| 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 |
nginx とベースイメージの更新は、同じ日に重ならないよう 45分ずらしています。
Docker の掃除のスクリプトは1行だけ
たとえば Docker の掃除は、次の1行のスクリプトをタイマーで呼んでいるだけです。
#!/bin/sh
set -eu
docker builder prune -af --filter "until=72h"VPS でアプリのイメージをビルドしていると、ビルドキャッシュがたまってディスクを使います。これを週に1回消しています。
.service と .timer を組で作る
ここからは、証明書の更新を例に、ファイルの書き方を見ていきます。
ファイルは /etc/systemd/system/ に置きます。.service と .timer の名前(拡張子の前)をそろえると、タイマーが同じ名前のサービスを動かします。
.service:何をするかを書く
# /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.service | Docker が動いていることが前提 |
After=docker.service | Docker が起動してから動かす |
Type=oneshot | 1回動いて終わる処理(常駐しない) |
ExecStart | 実行するコマンド(絶対パスで書く) |
中で docker コマンドを使うので、Docker より先に動かないようにしています。
.timer:いつ動かすかを書く
# /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 で、起動時にタイマーが有効になるようにします。
OnCalendar の書き方
OnCalendar は「曜日 年-月-日 時:分:秒 タイムゾーン」の形で書きます。
daily・weekly などの短い書き方
よく使う間隔には、短い書き方があります。
| 書き方 | 意味 |
|---|---|
daily | 毎日 0時0分(*-*-* 00:00:00) |
weekly | 毎週月曜の 0時0分(Mon *-*-* 00:00:00) |
monthly | 毎月1日の 0時0分 |
日と時刻を指定する
僕の nginx イメージの更新は、毎月1・11・21日の 4時30分に動かしています。
OnCalendar=*-*-01,11,21 04:30:00 Asia/Tokyo* は「すべて」、01,11,21 のようにカンマで並べると「そのどれか」です。
末尾にタイムゾーンを書くと、サーバーのタイムゾーンの設定に関係なく、日本時間で動きます。
月に3回なので、21日から翌月1日までだけは、月の長さによって 8〜11日の間隔になります。
systemd-analyze calendar で書式を確かめる
書いた OnCalendar が正しいか、次にいつ動くかは、systemd-analyze calendar で確かめられます。
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回抜けると次まで長く空きます。僕は全部のタイマーに付けています。
タイマーを有効にして、動いたか確かめる
ファイルを置いたら、読み込んで有効にします。
読み込んで有効にする
sudo systemctl daemon-reload
sudo systemctl enable --now myserver-cert-renew.timer--now を付けると、有効にするのと同時にタイマーを動かし始めます。
systemctl list-timers で次の予定を見る
systemctl list-timersNEXT(次に動く日時)、LEFT(あとどれくらいか)、LAST(前に動いた日時)、PASSED(それからどれくらいか)が、タイマーごとに並びます。
自分のタイマーが一覧にあり、NEXT に日時が入っていれば、予定どおり待っている状態です。
手動で1回動かしてみる
タイマーを待たずに試すときは、.service の方を start します。
sudo systemctl start myserver-cert-renew.service僕もタイマーを入れたときに、証明書の更新とバックアップのサービスを手動で動かし、成功することを確かめました。
journalctl -u で結果を見る
スクリプトが出した表示は、systemd のログに残ります。
journalctl -u myserver-cert-renew.service -n 50
systemctl status myserver-cert-renew.serviceスクリプトが 0 以外で終わると、サービスは failed になります。失敗したサービスは、まとめて一覧で見られます。
systemctl --failed僕の nginx イメージの更新は、新しいイメージで nginx -t が通らなければ、古いイメージのまま動かし続けて 1 で終わるようにしています。
こうしておくと、更新しなかったことが failed として残ります。
失敗したときにメールなどで知らせる仕組みは、まだ作っていません。ときどき list-timers と –failed を見るようにしてください。
長いログを読むときは、less を使うと便利です。

cron との違い
同じことは cron でもできます。違いをまとめると、次のとおりです。
| systemd timer | cron | |
|---|---|---|
| ファイル | .service と .timer の2つ | crontab に1行 |
| ログ | journalctl -u で見られる | 自分でファイルに出す必要がある |
| 止まっていた間の分 | Persistent=true で起動後に動く | 動かない |
| 開始をずらす | RandomizedDelaySec で書ける | 自分で sleep などを入れる |
| 前提の指定 | After=docker.service などが書ける | 書けない |
| 手動で試す | systemctl start で同じ条件で動く | コマンドを手で打つ |
書くファイルは増えますが、ログが残るのと、止まっていた間の分を取り戻せるのが大きいです。
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 で運用するまでの流れは、こちらにまとめています。

