docker build で「no space left on device」が出てビルドできない
no space left on device は、ビルドキャッシュや未使用のイメージ・ボリュームが溜まると出る。docker builder prune と docker system prune で掃除すれば直る。
公開: 更新:
要約
no space left on device の多くは、BuildKit のキャッシュ層 か 未使用イメージ・ボリューム が溜まったことで起きる。docker system df で内訳を確認し、docker builder prune / docker system prune --volumes で削る。
Docker Desktop は仮想ディスク自体の上限に当たっている場合があるので、設定でサイズを引き上げる。
解決策
1. 内訳を確認する
docker system df -vBuild Cache / Images / Containers / Local Volumes のどれが太っているかを把握する(公式の Prune ガイド(新しいタブで開く))。
2. キャッシュを削る
docker builder prune -af # BuildKit のビルドキャッシュ全削除
docker system prune -af --volumes # 停止コンテナ・未使用イメージ・未使用の匿名ボリュームを一括-a を付けると、使われていないイメージも対象になる。--volumes は、使われていない匿名ボリュームも削除の対象に含める(名前付きボリュームは使われていなくても消えない)。
本番運用環境では、消えるボリュームに必要なデータが無いかを先に確かめる。
buildx prune の公式(新しいタブで開く) も合わせて確かめておく。
3. Docker Desktop の仮想ディスクを広げる
Settings → Resources → Advanced の Disk usage limit を実用値(例 128GB)に上げ、Apply & Restart で反映する。
狭いままだと、prune してもすぐ詰まる。
4. data-root を別パーティションに移す
Linux ホストでは、/etc/docker/daemon.json に次のように書く。
{ "data-root": "/mnt/docker-data" }systemctl restart docker で反映する。
既存イメージは引き継がずに作り直す。
よくある原因
- BuildKit のキャッシュが肥大化している。
マルチステージビルドや CI を繰り返すとbuildxのキャッシュレイヤが GB 級に膨らむ。 - 停止コンテナや dangling イメージが溜まっている。
docker compose upを何度も使い回し、停止コンテナや未参照イメージが残り続けている。 - Docker Desktop の仮想ディスクが上限に達している。
macOS / Windows の Docker Desktop は仮想ディスクで動くため、ホスト側ストレージに余裕があっても先に仮想ディスクが詰まる。 - Docker のデータ置き場が OS と同居している。
Linux ホストで/var/lib/dockerが/と同パーティションだと、OS ログや他用途のファイルと容量を取り合う。