本文へスキップ
cron.surf

Kubernetes CronJob を10 分ごとに実行する

Kubernetes で「10 分ごと」を表す式は */10 * * * * です。以下に、そのまま使える設定、次回の実行時刻、注意点をまとめます。 Kubernetes の CronJob は spec.schedule で 5 フィールドの cron を読み、実行ごとに Job を作ります。

*/10 * * * *ツールで開く

“10 分ごと”

CronJob マニフェスト

every-10-minutes.yaml
apiVersion: batch/v1
kind: CronJob
metadata:
  name: every-10-minutes
spec:
  schedule: "*/10 * * * *"
  timeZone: "Etc/UTC"
  concurrencyPolicy: Forbid
  startingDeadlineSeconds: 300
  jobTemplate:
    spec:
      template:
        spec:
          restartPolicy: OnFailure
          containers:
            - name: job
              image: busybox:1.37
              command: ["sh", "-c", "echo running every-10-minutes"]

Kubernetes の注意点

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

よくある質問

Kubernetes で「10 分ごと」を表す cron 式は?

*/10 * * * * です。意味:10 分ごと

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 を確認してください。