ホストランナーがサーバーとの通信を失った場合の対処法
最終更新: · 初回公開:
エラーThe hosted runner lost communication with the serverは、ジョブの実行中にGitHubランナープロセスがGitHubとの通信を停止したことを意味します。実際には、ほぼ常にランナーVMのメモリ、CPU、ディスクが不足しているか、ステップがランナー自体を停止または阻害したことが原因です。このページでは原因を優先度順に示し、どれが発生したのかを特定する方法を説明します。以下のいずれにも当てはまらず、無関係なジョブが同時に多数失敗する場合は、GitHubのステータスページを確認してください。
表示される正確なメッセージ
The hosted runner: GitHub Actions 12 lost communication with the server. Anything in your
workflow that terminates the runner process, starves it for CPU/Memory,
or blocks its network access can cause this error.
メッセージ自体に一般的な原因が挙げられています。終了したホステッドランナーにSSH接続することはできないため、ログとリソース使用状況から診断します。マシンの上限についてはGitHubホステッドランナーのリファレンスを参照してください。プライベートリポジトリで使用する標準のLinuxランナーは、2 CPUと8 GB RAMです(2026年10月時点で確認)。
考えられる原因(可能性の高い順)
1. メモリ不足
ビルドまたはテストのプロセスがRAMをすべて使い切り、システムがスラッシングを起こして、ランナーエージェントが応答しなくなります。場合によっては、このメッセージの代わりに終了コード137が表示されることもあります。主な発生原因は、webpackやNext.jsのビルド、ワーカーを多数使うJest、大きなヒープを使うGradleやMaven、大規模なプロジェクトをコンパイルするDockerビルドです。
メモリ使用量を記録して確認します:
- name: Watch memory
run: |
(while true; do date +%T; free -m | sed -n 2p; sleep 10; done) &
- run: npm run build
失敗前にメモリ使用量が全体量の上限近くまで増えている場合は、並列度を下げてください:
- run: npx jest --maxWorkers=2
env:
NODE_OPTIONS: --max-old-space-size=4096
2. ディスクの空き容量不足
ディスクが満杯になると、ツールが固まったり、ランナー自身のログ出力が壊れたりすることがあります。df -hで確認し、No space left on deviceが表示されないか確認してください。
3. CPUの枯渇
無限ループ、無制限にフォークするテスト、並列実行されるコンパイラが多すぎると、ランナーエージェントにCPU時間が割り当てられなくなります。並列度を制限し(make -j2、--workers、GOMAXPROCS)、最も負荷の高いステップはniceで実行してください。
4. ランナーを停止または変更するステップ
pkill、killall node、sudo shutdownを実行したり、Dockerやシステムサービスを停止したり、ファイアウォールを有効にしたりするスクリプトは、ランナーの接続を切断することがあります。プロセスは特定のパターンやPIDで終了させ、Runner.ListenerやRunner.Workerのプロセスには決して手を加えないでください。
- run: pkill -f "my-test-server" # specific, not 'node'
5. ジョブ内でのネットワーク変更
VPNのステップ、iptablesのルール、/etc/hostsの編集は、ランナーからGitHubへの送信接続をブロックすることがあります。これらの操作が必要な場合は、GitHubのエンドポイントを許可してください。IPレンジはmeta APIにあります。
6. セルフホステッドランナーとスポットインスタンス
セルフホステッドランナーや自動スケーリングのランナーでは、VMがプリエンプトされたり、更新により再起動されたり、ネットワークが切断されたりすることがあります。エフェメラルランナーを使用し、ホストがスリープしないようにして、実際の原因はランナーの_diagログで確認してください。表示されるメッセージは同じですが、修正はご自身のインフラ側で行う必要があります。
7. GitHubの障害
無関係なワークフローが同時に多数失敗する場合は、GitHub側の問題かもしれません。障害が解消された後に再実行してください。
診断方法
- 失敗した実行を開き、停止したときに実行中だったステップを確認してください。そのステップが原因である可能性が高いです。
- シークレットまたは変数
ACTIONS_STEP_DEBUGをtrueに設定して、デバッグログを有効にします。デバッグログの有効化を参照してください。 - 上記のメモリとディスクのログ出力を追加して、再実行します。
- 並列度を下げて同じジョブを実行します。成功すれば、リソース逼迫が原因です。
結果別の対処方法
- メモリが問題で、チューニングでは不十分な場合:RAMの多いマシンを使用してください。GitHubのラージランナーを使う方法や、既定のLinuxマシンが8 vCPU / 16 GBで、ジョブごとに新しいVMが起動するcompiler.devのようなプロバイダーを使う方法があります。料金を参照してください。
- 特定のステップがランナーを停止させる場合:そのステップが自身のプロセスだけを対象にするように変更してください。
- 断続的に発生し、明確な原因がない場合:再実行してください。繰り返す場合は、実行のURLを添えてGitHubサポートに問い合わせてください。
再試行ラッパーは不安定なステップへの一時的な対策であり、根本的な解決にはなりません:
- uses: nick-fields/retry@v3
with:
timeout_minutes: 15
max_attempts: 2
command: npm test
予防方法
- ツールにメモリ上限を設定します(
NODE_OPTIONS、-Xmx、GRADLE_OPTS)。 - 並列ワーカー数は、ランナーのCPU数以下に制限してください。
- 大規模なビルドは、1つの長いジョブにまとめず、別々のジョブに分割してください(実行時間の上限とtimeout-minutesを参照)。
- メモリとディスクをログに記録し、失敗の前に傾向を把握できるようにしてください。
- 広範囲に作用する
pkillコマンドは実行しないでください。
よくある質問
「lost communication with the server」はGitHubの障害ですか?
そうである場合もありますが、通常はジョブがメモリ、ディスク、CPUを使い果たしたことが原因です。他のリポジトリでも同時に失敗する場合は、ステータスページを確認してください。
なぜ一部の実行でのみ発生するのですか?
メモリとディスクの使用量は、テストの実行順序、キャッシュの状態、入力データのサイズによって変わります。上限付近で動作しているジョブは、断続的に失敗します。
失敗した実行にも料金はかかりますか?
失敗までに使用した分数は、他の実行と同様に課金されます。GitHub Actionsの料金を参照してください。
終了コード137と同じものですか?
両者は主にメモリ不足という原因を共有していますが、表示される内容が異なります。終了コード137は1つのプロセスが強制終了されたことを意味します。通信が失われたは、ランナー全体が応答しなくなったことを意味します。
関連記事
- セルフホストとGitHub-hostedランナーの比較:コストとリスクGitHub-hosted、セルフホスト、サードパーティ製ランナーをコスト、速度、セキュリティ、運用の手間の観点で比較します。損益分岐点の計算式と安全なエフェメラル構成も紹介します。
- セルフホストランナーとは(GitHub Actions)セルフホストランナーは、GitHub Actionsのジョブを実行するお客様が管理するマシンです。仕組み、セキュリティリスク、そして利用する価値がある場合について解説します。
- Cache Service Responded With 429: 修正方法GitHub Actions の「Failed to restore: Cache service responded with 429」を修正します。キャッシュへのリクエストが多すぎる場合の対処法です。actions/cache を更新し、復元は何度行っても構いませんが、保存は一度だけにしてください。
- fatal: could not read Username for github.com: 修正方法GitHub Actionsで"fatal: could not read Username for 'https://github.com'"を解決する方法:プライベートリポジトリ、サブモジュール、gitの依存関係にはトークンが必要です。