cron から systemd タイマーへ

ジョブを cron から systemd タイマーへ移行するとは、5フィールドの cron 行を .timer ユニットに書き換えることです。その OnCalendar 式が、対応する .service ユニットをいつ実行するかを決めます。そして cron 行を削除する前に、両方のスケジュールが一致することを証明します。変換は機械的に見えます。分と時はそのまま対応し、月もそのまま対応し、ほとんどの単純なスケジュールはきれいに翻訳できます。落とし穴は、見た目が同じスケジュールでも両方のスケジューラが同じ意味で理解しているわけではないことです。食い違うのは、ひと目では気づけない場所ばかりです。「日」と「曜日」の組み合わせ、春の時刻繰り上げで消える時間帯の実行、31日に設定された月次ジョブ。cron ⇄ systemd タイマー変換ツールで両方を変換し証明できます。各々の今後100回の実行を計算し、不一致を指摘します。すべてブラウザ内で行われます。

チームが cron を離れる理由——それでも単純なジョブには cron で十分な理由

cron は Unix で最も古いスケジューラであり、その制限こそチームが離れる理由です。cron ジョブは別のサービスが準備できるのを待てません。ジョブがデータベースを必要とする場合、cron には依存関係の順序がないため、構わず実行して失敗します。出力はローカルメールか、どこにも届かず、静かに失敗するジョブは静かに失敗し続けます。問い合わせるジャーナルも、確認できる状態もありません。カレンダーは5フィールドしかないため、「毎月第1月曜日」や「2月の末日」と言う方法がありません。予定の分にマシンが電源オフやスリープ状態だった場合、その実行はそのまま失われます。systemd タイマーはこれらを一つずつ修正します。After= と Requires= による依存関係、他のユニットと同じくジャーナルに記録されるすべての実行、Persistent= による未実行分のキャッチアップ、曜日名・日付範囲・月末構文を持つ OnCalendar 式です。

だからといって cron が時代遅れというわけではなく、新しいからといって動いているジョブを移行するのは間違いです。cron は今でも、単純なユーザーごとのジョブ、10年間変わっていないスケジュール、systemd のないあらゆるシステム——コンテナ、最小イメージ、BSD や macOS ホスト——に適したツールです。判断基準はどちらのスケジューラが新しいかではなく、ジョブが何を必要とするかです。順序、ログ、停止後のキャッチアップ、あるいは cron では表現できないカレンダーが必要なら移行してください。一度も失敗したことがなく、誰もデバッグしたことがない1行のスケジュールなら、そのままにしておいてください。何も得られない移行は、見返りのないリスクです。本記事が扱うのは、実際に得るものがある移行です。ジョブの実行時刻を黙って変えることのない方法で行います。

DOM+DOW の罠:実行回数を黙って倍増させる唯一の移行バグ

cron 移行で最も危険な行は、「日」と「曜日」の両方を制限する行です。典型例は 0 0 15 * 5 です。ほとんどの人はこれを「15日の金曜日の深夜」と読みます。その意味ではありません。crontab(5) マニュアルページは規則をはっきり述べています。両方の「日」フィールドが制限されている場合——どちらも「*」を含まない場合——コマンドはどちらか一方のフィールドが一致したときに実行されます。つまり 0 0 15 * 5 は毎月15日の深夜に実行され、さらに毎週金曜日にも実行されます。月に約5回、1回ではなく。その行が存在して以来ずっとそう動いています。これを1行の OnCalendar に変換した人は、知らないうちにスケジュールを変更したことになります。

OnCalendar の意味は正反対です。systemd.time(7) マニュアルページは Thu,Fri 2012-*-1,5 という例を挙げ、月の1日または5日を指すが「その日が木曜日または金曜日である場合に限る」と述べています。日付と曜日は両方とも一致しなければなりません。したがって安易な変換 Fri *-*-15 00:00 は、15日が実際に金曜日であるときにしか実行されません。年に数回だけで、金曜日の実行と15日の実行のほとんどが黙って消えます。正しい変換は、1つの .timer ユニットに2行の OnCalendar を書くことです——*-*-15 00:00 と Fri *-*-* 00:00——なぜなら systemd.timer(5) マニュアルページは OnCalendar を複数回指定できるとしており、いずれかの式が到来すればユニットがトリガーされるからです。この和集合こそ変換ツールの要点です。スケジュールを黙って変える1行を出すのではなく、両方の行を出し、そのエントリを「和集合」として明示します。

夏時間と月末:両方のスケジューラが本当に食い違う場所

夏時間は、両方のスケジューラが原則的にも一致しなくなる点であり、マニュアルページはこの非対称性について正直です。cron については crontab(5) が規則を明示しています。春の繰り上げで「消える時間」のような存在しない時刻は決して一致しないため、その日の 02:30 に予定されたジョブは単に実行されません。秋の繰り下げで2回現れる時刻については、一致するジョブが2回実行されます。タイマーについては、systemd のマニュアルページには同等の規則がありません。systemd.time(7) と systemd.timer(5) はカレンダー構文を詳しく説明していますが、消えた時間帯の中で OnCalendar の実行がどうなるかは、どちらのページも述べていません。この沈黙は事実であり、推測で埋めるべき欠落ではありません。本記事はマニュアルページにない規則をでっち上げることはしません。

月末も同じ話の縮小版です。31日に設定された cron 行は、31日のない月を単にスキップします。OnCalendar も既定では同じです。しかし OnCalendar には cron ではまったく表現できない構文もあります。たとえば「~」による月末形式です。*-02~01 は2月の末日、Mon *-05~07/1 は5月の最後の月曜日を意味します。実践的な結論は単純です。可能なら時刻に敏感なジョブを 02:00–03:00 の外に置き、できない場合は夏時間の境界と月末をまたぐ今後100回の実行表を生成し、推測ではなく表を読んでください。マニュアルページが沈黙している場所では、表だけが正直な答えです。表を実行し、思い込まないでください。AccuracySec も同じです。タイマーは設定した秒ちょうどに発火するとは限らないため、正確な秒に依存するスケジュールは、式をきつくするのではなく別の設計が必要です。

証明ワークフロー:切り替える前に今後100回の実行を比較する

証明ワークフローは短く、それを飛ばすことこそ移行バグが本番環境に到達する経路です。cron 行を変換したら、同じ開始時刻・同じタイムゾーンから両方の今後100回の実行を並べて計算し、最初の数回ではなく100回すべてに対する結論を読んでください。月次の食い違いは最初の10行には現れないかもしれません。夏時間の食い違いは、ウィンドウが時刻変更をまたがない限りまったく現れません。だから表は10回ではなく100回まで計算するのです。変換ツールは両方の表をブラウザで計算し、最初に食い違う行を強調表示します。systemd-analyze calendar は一度に1つの OnCalendar 式しか検証できません。タイマー側の確認には役立ちますが、両側の比較はできません。

ワークフローの後半は、次の人のための手がかりです。元の cron 行を .timer または .service ファイルにコメントとして残し、それを置き換えた OnCalendar 行のそばに置いてください。ユニットを読む誰もが、何を置き換えたのか、なぜ2行あるのかが分かるようにします。元の行がない変換は、誰も監査できないスケジュールです。6か月後、2行目の OnCalendar が意図的なものか残り物か誰も覚えていません。「整理する」誘惑が常につきまといます。それが金曜日の実行が2度目に消える経路です。コメントアウトされた cron 行は1行のコストで、問われる前に答えを用意します。

安全な移行パス:drop-in、Persistent、@reboot の隙間

/usr/lib/systemd/system 内のパッケージ化されたユニットファイルを手で編集してはいけません。次のパッケージ更新で上書きされ、移行は強化とともに黙って消えます。サポートされている方法は drop-in オーバーライドです。systemctl edit myjob.timer を実行すると、変更は /etc/systemd/system/myjob.timer.d/override.conf に保存されます。出荷ファイルより優先され、アップグレードを生き延び、1ファイルを削除すれば撤回できます。その後リロードし、タイマーを有効化し、systemctl list-timers で実際に武装されていることを確認してください。このコマンドは次回実行時刻を表示します。変換結果が意図したスケジュールかどうかを教えてくれる唯一の数字です。

2つの設定は、既定値ではなく意識的な決定に値します。スリープするノートPCやデスクトップには Persistent=true が正しい選択です。実行予定時にマシンの電源がオフだった場合、サービスは次の機会に1回だけ実行されます。その実行が黙って二度と起こらないのではなくなります。ただしこれは1回のキャッチアップであり、見逃した実行をすべて再生するものではなく、OnCalendar タイマーにのみ適用されることに注意してください。そして @reboot には真のタイマー相当物がありません。起動後一定時間で発火する OnBootSec= が最も近い類似物ですが、同一ではありません。起動時に1回実行するのではなく、起動からの相対時間であり、コンテナ内では OnStartupSec= にマッピングされます。ジョブが起動ごとにちょうど1回実行されなければならない場合、OnBootSec= が答えですが、その違いをユニットに記録してください。マニュアルページが同一ではないと言っているのに、変換が正確であるふりをしてはいけません。

先に監査する習慣:変換し、証明し、並行実行し、切り替える

最も安全な切り替えは、意図的に退屈なものです。変換し、今後100回の実行表で証明し、ジョブが冪等な場合は cron 行とタイマーを1週間並行実行して結果を比較します。ログ、出力、副作用です。1週間は完全な週サイクルをカバーし、近くにあれば夏時間の境界や月末も通常カバーします。証明表が予測したすべての実行は、ジャーナル内で、それが複製する cron 実行の隣に現れます。両方が丸1週間一致して初めて cron 行を削除します。コメントアウトしたコピーは前のセクションの手がかりとしてユニットに残します。

ジョブが冪等でない場合——メールを送る、顧客に課金する、データベースを変更する——両方を実行してはいけません。重複こそ避けようとしているバグだからです。代わりにより徹底的に証明してください。100回の実行表を夏時間の境界と月末をまたがせ、最初に食い違う行を手で確認し、古い行をユニットにコメントとして残したまま1ステップで切り替えます。その後、完成したユニットを他のユニットと同じように監査します。systemd ユニット監査ツールで採点し、姉妹記事 systemd サービスを堅牢化する方法 を読んでください。移行されたタイマーは他のユニットと同じサンドボックスの問いを継承するからです。タイマー、サービス、証明をバージョン管理に入れてください。1台のマシンにしか存在しないスケジュールは、再構築1回で忘れ去られます。

出典

よくある質問

OnCalendar は単に構文の違う cron ですか?

いいえ。構文は重なりますが、意味は重要な点で異なります。両方の「日」フィールドが制限されている場合、cron は「日」と「曜日」を OR で結び、OnCalendar は AND で結びます。OnCalendar は秒、01..07 のような日付範囲、曜日範囲、タイムゾーン、「~」による月末構文をサポートします。5フィールドの cron 行ではどれも表現できません。1つのユニットに複数の OnCalendar 行を書くことも、OnBootSec= のような単調タイマーもサポートします。ほとんどの単純なスケジュールはきれいに翻訳できます。罠となるのは DOM+DOW の組み合わせ、秒、@reboot、日付範囲であり、これらこそ変換ツールが推測ではなく指摘するケースです。

春の繰り上げで消える時間帯にタイマーの実行が入るとどうなりますか?

マニュアルページには書かれていません。crontab(5) は cron について明示しています。消えた時間帯に予定されたジョブは決して実行されず、繰り返される時間帯に予定されたジョブは2回実行されます。systemd.time(7) と systemd.timer(5) には OnCalendar についての同等の規則がありません。春の繰り上げの日の 02:30 にタイマーが cron と同じように振る舞うと想定してはいけません。正直な確認方法は証明表です。変換ツールで夏時間の境界をまたぐ今後100回の実行を生成し、実際に何が起こるかを読んでください。ジョブが時刻に敏感な場合、最も安全な選択は 02:00–03:00 を完全に避けることです。

移行中に cron とタイマーを並行実行できますか?

はい、ジョブが冪等な場合——2回実行しても同じ結果になる場合——に限ります。両方を1週間実行し、ログと出力を比較し、両方が一致してから cron 行を削除してください。ジョブが冪等でない場合——メールを送る、支払いを受ける、状態を変更する——両方を実行してはいけません。重複した実行自体が障害だからです。その場合は100回の実行表でスケジュールを証明し、1ステップで切り替え、古い cron 行をユニットにコメントとして残して、変換が監査可能であり続けるようにしてください。