本文へスキップ
cron.surf

Kubernetes の cron スケジュール

Kubernetes の CronJob は spec.schedule で 5 フィールドの cron を読み、実行ごとに Job を作ります。 スケジュールを選ぶと、正確な式、そのまま使える設定、次回の実行時刻がわかります。

スケジュール

Kubernetes の注意点

曜日は 0〜6パーサーの上限は 6 です。日曜日は 0 と書きます。7 はエラーです。
取りこぼしが多すぎると止まるCronJob が 100 回以上起動を逃すと、コントローラーは起動しなくなります。startingDeadlineSeconds を設定して古い取りこぼしを数えないようにします。
実行が重なるconcurrencyPolicy の既定は Allow なので、遅い Job が次の回と重なることがあります。Forbid か Replace を使います。
日付フィールドの */n は「指定あり」制限なしと見なされるのは * か ? だけです。0 0 */2 * 1 は奇数日または月曜日に実行されますが、Vixie cron では奇数日かつ月曜日と解釈されます。

Kubernetes との相互変換

よくある質問

Kubernetes のスケジュールはどのタイムゾーンで動きますか?

spec.timeZone がなければ kube-controller-manager のローカルタイムゾーン(多くは UTC)です。spec.timeZone(Kubernetes 1.27 で安定版)に IANA 名を設定します。schedule 内の CRON_TZ や TZ は拒否されます。

CronJob は @daily に対応していますか?

対応しています。spec.schedule で @yearly、@monthly、@weekly、@daily、@hourly が使えます。

CronJob が 2 回動いた、または動かなかったのはなぜですか?

CronJob は予定時刻ごとにおおよそ 1 つの Job を作るもので、ちょうど 1 回は保証しません。Job を繰り返しても安全にし、startingDeadlineSeconds と concurrencyPolicy を確認してください。