定期実行の方法を比較|GitHub Actionsのschedule・サーバーのcron・GASのトリガー
この記事は「Pocket Actions」の開発者が書いています。Pocket Actionsは手動実行のためのiPhoneアプリで、定期実行の機能はありません。登場するのは「手動実行との組み合わせ」の節だけです。各サービスの仕様は確認日時点の公式ドキュメント(リンク先)にもとづいています。
やりたいこと
毎朝データを取ってくる、毎週レポートを送る、スプレッドシートを整理する。こうした小さな定期処理を動かす場所として、よく使われるのは次の3つです。
- GitHub Actions の
on: schedule - 自分で管理するサーバー(VPSなど)の cron
- GAS(Google Apps Script) の時間主導型トリガー
GitHub Actionsのschedule
ワークフローをトリガーするイベントのドキュメントによると、次のとおりです。
- cronの書式で指定し、最短の間隔は5分
- デフォルトブランチの最新のコミットでだけ動く
- 時刻はデフォルトでUTC。
timezoneキーでAsia/Tokyoなどを指定できる @dailyのような省略形は使えない- 混雑時には遅れることがあり、特に毎時0分は混みやすい。混雑がひどいと、一部のジョブが実行されないこともある。GitHubは0分以外の時刻を選ぶよう勧めています
- 公開リポジトリでは、60日間リポジトリに動きがないと、定期実行が自動で無効になる(無効化と有効化)
費用(GitHub Actionsの課金):公開リポジトリは標準ランナーで無料です。非公開リポジトリはプランの無料枠(GitHub Freeは月$12分、Linuxの2コアは1分$0.006)を使い、超えると課金されます。支払い方法を登録していなければ、そこで止まります。
向いている:Python・Node.jsなどのコードを動かす処理、APIキーをリポジトリのシークレットに置きたい、ログと失敗の通知がほしい、サーバーを管理したくない。 向いていない:時刻の正確さが必要、5分より短い間隔。
on:
schedule:
- cron: "17 22 * * *" # 0分は避ける
timezone: "Asia/Tokyo"
workflow_dispatch: # 手動実行もできるようにする
サーバーのcron
昔からあるcrontabです。サーバーが動いている限り、分単位で正確に、どんな言語でも動かせます。
- 長所:時刻が正確。毎分でも動かせる。サービスごとの制限がない。サーバー内のデータベースなどに直接アクセスできる
- 短所:サーバーの管理(アップデート、稼働監視、ディスク、セキュリティ)が必要。監視を足さないと失敗に気づきにくい(cronの出力メールは、メールの設定がある場合だけ届く)。使っていない時間もサーバー代がかかる
GASの時間主導型トリガー
インストール型トリガーと割り当て(クォータ)のドキュメントによると、次のとおりです。
- 毎分から毎月までの間隔、または日時の指定で動かせる
- 時刻は少しランダムになる:9時に設定すると9時〜10時のどこかで動き、以後はその時刻を保つ
- 1回の実行は最大6分
- トリガーの合計実行時間は1日90分(個人のGoogleアカウント)、6時間(Google Workspace)
- 1つのスクリプトで、1ユーザーあたりトリガーは20個まで
- 失敗するとGoogleからまとめのメールが届く(頻度は設定できる)
- Googleアカウントがあれば無料。スプレッドシート・Gmail・ドライブ・カレンダーを直接扱える
向いている:Google Workspaceまわりの作業、短い処理、リポジトリやサーバーを持ちたくない。 向いていない:長い処理、重いライブラリ、Pythonを使う処理。
比較表
表は横にスクロールできます
| 項目 | GitHub Actionsのschedule | サーバーのcron | GASの時間主導型 |
|---|---|---|---|
| 時刻の正確さ | 遅れることがある(特に0分)、実行されないことも | 正確 | 1時間の中でランダム |
| 最短の間隔 | 5分 | 1分 | 1分 |
| タイムゾーン | デフォルトUTC、timezoneで指定可 | サーバーの設定(CRON_TZの対応は実装による) | スクリプトのタイムゾーン |
| 1回の実行時間 | 長く動かせる(ジョブの上限内) | 制限なし | 6分 |
| 言語 | 何でも | 何でも | JavaScript |
| 費用 | 公開は無料/非公開は無料枠あり | サーバー代 | 無料(制限あり) |
| 失敗の通知 | GitHubの通知 | 自分で作る | メールのまとめ |
| 管理するもの | ワークフローのファイル | サーバー全体 | スクリプトだけ |
| 落とし穴 | 公開リポジトリは60日で無効化 | サーバーが止まると動かない | トリガー合計は1日90分(個人) |
手動実行も用意しておく
定期実行には取りこぼしがあります。Actionsの遅れや未実行、GASの時刻のずれ、サーバーの再起動。あるいは単純に「明日の朝7時」ではなく「今」結果がほしいこともあります。同じ処理を手動でも動かせるようにしておくと安心です。
- GitHub Actions:
scheduleと一緒にworkflow_dispatchを書いておく。Webの画面、gh workflow run、GitHub公式アプリ、ショートカット、Pocket Actionsから実行できます - GAS:関数をWebアプリとしてデプロイし、URLを開くかスマホから呼ぶ(やり方)
- cron:SSHでサーバーに入ってスクリプトを実行(スマホのSSHアプリについては、この記事では確認していません)
Pocket Actionsは、workflow_dispatchのワークフローとGASのWebアプリを1〜3タップで実行できます。制限もあります。実行はmainブランチ固定、GASはスクリプトがエラーでも成功と表示される、アプリ内でログは見られない、iOSのみ、無料は1日5回・週17回までです。
同じ処理を3通りで組んでみる
「毎朝データを取って、要約を残す」処理を例に、それぞれの書き方と、忘れやすい設定をまとめます。
GitHub Actions
on:
schedule:
- cron: "17 22 * * *" # UTCの22:17=日本時間の7:17。00分は避ける
workflow_dispatch:
concurrency:
group: morning
jobs:
run:
runs-on: ubuntu-latest
timeout-minutes: 15
steps:
- uses: actions/checkout@v4
- uses: actions/setup-python@v5
with:
python-version: "3.12"
- run: pip install -r requirements.txt
- run: python summary.py
env:
API_KEY: ${{ secrets.API_KEY }}
- run: cat summary.md >> "$GITHUB_STEP_SUMMARY"
timeout-minutesを付けて、止まった処理が長時間動き続けないようにします。$GITHUB_STEP_SUMMARYに書いた内容は実行ページの上部に出るので、スマホでも結果が読みやすくなります(ワークフローコマンド)。- 定期実行では
inputsが空になります。入力を使うなら既定値を用意してください。
サーバーのcron
PATH=/usr/local/bin:/usr/bin:/bin
17 7 * * * cd /opt/morning && /usr/bin/flock -n /tmp/morning.lock ./venv/bin/python summary.py >> /var/log/morning.log 2>&1
- cronは最小限の環境で動くので、ターミナルで動いたコマンドが見つからないことがあります。
PATHを書き、絶対パスを使います。 flock -nを付けると、前回の処理が残っているときは今回を見送ります(flock(1))。- 出力をログに残さないと、失敗しても何もわかりません。
- crontabの中では
%が特別な意味を持つので、\%と書きます(crontab(5))。
GASの時間主導型トリガー
トリガーはエディタの時計アイコンからも作れますが、コードで作ると重複を防げます(ClockTriggerBuilder)。
function setupTrigger() {
ScriptApp.getProjectTriggers()
.filter(t => t.getHandlerFunction() === 'morning')
.forEach(t => ScriptApp.deleteTrigger(t));
ScriptApp.newTrigger('morning').timeBased()
.atHour(7).everyDays(1).inTimezone('Asia/Tokyo').create();
}
function morning() {
const lock = LockService.getScriptLock();
if (!lock.tryLock(1000)) return;
try {
const key = PropertiesService.getScriptProperties().getProperty('API_KEY');
// 実際の処理。失敗したら throw すると、失敗通知メールが届く
} finally {
lock.releaseLock();
}
}
APIキーはコードに書かず、スクリプトプロパティに入れます(PropertiesService)。エラーをcatchして握りつぶすと、Googleは成功と判断するので、失敗通知が届きません。6分を超えそうな処理は、途中までの位置をプロパティに保存して、次の実行で続きから処理します。
よくあるつまずき
表は横にスクロールできます
| 症状 | どこで | 原因と対処 |
|---|---|---|
| 定期実行が一度も動かない | Actions | デフォルトブランチにない、または公開リポジトリで60日間活動がなく無効化された。Actionsタブから有効化する |
| ターミナルでは動くのにcronで失敗する | cron | 環境変数が足りない。PATH、絶対パス、cdを見直す |
| 2回実行される | GAS | トリガーが重複している。エディタのトリガー一覧で消す |
| 「実行時間の上限を超えました」 | GAS | 6分超え。分割して続きから処理する |
タイプ別のおすすめ
- コードを動かす処理で、数分のずれは気にしない、サーバーは持ちたくない:GitHub Actionsのschedule(+
workflow_dispatch) - 正確な時刻、毎分の実行、サーバー内の資源が必要:サーバーのcron
- スプレッドシートやGmailの作業で、6分以内に終わる:GASの時間主導型トリガー
- ほとんど必要なときだけ動かす:定期実行をやめて手動実行にする
使い方の一例(開発者の場合)
開発者自身の、気になった銘柄をAIに評価させる自動化は、定期実行にしていません。必要なときにスマホから手動で実行しています。気にならない日に実行時間を使わずに済みます。
まずは無料で試す
よくある質問
GitHub Actionsのscheduleが遅れるのはなぜですか?
混雑時には遅れることがあり、特に毎時0分は混みやすく、実行されないこともあります。0分以外の時刻にし、workflow_dispatchで手動実行もできるようにしておきましょう。
GitHub Actionsのcronは日本時間ですか?
デフォルトはUTCです。timezoneキーでAsia/Tokyoを指定できます。
定期実行が急に止まりました。 公開リポジトリでは、60日間リポジトリに動きがないと定期実行が無効になります。Actionsのタブから有効にし直してください。
GASのトリガーは正確な時刻に動きますか? 動きません。時刻は少しランダムになり、9時に設定すると9時〜10時のどこかで動きます。
GASのトリガーはどれくらい長く動かせますか? 1回6分までで、個人のアカウントではトリガーの合計実行時間が1日90分までです。
関連記事
最終確認日:2026-11-01(GitHub Docsのイベントと課金、Google Apps Scriptのトリガーと割り当て、crontab(5))。
