GitHub Actions の無料枠が足りなくなり、日次ジョブを VPS cron に移した
Angla の日次スコアを Actions の schedule から外し、VPS cron に移した理由と今の役割分担。
個人開発でも、定期バッチを GitHub Actions の schedule に載せると便利です。Angla でも日次の釣行スコア生成を Actions で回していました。しかし2026年8月、GitHub Free の月間分を使い切り、ワークフローが止まりました。
この経験を受けて、毎日必ず実行したい処理は VPS の cron に移し、Actions の schedule には戻さない方針にしました。Actions をやめたのではなく、変更時のビルドと定時処理の役割を分けています。
月の枠を使った処理を見直す
2026年8月に利用枠を使い切った時点で、GitHub Free の標準ランナーには月 2,000 分が含まれていました(現在の上限はGitHub Actions の課金ドキュメントで確認できます)。Angla の日次スコア生成は平均約17分かかっていたため、30日動かすと約510分、月枠のおよそ4分の1です。これは日次ジョブだけの概算で、アカウント内の別リポジトリの利用分は含みません。
| 当時の項目 | 観測した値 |
|---|---|
| GitHub Free の月間枠 | 2,000 分 |
| Angla 日次スコア生成 | 約17分/日 |
| 30日続けた場合の概算 | 約510分/月 |
| 2026年8月の状態 | アカウントの月間枠を使い切り、超過利用は停止 |
枠を使ったのはこの定時ジョブだけではありません。毎日の Flutter Web 再ビルド、ドキュメントだけの変更で動くデプロイ、iOS 向け macOS ランナーも重なっていました。macOS ランナーは当時の Linux ランナーより分単位の消費が大きく、同じ「実行時間」として足し算すると見積もりを誤ります。
一回のワークフローが数分でも、毎日実行すれば月の合計はまとまった数字になります。さらに、コードを変更したときのビルドや、必要なときに作るアプリパッケージも同じ枠に積み上がります。ワークフローを一つずつ見ると小さく見えても、アカウント全体で合算すると無料枠を超えていました。
どのジョブが主因かを見ずに定時処理だけを移すと、別のワークフローが同じように枠を使います。まず Actions の利用状況と各ジョブの実行頻度・所要時間を見て、「毎日」「変更ごと」「必要時だけ」に分けて考えるようにしました。
この切り分けでは、日次スコア生成だけで約510分/月を使う見込みでした。一方、潮汐ページは港データやコードを変更した時だけ作ればよく、毎日のフルビルドを止められます。移行先を選ぶ前に、実行そのものをなくせる仕事と定時実行が必要な仕事を分けました。
何をどこで動かすか
現在の役割分担は次の通りです。
| 処理 | 実行場所 |
|---|---|
| 日次スコア生成 | VPS の cron(Dart SDK を使用) |
| Web のビルドとデプロイ | GitHub Actions(コード変更時) |
| Android AAB の作成 | 手動の workflow_dispatch |
| iOS TestFlight | 手元の Mac のスクリプト |
変更時のビルドやデプロイは、ソースコードと同じリポジトリで実行され、結果を GitHub 上で追いやすい Actions に残しました。一方、毎日決まった時刻に走るスコア生成は、常時稼働している VPS の cron に移しました。iOS 用の macOS ランナーは実行コストが高いため、Mac 上で管理するスクリプトを正本にしています。
変更に伴う処理は Actions、日々の定時処理は VPS。
VPS には Flutter 全体を入れなかった
日次スコアを VPS に移すからといって、Flutter の開発環境一式をインストールする必要はありませんでした。スコア生成は Dart SDK だけで動くスクリプトに寄せ、VPS には必要な実行環境だけを置いています。メモリ 2GB クラスのサーバーで複数サービスも動いているため、使わない SDK や重いビルド工程を増やさないことは、運用上の判断でもあります。
ただし、cron は GitHub Actions の代わりに置くだけでは完成しません。VPS にあるスクリプトをどう更新するか、失敗したときのログをどう見るか、次回の実行で再開できるかを用意する必要があります。GitHub にコードを push しても VPS 上のスクリプトが自動で更新されるわけではありません。ソースと実行コピーの同期手順を別に管理しています。
また、cron の失敗は Actions のワークフロー失敗メールのように普段の GitHub 画面へ出てきません。サーバー上のログを確認し、必要なら処理を再実行します。自動化を移すと、実行時間の計算は単純になる一方で、監視と復旧の責任は自分のサーバーに移ります。
潮汐ページの日次再ビルドはやめた
以前は潮汐ページを毎日フルビルドしていました。ですが、ページの更新が必要なのは、基本的にコードや港データを変更したときです。アプリ側では端末でも計算できるため、検索向け HTML を毎日作り直す必要性は高くありませんでした。
そこで静的ページの更新はコードやデータのデプロイ時に行い、日次の定時処理から外しました。すべての cron を VPS へ移すのではなく、そもそも毎日実行する必要があるのかを見直した例です。実行場所を変える前に頻度を問い直すと、不要なジョブそのものをなくせる場合があります。
Actions の schedule に戻さない理由
月間枠が回復すれば、技術的には同じ schedule を再び有効にできます。しかし、日次スコアを戻せば毎月の利用枠を再び消費し、コード変更時の処理や他プロジェクトと取り合うことになります。枠が戻るたびに同じ構成へ戻すのではなく、定時処理を VPS で動かす運用を続ける判断にしました。
Actions は、ソース変更に連動するビルドやデプロイ、必要なときに行う Android パッケージ作成で引き続き使います。変更との結びつきが強い仕事は CI に、時刻が決まっていて毎日実行する仕事はサーバーに、という分け方です。
どんな個人開発に向くか
VPS cron が向くのは、すでに稼働中の VPS があり、日次処理に必要な環境を無理なく用意できる場合です。サーバーの管理やログ確認をしたくないなら、マネージドなスケジューラーの方が合うこともあります。安さだけで選ぶと、監視や復旧に使う時間を見落とします。
今回の変更で学んだのは、「CI を VPS に移す」ことより、実行頻度と責任を整理することでした。実行先、必要な SDK、失敗の見つけ方、コードの同期方法まで決めて初めて移行になります。Angla 全体の構成は公開までの全体像、複数サービスを一台で動かす運用は個人開発を1台の VPS に載せる話に続きます。
移す前に確認したいこと
定時処理を VPS へ動かす前には、処理が VPS 上だけで完結するかを確認します。ビルド済みのアプリや SDK が必要なのか、外部サービスの認証情報はどこから読むのか、処理が途中で失敗した場合に再実行できるかを整理します。ローカルで成功しても、cron は対話シェルと環境変数や PATH が異なるため、実際の実行ユーザーと起動方法で動かす必要があります。
次に、ログの確認方法を決めます。GitHub Actions なら実行履歴が UI に残りますが、cron に移すとそのサーバーのログが主な確認場所になります。失敗を見つける頻度、通知が必要か、ログがいつまで残るかも運用設計の一部です。自動実行を始めた後に「失敗しても誰も気づかない」状態にならないよう、少なくとも最初は正常時と異常時の出力を確認します。
最後に、移行後も以前の Actions が二重実行されないことを確認します。古い schedule を止めずに cron を有効にすると、同じデータを二度 ingest したり、外部 API の呼び出しを重ねたりする可能性があります。切り替え日、旧ジョブを停止したこと、新しいジョブが完了したことを一緒に確認すると、どちらが動いているか分からなくなるのを防げます。
cron の時刻はサーバーのタイムゾーンにも依存します。GitHub Actions 側で UTC を使っていた場合、設定した「朝」が移行後に違う時刻にならないかを確認します。初回実行ではログと取り込み先の状態を見て、想定した日付のデータが一度だけ処理されたことまで確かめてから定常運用にします。
移行後に確認した結果
VPS の cron は毎日 15:47 JST に実行する設定にしました。初回の成功記録は 2026年8月25日 15:47〜15:59 で、翌日分のスコアを10地方へ取り込めています。VPS には Flutter 全体ではなく Dart SDK だけを置き、日次処理を実行しました。
コード変更時の Web デプロイや手動の Android AAB 作成では、現在も Actions を使っています。日次ジョブの失敗は GitHub のワークフロー画面や通知に出ないため、VPS のログ確認と、スクリプトをサーバーへ同期する作業を運用に加えました。GitHub の schedule は既定で UTC を使い、タイムゾーンも指定できます。移行前後の時刻と実行履歴を確認してください(schedule の仕様)。