メインコンテンツへスキップ

GitHub Actionsの定期実行を業務に使う前に:UTC・遅延・60日停止の注意点

    毎朝のデータ確認や集計を自動化したい。しかし、そのためだけにサーバーを用意し、管理する仕事まで増やしたくはない。そんなとき、GitHub Actionsの定期実行は選択肢になる。

    ただし、予定を書けば、その時刻に必ず処理が始まるわけではない。時刻の基準、混雑による遅延、実行対象のブランチを理解しておく必要がある。タイトルにある「60日停止」は、パブリックリポジトリで活動がない場合の自動無効化を指す。すべてのリポジトリに共通する条件ではない。

    本稿の仕様は、2026年11月16日にGitHub Docs「Events that trigger workflows」のschedule節で確認した。cron式そのものの詳説や、Windowsタスクスケジューラ、GASの設定手順には広げず、GitHub Actionsを実行基盤に選ぶ際の判断に絞る。

    サーバーなしで定期処理を回す選択肢としてのGitHub Actions

    GitHub Actionsでは、処理の手順をワークフローとして定義し、scheduleを使って定期実行の予定を設定できる。自分で常時稼働するサーバーを管理せず、簡単なスクリプトを定期的に動かしたい場合に検討しやすい。

    ただし、設定にはYAMLやcron式を扱う場面がある。ノーコードツールで作った処理を呼び出す場合も、呼び出し先の仕組みと、GitHub Actions側の定期実行は分けて考える必要がある。本稿で扱うのは後者である。

    導入判断では、まず「いつ始めたいか」と「いつまでに結果が必要か」を分けたい。開始予定だけを決めると、遅延した場合に仕事を続けられるか判断できない。

    たとえば、仮想の例として、朝の業務で参照する集計結果を更新するとする。担当者が確認するまでに余裕があるなら、定期実行を組み込む設計を検討できる。一方、決まった時刻の処理開始が業務の成立条件なら、scheduleの遅延や破棄をどう扱うかを先に決める必要がある。

    以下の運用手順やチェック項目は筆者の推奨であり、公式ドキュメントが定める要件ではない。公式の仕様と、それに備えるための設計提案を区別して読み進めてほしい。

    scheduleの基本:書き方と最短間隔

    scheduleで使うcron式は、左から「分、時、日、月、曜日」の順に並ぶ。最短の実行間隔は5分である。短い間隔を設定できることと、その間隔どおりに実行されることは分けて理解したい。

    日本時間9時はUTC0時である。timezoneを指定しない場合、毎日の日本時間9時を予定する式は 0 0 * * * となる。末尾の各 * は、日、月、曜日を限定しない指定である。

    ただし、UTCへの換算は必須ではない。scheduleには任意のtimezone指定があり、IANAタイムゾーン文字列を使って時刻の基準を指定できる。日本時間を基準にするなら、cronに 0 9 * * *、同じschedule項目のtimezoneに Asia/Tokyo を指定する形で書ける。

    設定の順序は、希望する日本時間を決め、timezoneを指定するか選び、その基準でcron式を書く、という流れである。timezoneを使わない場合に、日本時間からUTCへ換算する。

    全体のつながりを見るため、以下はログに文字を出すだけの最小ワークフローの例である。短く示すため、YAMLで使えるフロー形式で記載する。業務処理を完成させた例ではない。

    {on: {schedule: [{cron: '17 0 * * *'}]}, jobs: {check: {runs-on: ubuntu-latest, steps: [{run: 'echo scheduled-check'}]}}}

    この例の予定は、日本時間の毎日9時17分である。分をずらす理由は次節で説明する。リポジトリ内のスクリプトを実行する場合は、その取得や実行の手順を別途組み込む必要がある。まずは小さな確認用処理で、設定から実行履歴までの流れを確かめたい。

    時刻のずれの原因:UTC既定と毎時0分付近の遅延・破棄

    予定した時刻に結果が見当たらない場合、時刻の解釈と実行の遅れを分けて確認する。

    時刻の解釈では、timezone未指定時の既定がUTCである点が重要だ。日本時間9時のつもりで時の欄に9を書くと、UTCの9時として扱われる。設定を見直すときは、cron式だけでなく、timezoneの有無も一緒に確認する。timezoneを指定すれば、日本時間のまま予定を書くこともできる。

    一方、基準時刻が正しくても、GitHub Actionsの負荷によってscheduleイベントが遅延する場合がある。公式ドキュメントは、毎時の開始時点を高負荷になりやすい時間帯として挙げている。負荷が十分に高い場合には、キューに入ったジョブの一部が破棄されることもある。

    そのため、「遅れても待てば必ず動く」という前提は置けない。分をずらすことは遅延の可能性を減らす工夫であり、時刻どおりの実行を保証する設定ではない。

    たとえば、仮想の例として、日本時間9時前後に確認処理を始めたいなら、timezone未指定で 17 0 * * * とする方法がある。UTC0時台の中で分をずらし、日本時間9時17分を予定する式である。17分という値は説明用の例であり、その分なら混雑しないという意味ではない。

    運用では、予定時刻と実際の開始時刻、さらに業務上の完了時刻を区別して記録するとよい。「予定から遅れた」のか、「処理自体に時間がかかった」のかを後から判断しやすくなる。

    動かない条件:デフォルトブランチと60日無効化

    scheduleの対象はデフォルトブランチ上のワークフローである。ワークフローファイルが別のブランチにあるだけでは定期実行されない。実行には、デフォルトブランチの最新コミットが使われる。

    設定を変更した後は、編集した内容がデフォルトブランチに反映されているか確認したい。別のブランチで修正を終えたつもりでも、定期実行が参照する内容は変わっていない可能性がある。ブランチ名を思い込みで判断せず、対象リポジトリの設定と照合する。

    もう一つが、パブリックリポジトリの自動無効化である。リポジトリの活動が60日間ない場合、定期実行のワークフローは自動的に無効化される。「最後の処理が成功してから60日」という説明に置き換えてはいけない。

    また、ここで参照する記述から、活動に該当する操作を独自に決めつけないことも大切だ。「ワークフローが動いているから活動として十分だろう」と推測せず、無効化の有無を確認対象に含める。

    たとえば、仮想の例として、作成後はほとんど編集しない公開リポジトリで、確認処理だけを定期実行しているとする。この場合、コードの修正予定がなくても、定期実行の状態を点検する運用が必要になる。

    動かないときは、業務スクリプトを直す前に、ワークフローが有効か、デフォルトブランチにあるか、予定の基準時刻が正しいかを確認する。起動条件の問題と、起動後の処理の問題を切り分けるためである。

    設定前のチェックリスト

    設定前には、cron式を先に作るより、業務側の条件を短い文章にしておくとよい。開始予定、完了期限、未完了時の対応がそろえば、実行基盤の仕様を受け入れられるか判断しやすい。

    以下は筆者が推奨する設定前のチェックリストである。

    • 希望時刻と完了期限を分けたか

    • UTC換算かtimezone指定かを決めたか

    • 毎時0分付近を避ける余地があるか

    • 実行間隔は5分以上か

    • デフォルトブランチに反映したか

    • 公開リポジトリの無効化を点検するか

    • 未完了時の担当者を決めたか

    記録は、「何時に実行する」という一文だけにしない。「日本時間での予定」「YAML上の時刻の基準」「結果を必要とする時刻」を並べて残す。後任者が設定を見たときに、換算の意図まで読み取れる形にするためである。

    生成AIなどに設定案の確認を頼むなら、次のようなプロンプトを使える。

    「このschedule設定について、cron式の意味、timezoneの有無、日本時間での予定を説明してください。timezone未指定ならUTCとして換算してください。デフォルトブランチへの配置、最短間隔、毎時0分付近の負荷、公開リポジトリの無効化条件を確認項目として挙げ、設定から判断できない点は未確認と書いてください。」

    返答は確認の補助にとどめ、設定の原本と公式仕様に照らして判断する。特に、予定時刻の説明を、その時刻に処理が完了するという保証に読み替えないようにしたい。

    止まっても気づける仕組みを足す

    業務で困るのは、停止そのものに加え、古い結果を新しいものとして使い続けることである。以下も筆者の運用上の推奨である。

    まず、成功の定義を決める。ワークフローが終了しただけで成功とするのか、対象データの更新まで確認するのかで、検知すべき状態は変わる。業務では、必要な結果がそろった時点を成功として記録する設計が役立つ。

    記録には、処理対象、実際の開始時刻、完了時刻、結果を含める。対象が分かれば、停止後に再実行する際、どこまで済んでいるかを判断しやすい。結果を上書きする処理なら、最終更新時刻も利用者から確認できるようにしたい。

    次に、「失敗したら通知する」と「実行されなかったら気づく」を分ける。起動しなかった処理の内部だけに通知を置いても、その通知は動かない。別経路で最終成功時刻や成果物の更新を確認し、業務上の期限までに更新がなければ担当者が調べる仕組みを用意する。

    復旧手順には、ワークフローの有効状態、デフォルトブランチ、時刻指定、実行履歴、成果物を確認する順序を残す。再実行の前には、途中まで処理された対象がないかを確認する。重複処理の可否も、処理内容に合わせて決めておく。

    GitHub Actionsの定期実行を業務に組み込むなら、予定を書く作業と、結果を確かめる作業をセットにしたい。担当者が不在でも、いつの結果が使われているか、未更新なら誰が何を確認するかが分かる状態を目指す。

    時刻、遅延・破棄、実行ブランチ、自動無効化、最短間隔の仕様の出典は、GitHub Docs「Events that trigger workflows」のschedule節である。

     
     
    AI×自動化の実践知を毎日発信。自律型AIエージェントを実際に構築・運用するエンジニアが、現場で得た知見を共有します。

    あなたへのおすすめ