GitHub Actionsでの「No space left on device」の対処法
最終更新
No space left on deviceというエラーは、ジョブの実行中にランナーのディスクが一杯になったことを意味します。通常はDockerビルド、大規模な依存関係のインストール、大きなアーティファクトのステップで発生します。GitHubの標準Linuxランナーは14 GBのSSDストレージを提供しており、大きなイメージをダウンロードし、大規模なプロジェクトをビルドしてキャッシュするジョブでは容量が不足することがあります。以下に、発生頻度の高い順に原因と、そのまま貼り付けて使える対処法を示します。ディスク容量の数値はGitHub-hosted runnersのリファレンスによるもので、2026年10月時点で確認したものです。
表示される正確なメッセージ
失敗したステップでは、次のいずれかが表示されます。
System.IO.IOException: No space left on device
ENOSPC: no space left on device, write
write /var/lib/docker/...: no space left on device
OSError: [Errno 28] No space left on device
メッセージの表現はツールによって異なりますが、原因は同じです。ファイルシステムに空きブロック(または空きinode)がないということです。同じメッセージは、ディスクを自分で用意するセルフホストランナーでも表示されることがあります。
ディスクの使用状況を確認する
失敗するステップの前後にこのステップを追加して、どの容量が増えたかを確認します。
- name: Disk usage
if: always()
run: |
df -h
sudo du -xh / --max-depth=2 2>/dev/null | sort -rh | head -20
docker system df
df -hで空き容量が表示されているのにエラーが続く場合は、df -iでinodeを確認してください。node_modules内の膨大な数の小さなファイルによって、先にinodeが枯渇することがあります。
考えられる原因(可能性の高い順)
1. Dockerイメージ、レイヤー、ビルドキャッシュ
docker pull、docker build、サービスコンテナはいずれも/var/lib/dockerに書き込みます。大きなベースイメージを使ったマルチステージビルドが、主な原因となることがよくあります。ステップ間で不要になったものを削除してください。
- name: Free Docker space
run: |
docker image prune -af
docker builder prune -af
docker system df
docker system prune -af --volumesは、後続のステップでボリュームが不要な場合にのみ使用してください。各コマンドの削除対象はDocker pruneのドキュメントで確認できます。より小さいベースイメージ(-slim、-alpine)や.dockerignoreファイルを使うと、使用量をさらに抑えられます。ビルドキャッシュの詳細はCIでのDockerレイヤーキャッシュをご覧ください。
2. 使用しない事前インストール済みのツールチェーン
ホストされるUbuntuイメージには、多数のSDKが事前にインストールされています。ジョブでAndroid、.NET、Haskellを使用しない場合、削除することで数GBを解放できます。これらのパスは一般的に削除されていますが、イメージの詳細であり、GitHubによって変更される可能性があるため、まずduで確認してください。
- name: Free disk space
run: |
sudo rm -rf /usr/share/dotnet
sudo rm -rf /usr/local/lib/android
sudo rm -rf /opt/ghc
sudo rm -rf /opt/hostedtoolcache/CodeQL
df -h /
削除には1、2分かかるため、容量の上限に達した場合にのみ実行してください。ジョブが後で呼び出すツールは削除しないでください。事前インストール済みソフトウェアの一覧はrunner-imagesリポジトリにあります。
3. ビルド出力、キャッシュ、アーティファクト
大きなtarget/、build/、.gradleディレクトリや、復元されたキャッシュはすべて同じディスクに配置されます。中間出力は作業の途中で削除し、必要以上に大きなキャッシュを復元しないようにしてください(キャッシュの上限を参照)。Gradleでは./gradlew --stopを実行し、不要なビルドキャッシュを削除します。Rustでは、cargo cleanよりもビルドを複数のジョブに分割するほうが効果的です。
4. 1つのジョブに詰め込みすぎている
大規模なモノレポのチェックアウト、すべてのイメージのビルド、すべてのテストの実行を1つのジョブで行うと、すべてのディスク使用量が1台のマシンに集中します。作業を複数のジョブに分割するか、テストシャーディングのマトリックスを使い、各ジョブが書き込む量を減らしてください。履歴が不要な場合は、fetch-depth: 1を指定して浅いクローンを使用します。
5. テストによるログと一時ファイル
動画、コアダンプ、詳細なログを出力するテストスイートは、数GBを消費することがあります。アップロードして削除するディレクトリに書き出すか、出力の詳細度を下げてください。
クリーンアップだけでは不十分な場合の対処法
- 大型ランナー。GitHubの大型ランナーは標準ランナーよりも多くのリソースを備えています。現在のサイズは大型ランナーのページで確認してください。パブリックリポジトリであっても、常に分単位で課金されます。
- 別のランナープロバイダー。compiler.devでは、同じジョブを8 vCPU / 16 GBのマシン上で、ジョブごとに新しいVMを使って実行できます。ディスクの問題にメモリの逼迫が伴う場合にも有効です(終了コード137を参照)。変更は1行で、
runs-on: [self-hosted, Linux, compiler-ci]です。詳細は料金をご覧ください。 - セルフホストランナー。ディスクは自分で選べますが、クリーンアップも自分で行う必要があります。ホスト上で
docker system pruneを実行する定期ジョブを追加してください。
予防方法
- 負荷の大きいジョブを実行するたびに、開始時と終了時に
df -hを出力して、容量の増加を時系列で把握できるようにします。 - より小さいベースイメージを固定し、最終成果物だけをコピーするマルチステージのDockerfileを使用します。
- 2つ以上のイメージをビルドするジョブでは、ビルドステージの間にDockerをpruneします。
- キャッシュは、ビルドツリー全体ではなく、パッケージのダウンロードディレクトリに絞ってください。
- 大きなジョブは分割してください。20 GBを必要とするジョブは、おそらく2つのジョブに分けるべきです。
関連するエラー:ランナーがリソース不足に陥ると、hosted runner lost communicationが表示されることがよくあります。大きなキャッシュが削除されると、cache not foundが表示されます。
よくある質問
GitHub Actionsランナーにはどれくらいのディスク容量がありますか?
2026年10月時点で、GitHubはubuntu-latestなどの標準Linuxランナーに14 GBのSSDストレージを提供しており、これはパブリックリポジトリとプライベートリポジトリの両方に適用されます。ステップでdf -hを実行すると実際の空き容量を確認できます。OSやツールが一部を使用するため、表示される空き容量はこれより少なくなります。
/usr/share/dotnetや/usr/local/lib/androidを削除しても安全ですか?
ジョブで使用しない場合は安全です。ランナーは新しいVMなので、削除の影響は現在のジョブだけに限られます。ビルドが始まる前に削除し、後続のアクションが必要とするものは削除しないでください。
Dockerがディスクをすぐに使い切ってしまうのはなぜですか?
取得したイメージのレイヤー、中間のビルドレイヤー、ビルドキャッシュはすべてローカルに保存されます。大きなイメージが数個あるだけで、数GBを簡単に超えてしまいます。pruneを実行するか、より小さいイメージを使用してください。
ホステッドランナーにディスクを追加できますか?
標準ランナーでは、ドキュメント化された設定としてディスクを追加することはできません。大型ランナー、セルフホストランナー、またはより大きなディスクを備えたマシンを提供するプロバイダーをご利用ください。
関連記事
- 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の依存関係にはトークンが必要です。
- Invalid Workflow File: YAML構文エラーの修正方法GitHub Actionsで"Invalid workflow file"と"You have an error in your yaml syntax"を解決する方法:インデント、予期しない値、不正な式をactionlintで確認します。
- GitHub ActionsでのJavaScript Heap Out of Memoryの修正方法GitHub ActionsでNODE_OPTIONSを使い、"FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory"とnpm ENOMEMを解決する方法。