Cronによるスケジュールワークフロー
cron式を使用してGitHub Actionsワークフローをスケジュール実行。日次ビルド、週次依存関係更新、ナイトリーテスト、タイムゾーンの考慮事項を解説。
Advanced
詳細な説明
Cronによるスケジュールワークフロー
GitHub Actionsは POSIX cron構文を使用したscheduleトリガーをサポートしています。スケジュールワークフローはデフォルトブランチで実行され、ナイトリービルド、依存関係の更新、定期的なヘルスチェックなどの繰り返しタスクに有用です。
Cron構文
┌───────────── 分 (0-59)
│ ┌───────────── 時 (0-23)
│ │ ┌───────────── 日 (1-31)
│ │ │ ┌───────────── 月 (1-12)
│ │ │ │ ┌───────────── 曜日 (0-6, 日曜=0)
│ │ │ │ │
* * * * *
よく使うスケジュール
| 式 | 説明 |
|---|---|
0 0 * * * |
毎日午前0時UTC |
0 */6 * * * |
6時間ごと |
0 6 * * 1-5 |
平日午前6時UTC |
0 0 1 * * |
毎月1日 |
0 0 * * 0 |
毎週日曜午前0時 |
重要な注意事項
- すべてのcron時刻はUTCです。タイムゾーンに応じて調整してください。
- スケジュールワークフローはデフォルトブランチでのみ実行されます。
- 高負荷時にはGitHubがスケジュールワークフローを遅延させる場合があります。
- 最小間隔は5分ごとですが、GitHubは15分未満の間隔を推奨していません。
ユースケース
ナイトリーE2Eテスト、週次依存関係監査、定期的なデータベースバックアップ、古いissueのクリーンアップ、または手動トリガーなしで自動実行すべき繰り返しメンテナンスタスクの実行。