cron式を構築する方法

Cron式は、Linux、クラウドプラットフォーム、CI/CDパイプライン、タスクスケジューラで繰り返しスケジュールを定義する標準的な方法です。構文はコンパクトですが直感的ではありません。ビジュアルなcronジェネレーターを構築すると、ジョブがいつ実行されるか正確に表示され、デプロイ前によくあるエラーをキャッチし、自動化の最もエラーが起きやすい部分から推測を取り除けます。5つのフィールド、特殊文字、最もよくある落とし穴を理解すれば、自信を持って任意の繰り返しスケジュールを指定できます。

cronの簡単な歴史

最初のcronは1979年頃にVersion 7 UnixのBrian Kernighanから来ました。それは毎分設定を再読み込みし、期限のものを何でも実行しました。Paul Vixieは1987年にそれを書き直し、現在Vixie cronと呼ばれるものになりました。これはほとんどのLinuxディストリビューションが今も出荷するバージョンです。Vixie cronは、ユーザーごとのcrontab、環境変数、@rebootキーワード、形式を非管理者にも使いやすくするいくつかの生活の質を向上させる機能を追加しました。

5フィールドの構文は40年以上、ほとんど変わっていません。Amazon EventBridge、Google Cloud Scheduler、Kubernetes CronJob、GitHub Actions、GitLab CI、Jenkins、Airflow、n8n、その他多くのシステムが、わずかな拡張だけで同じコンパクトな形式を消費します。その安定性こそが、cronを一度学んで二度と学び直さない価値のあるものにしています。スキルは時計で動作する自動化のどこにでも転送可能です。

Cron構文

標準のcron式は、スペースで区切られた5つのフィールドを持ちます。各フィールドは時間の1スライスをコントロールし、すべてのフィールドが現在の瞬間に一致するとジョブが実行されます。

┌───────────── 分(0から59)
│ ┌───────────── 時(0から23)
│ │ ┌───────────── 日(1から31)
│ │ │ ┌───────────── 月(1から12、またはJAN-DEC)
│ │ │ │ ┌───────────── 曜日(0から6、Sun=0、またはSUN-SAT)
│ │ │ │ │
* * * * *

フィールドは時、分、月についてANDで結ばれますが、日と曜日はVixie cronではORで結ばれます。これは、0 12 1 * 1が毎月1日に発火し、毎週月曜の正午にも発火することを意味します。1日に当たる月曜だけではありません。この罠は初めての人をほぼ全員捕まえます。

一般的なcronスケジュール

最も頻繁に手を伸ばすパターン:

多くのシステムは、同等の5フィールド式に展開されるショートハンドエイリアスも受け入れます: @yearly、@monthly、@weekly、@daily、@hourly、@reboot。これらは簡潔ですが普遍的ではないので、依存する前にプラットフォームを確認してください。

cron式を構築する手順

1. 粒度を選ぶ: 毎分、毎時、1日1回、週1回、または月1回が必要ですか?ニーズを満たす最も粗い設定から始めてください。
2. ビジュアルコントロールを使う: ドロップダウンから分、時、日、月、曜日の値を選択します。または「毎時」や「毎日真夜中」のようなプリセットから始めて調整します。
3. 次の実行時刻をプレビュー: ジェネレーターは次の5つの実行時刻を表示し、スケジュールが期待通り発火するかを確認できます。
4. タイムゾーンを健全性チェック: プレビューはローカル時刻ではなく、ジョブを実行するサーバーまたはスケジューラのタイムゾーンと一致する必要があります。
5. 式をコピーして、crontab、GitHub Actions YAML、AWS EventBridgeルール、または使うスケジューラーに貼り付けます。
6. 最終スケジュールをコミットする前に短い間隔でテスト: 素早い*/5 * * * *はジョブが発火することを証明します。2、3回の実行が着地したら、実際の式に交換します。

特殊文字と演算子

cronは任意のフィールド内で小さくて強力な演算子セットをサポートします。

バニラのVixie cronは最初の5行のみをサポートします。高度な演算子(L、W、#、?)はJavaスケジューリングライブラリのQuartzから来ており、AWS EventBridgeとその他のいくつかのクラウドスケジューラーに採用されました。これらは可搬性がないため、汎用Linuxボックスで実行する必要のあるコードに混ぜないでください。

異なるプラットフォームでのcron

cronは単一の標準ではなく、関連する構文のファミリーです。スケジューラーがどの方言を話すかを知ることは、デバッグの何時間も節約します。

複数のプラットフォームで実行する必要のあるスケジュールを書くなら、すべてのシステムが理解する保守的な5フィールドサブセットに固執してください。L、W、#に手を伸ばすのは、目的地がそれらをサポートすると分かっているときだけです。

よくある落とし穴

• 日と曜日はORで結ばれる: 0 9 15 * 1のような式は、毎週月曜と毎月15日の両方で発火し、15日が月曜に当たるときだけではありません。交差させるには、通常は外部ラッパーまたは異なるスケジューラーが必要です。
• タイムゾーンの混乱: サーバーcrontabはほぼ常にUTCで実行されます。東部時間の午前9時が必要なら、冬は0 14 * * * UTC、夏は夏時間のため0 13 * * * UTCです。タイムゾーンヒントをサポートするスケジューラーを使うか、すべてをUTCに正規化してください。
• 夏時間の遷移: 02:30ローカル時刻にスケジュールされたジョブは、時計が戻されるとき2回実行されることがあり、進めるときはまったく実行されないかもしれません。01:00から03:00の窓の外に敏感なジョブをスケジュールするか、UTCを使ってください。
• VixieのMAILTOの罠: ジョブがstdoutに何かを印刷すると、Vixie cronはcrontabを所有するユーザーに出力をメールします。メールリレーのないサーバーでは、これは/var/spool/mailを素早く満たします。>>/var/log/myjob.log 2>&1で出力をログファイルにリダイレクトしてください。
• 環境はログインシェルではない: cronは取り除かれた環境で実行されます。.bashrcからのPATHなし、virtualenvなし、nvmなし。crontabの先頭で必要な変数を設定するか、絶対パスでスクリプトを呼び出してください。
• パーセント記号はエスケープが必要: Vixie crontabでエスケープされていない%は、コマンド内の改行文字として解釈されます。コマンドがリテラルなパーセント記号を必要とする場合、つねに\%としてエスケープしてください。たとえばdate +"%Y-%m-%d"の呼び出しで。
• 長時間実行されるジョブの重複: cronは、前のジョブがまだ実行中だからといって実行をスキップしません。ジョブが間隔より長くかかる可能性があるなら、ロックファイル(flock、setlock)でラップするか、並行性を扱うジョブランナーを使ってください。
• 59分でのオーバーフロー: */40 * * * *は40分ごとに発火しません。ステップ値がフィールドの境界を回り込むため、毎時の0分と40分に発火します。真の40分間隔には、より豊富なスケジューラーが必要です。
• 分フィールドの0を忘れる: * 9 * * *は09:00ではなく、09:00から09:59まで毎分実行されます。時間ごとに1回の発火が欲しいなら、分フィールドに明示的な値が必要です。
• cronはラップトップで信頼できない: anacronがそのために存在します。Vixie cronはスリープ後に見逃した実行に追いつかないため、03:00にスケジュールされた毎日のバックアップは、その時間にラップトップが閉じていたら実行されません。anacron、Persistent=trueのsystemdタイマー、またはmacOSのlaunchd plistを使ってください。

cronの代替

一部のワークロードでは、cronの粗い分解像度と簿記の欠如が痛み始めます。最も一般的なアップグレード:

cronは大多数の1回限りの繰り返しジョブに対する正しい答えのままです。他のツールは、状態、リトライ、依存関係、マシン間の調整が必要なときに輝きます。

プライバシーとcronジェネレーター

cron式ジェネレーターは完全にブラウザ内で動作します。構築したスケジュール、次の実行時刻のプレビュー、コピーされた式は当社のサーバーに触れません。どの式が生成されたかのログも、どのプリセットが人気かのテレメトリも、あなたが取り組んでいたスケジュールを再構築する方法もありません。cron式は表面上は個人データではありませんが、ジョブのスケジュール(夜間のデータベースエクスポート、週次の請求実行、毎時のパートナーへの同期)はビジネスがどう運営されているかについて多くを明かす可能性があります。その情報をクライアントサイドに保つことで、インフラパターンを第三者に偶然漏らすのを避けられます。スケジュールを選ぶような日常のタスクには、プライバシーのデフォルトはそれらのスケジュールが表すものの機密性に一致すべきです。