Mac を買い替えて旧 Mac から環境を移すときに、ついでに cron から launchd に乗り換えた。改めて cron・launchd・systemd timer の仕様差を整理して、変換ツールまで作ったのでその記録。

3形式で書き方が結構違う

まず、同じ「平日9時に実行」を3形式で書くとこんな感じ。

cron

# 平日9時に実行
0 9 * * 1-5

# 5分ごと
*/5 * * * *

# 毎月1日と15日の0時
0 0 1,15 * *

5フィールド(分 時 日 月 曜日)で表す。レンジ(1-5)・ステップ(*/5)・リスト(1,15)が書けるので、たいていのパターンは1行で収まる。

launchd(macOS)

単純なケースなら StartCalendarInterval で素直に書ける。

<key>StartCalendarInterval</key>
<dict>
  <key>Hour</key>
  <integer>9</integer>
  <key>Minute</key>
  <integer>0</integer>
</dict>

困るのは「平日9時」みたいな指定。launchd の CalendarInterval はレンジもステップも受け付けないので、曜日を1つずつ並べるしかない。

<key>StartCalendarInterval</key>
<array>
  <dict>
    <key>Weekday</key>
    <integer>1</integer>
    <key>Hour</key>
    <integer>9</integer>
    <key>Minute</key>
    <integer>0</integer>
  </dict>
  <dict>
    <key>Weekday</key>
    <integer>2</integer>
    <key>Hour</key>
    <integer>9</integer>
    <key>Minute</key>
    <integer>0</integer>
  </dict>
  <!-- ... 水・木・金も同様 -->
</array>

「5分ごと」みたいな等間隔のほうは StartInterval(秒数指定)で書く。CalendarInterval とは別の仕組みになっている。

<key>StartInterval</key>
<integer>300</integer>

systemd timer

OnCalendar はかなり柔軟で、cron に近い感覚で書ける。

[Timer]
OnCalendar=Mon..Fri *-*-* 09:00:00
Persistent=true

等間隔なら OnUnitActiveSec を使う。

[Timer]
OnBootSec=5min
OnUnitActiveSec=5min

内部は cron の5フィールドにそろえる

3形式を相互に変換するので、内部の表現は cron の5フィールド(minute, hour, day, month, weekday)にそろえた。フォームからの入力も一旦この形にまとめて、出力するときにそれぞれの形式に変換している。

変換の方針は大きく分けて2つ。

  • 純粋な等間隔(*/5 * * * * のように、1フィールドだけステップで他が全ワイルドカード): launchd は StartInterval、systemd は OnUnitActiveSec で出力
  • それ以外: cron のフィールドを数値の配列に展開して、launchd は CalendarInterval のエントリ群に、systemd は OnCalendar の式に変換

この「等間隔かどうか」の分岐を最初に入れておいたおかげで、あとの処理がだいぶすっきりした。

フィールドを数値の配列に展開する

変換の核になるのは、cron のフィールド(*/5 や 9-17 や 1,3,5)を数値の配列に展開する関数。

function expandField(field: string, min: number, max: number): number[] {
  if (field === '*') {
    const arr: number[] = [];
    for (let i = min; i <= max; i++) arr.push(i);
    return arr;
  }

  const results = new Set<number>();
  for (const part of field.split(',')) {
    // ステップ: */5 や 9-17/2
    const stepMatch = part.match(/^(\*|\d+-\d+)\/(\d+)$/);
    if (stepMatch) {
      const step = parseInt(stepMatch[2], 10);
      let start = min, end = max;
      if (stepMatch[1] !== '*') {
        const range = stepMatch[1].split('-');
        start = parseInt(range[0], 10);
        end = parseInt(range[1], 10);
      }
      for (let i = start; i <= end; i += step) results.add(i);
      continue;
    }
    // レンジ: 9-17
    const rangeMatch = part.match(/^(\d+)-(\d+)$/);
    if (rangeMatch) {
      for (let i = parseInt(rangeMatch[1], 10); i <= parseInt(rangeMatch[2], 10); i++)
        results.add(i);
      continue;
    }
    // 単一値
    const num = parseInt(part, 10);
    if (!isNaN(num)) results.add(num);
  }
  return Array.from(results).sort((a, b) => a - b);
}

ステップ・レンジ・リスト・単一値を正規表現で判定して、Set に入れてからソートしている。カンマ区切りの各パートを別々に処理するので、1-5,15,*/10 みたいな混ざった指定にも対応できる。

cron → launchd はエントリを全部並べる

展開した数値の配列を組み合わせて CalendarInterval のエントリを作る。ここがいちばんややこしかった。

// 各フィールドを展開して組み合わせを生成
const mList = isAllMinutes ? [undefined] : minutes;
const hList = isAllHours ? [undefined] : hours;
// ...

for (const h of hList) {
  for (const m of mList) {
    for (const w of wList) {
      const entry = {};
      if (m !== undefined) entry.Minute = m;
      if (h !== undefined) entry.Hour = h;
      if (w !== undefined) entry.Weekday = w;
      entries.push(entry);
    }
  }
}

ポイントは *(毎回)のフィールドをどう扱うか。cron の * は「すべての値にマッチ」という意味。launchd では CalendarInterval のキーを省略すると同じ意味になる。たとえば Minute を省略すると「毎分」。なので * は undefined で持っておいて、値があるときだけ XML のキーを出すようにした。

フィールドが多い式(0 9-17 * * 1-5 など)を展開すると、9時間 × 5曜日 = 45エントリになる。plist としては冗長だが、launchd の仕様上これ以外に正確に書く方法がない。ツールとしては正確さを優先して全部展開することにした。

cron → systemd はほぼそのまま書ける

systemd の OnCalendar は cron より表現力があるので、変換は割と素直。Mon..Fri みたいにレンジが書けるし、カンマ区切りのリストも使える。

フォーマットは 曜日 年-月-日 時:分:秒。曜日は Mon,Tue,Wed のように英語の略称で並べて、日時の部分は * がそのまま使える。cron のフィールドをほぼそのまま埋め込めるので、launchd みたいな展開はいらなかった。

つまずいたところ

cron によっては 7 も日曜

cron も launchd も 0 が日曜なので問題ないと思ってたけど、一部の cron 実装では 7 も日曜として扱う。今回は 0-6 に正規化することにしたものの、7 が入力されたときの処理を入れ忘れてたせいで最初はおかしな曜日が出ていた。

「次回実行日時」の計算が意外と重い

次の実行タイミングを5件出す機能もつけた。現在時刻から1分ずつ進めてマッチするか判定する単純なブルートフォースで書いたが、0 0 29 2 *(2月29日、つまりうるう年だけ)みたいなレアケースでは数年分回さないといけない。なので上限を1年分(525,600回)にして、見つからなければ「1年以内に実行予定がありません」と出すようにした。

等間隔の判定でほかのフィールドを見落としてた

*/5 * * * * は「5分ごと」なので StartInterval: 300 にしたい。でも */5 9-17 * * * は「9時台〜17時台の5分ごと」なので等間隔じゃない。最初は minute フィールドしか見てなかったので、ほかのフィールドに制約があるケースを見落としていた。「ステップ指定のフィールドが1つだけで、ほかが全部 *」のときだけ等間隔と判定するように直した。

できあがったもの

cron / launchd / systemd スケジュール変換ツールとして公開した。フォームで月・日・曜日・時・分を選ぶと3形式をタブで切り替えて確認できるし、手元の cron 式を貼り付ければ launchd・systemd に変換できる。

今回の Mac 移行では、旧 Mac の crontab にあった5つのジョブを全部このツールで launchd に変換した。レンジやステップがあると plist が長くなるのはどうしようもないが、手で展開するよりは漏れがない。Linux サーバー側の systemd timer もここから作ってる。

関連記事