定期実行の方法を比較|GitHub Actionsのschedule・サーバーのcron・GASのトリガー

この記事は「Pocket Actions」の開発者が書いています。Pocket Actionsは手動実行のためのiPhoneアプリで、定期実行の機能はありません。登場するのは「手動実行との組み合わせ」の節だけです。各サービスの仕様は確認日時点の公式ドキュメント(リンク先)にもとづいています。

やりたいこと

毎朝データを取ってくる、毎週レポートを送る、スプレッドシートを整理する。こうした小さな定期処理を動かす場所として、よく使われるのは次の3つです。

  1. GitHub Actions の on: schedule
  2. 自分で管理するサーバー(VPSなど)の cron
  3. 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サーバーのcronGASの時間主導型
時刻の正確さ遅れることがある(特に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トリガーが重複している。エディタのトリガー一覧で消す
「実行時間の上限を超えました」GAS6分超え。分割して続きから処理する

タイプ別のおすすめ

  • コードを動かす処理で、数分のずれは気にしない、サーバーは持ちたくない:GitHub Actionsのschedule(+workflow_dispatch)
  • 正確な時刻、毎分の実行、サーバー内の資源が必要:サーバーのcron
  • スプレッドシートやGmailの作業で、6分以内に終わる:GASの時間主導型トリガー
  • ほとんど必要なときだけ動かす:定期実行をやめて手動実行にする

使い方の一例(開発者の場合)

開発者自身の、気になった銘柄をAIに評価させる自動化は、定期実行にしていません。必要なときにスマホから手動で実行しています。気にならない日に実行時間を使わずに済みます。

まずは無料で試す

App StoreでPocket Actionsを見る

よくある質問

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))。