MacでDockerがディスク領域を使いすぎる理由と解決法

Dockerの領域が実際にある場所

Docker Desktopは、小さなLinux仮想マシンの中でコンテナを実行します。そのマシンのディスクはMac上の1つのファイルで、~/Library/Containers/com.docker.docker/Data/vms/0/data/Docker.raw にあります。

このファイルはスパースファイルです。使用中の量がはるかに少なくても、Finderには許容される最大サイズで表示されることがあります。下記のコマンドは、両方の数値を表示します。最初の列がディスク上で実際に占めている領域で、行の後ろのほうにあるサイズが最大値です。

macOSの中からコンテナのファイルを削除できないのも、どのディスクツールでもこのフォルダが1つの巨大な項目に見えるのも、このためです。

ls -klsh ~/Library/Containers/com.docker.docker/Data/vms/0/data/Docker.raw

何が領域を使っているかを確認する

Docker Desktopを実行した状態で、Dockerに内訳を尋ねます。下記のコマンドは、イメージ、コンテナ、ローカルボリューム、ビルドキャッシュの4つを、それぞれの合計サイズと、そのうち回収可能な量とともに一覧表示します。

-v を付けると、イメージ、コンテナ、ボリュームごとに1行ずつ表示されます。1分かけて読む価値があります。ほとんどの開発マシンでは、大きいのは古いイメージとビルドキャッシュですが、ボリュームが大きい場合、それはデータであり、より慎重に扱う必要があります。

docker system df

ステップ1：安全な整理

下記のコマンドから始めます。停止中のコンテナ、どのコンテナにも使われていないネットワーク、宙ぶらりんのイメージ（タグも参照もなくなったレイヤー）、未使用のビルドキャッシュが削除されます。Dockerは削除するものを一覧表示し、確認を求めます。

タグの付いたイメージ、実行中のコンテナ、ボリュームは削除されません。多くの人にとっては、これで十分です。

ここで削除されるものに、取り戻すのが難しいものはありません。削除したコンテナはイメージからもう一度作成でき、ビルドキャッシュの代償は次のビルドが遅くなることだけです。確認しておくべきなのは1点だけで、停止中のコンテナの中に、そこで書き込んだまま外にコピーしていないファイルがないかどうかです。

docker system prune

ステップ2：未使用のイメージとビルドキャッシュ

さらに必要な場合は、イメージとビルドキャッシュに的を絞ります。

• docker image prune -a は、タグの有無にかかわらず、どのコンテナも使っていないイメージをすべて削除します。次に必要になったときに、もう一度プルまたはビルドすることになります。
• docker builder prune は、ビルドキャッシュを削除します。-a を付けると、宙ぶらりんの部分だけでなく、すべてが削除されます。次のビルドはキャッシュなしで始まり、時間がかかります。
• docker system prune -a は、上記の2つとステップ1の整理をまとめて行います。
• docker container ls -a は、停止中のコンテナを表示します。まだ残しておきたいコンテナが、大きなイメージを使用中の状態にしていることがあります。

ステップ3：ボリュームは慎重に

ボリュームは、データベースのファイル、アップロード、パッケージキャッシュなど、残しておくべきデータをコンテナが保存する場所です。整理すると本物の作業内容が削除されることがあるので、まず確認してください。

下記の1つ目のコマンドで一覧表示し、どのプロジェクトのものかを確認します。2つ目のコマンドは、どのコンテナも使っていない匿名ボリュームを削除します。-a を付けると、どのコンテナも使っていない名前付きボリュームにも対象が広がります。ローカルの開発用データベースは、たいていそこにあります。

大切なボリュームであれば、整理する前にバックアップするか、データベースをダンプしておきます。Composeプロジェクトのボリュームは、プロジェクトフォルダで docker compose down -v を実行すれば、そのプロジェクトと一緒に削除できます。

docker volume ls
docker volume prune

Macに領域を戻す

整理のあと、Docker Desktopは、仮想ディスク内で解放された領域をmacOSに返します。Docker.raw形式では、通常これはすぐに行われますが、ファイルの最大サイズを表示するツールでは変化が見られません。実際の数値を見るには、最初のセクションの ls コマンドをもう一度実行します。

今後これほど大きくならないようにするには、Docker Desktopを開いて「Settings」>「Resources」と進み、ディスク使用量の上限を下げます。変更によって既存のデータが消去される場合は、Dockerが警告します。

完全に最初からやり直したい場合は、Docker Desktopの「Troubleshoot」画面に、「Clean / Purge data」オプションと、出荷時の設定へのリセットがあります。どちらも、すべてのイメージ、コンテナ、ボリュームを削除します。

Docker.rawの中にないもの

Dockerに関連するものの一部は、仮想ディスクの外にあります。コンテナにマウントするフォルダはMac上の普通のフォルダであり、どの整理でも手を付けられません。プロジェクトフォルダには、node_modulesのような独自のビルド出力があります。また、Docker Desktopを削除しても、そのヘルパー、グループコンテナ、~/.docker フォルダは、自分で削除しないかぎり残ります。

Diskzyが役立つところ

Diskzyは、Docker.rawが実際にどのくらいの大きさなのかをディスクマップに表示するので、Docker内で整理すべきタイミングがわかります。ファイルを縮小することはしません。

Docker Desktopを完全に削除すると決めた場合は、Diskzyの「Uninstall」（アンインストール）が、コンテナ、LaunchAgent、特権ヘルパーなど、アプリが残したものと一緒にアプリを削除します。すべてゴミ箱に入ります。