できない.dev

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 -v

Build 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 で反映する。
既存イメージは引き継がずに作り直す。

よくある原因

  1. BuildKit のキャッシュが肥大化している。
    マルチステージビルドや CI を繰り返すと buildx のキャッシュレイヤが GB 級に膨らむ。
  2. 停止コンテナや dangling イメージが溜まっている。
    docker compose up を何度も使い回し、停止コンテナや未参照イメージが残り続けている。
  3. Docker Desktop の仮想ディスクが上限に達している。
    macOS / Windows の Docker Desktop は仮想ディスクで動くため、ホスト側ストレージに余裕があっても先に仮想ディスクが詰まる。
  4. Docker のデータ置き場が OS と同居している。
    Linux ホストで /var/lib/docker が / と同パーティションだと、OS ログや他用途のファイルと容量を取り合う。