docker system df

読む時間の目安: 2 分

説明

Docker のディスク使用量を表示します。

API 1.25 以上  このコマンドを利用するには、クライアントとデーモンの API はともに、最低でも 1.25 である必要があります。 クライアント上においてdocker versionコマンドを実行して、クライアントとデーモンの API バージョンを確認してください。

利用方法

$ docker system df [オプション]

追加説明

コマンドdocker system dfは Docker デーモンによって利用されているディスク総容量に関する情報を表示します。

本コマンドの利用例については、以下に示す 利用例の節 を参照してください。

オプション

名前／省略形 デフォルト 説明
--format Go 言語テンプレートを使って出力をフォーマットします。
--verbose , -v ディスク使用量に関する詳細情報を表示します。

利用例

本コマンドはデフォルトでは、利用されているデータの概要を単に表示するだけです。

$ docker system df

TYPE                TOTAL               ACTIVE              SIZE                RECLAIMABLE
Images              5                   2                   16.43 MB            11.63 MB (70%)
Containers          2                   0                   212 B               212 B (100%)
Local Volumes       2                   1                   36 B                0 B (0%)

さらに詳細な情報が必要な場合は-v, --verboseフラグを利用します。

$ docker system df -v

Images space usage:

REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE                SHARED SIZE         UNIQUE SIZE         CONTAINERS
my-curl             latest              b2789dd875bf        6 minutes ago       11 MB               11 MB               5 B                 0
my-jq               latest              ae67841be6d0        6 minutes ago       9.623 MB            8.991 MB            632.1 kB            0
<none>              <none>              a0971c4015c1        6 minutes ago       11 MB               11 MB               0 B                 0
alpine              latest              4e38e38c8ce0        9 weeks ago         4.799 MB            0 B                 4.799 MB            1
alpine              3.3                 47cf20d8c26c        9 weeks ago         4.797 MB            4.797 MB            0 B                 1

Containers space usage:

CONTAINER ID        IMAGE               COMMAND             LOCAL VOLUMES       SIZE                CREATED             STATUS                      NAMES
4a7f7eebae0f        alpine:latest       "sh"                1                   0 B                 16 minutes ago      Exited (0) 5 minutes ago    hopeful_yalow
f98f9c2aa1ea        alpine:3.3          "sh"                1                   212 B               16 minutes ago      Exited (0) 48 seconds ago   anon-vol

Local Volumes space usage:

NAME                                                               LINKS               SIZE
07c7bdf3e34ab76d921894c2b834f073721fccfbbcba792aa7648e3a7a664c2e   2                   36 B
my-named-vol                                                       0                   0 B
  • SHARED SIZE は 1 つのイメージが他のイメージと共有する（つまり共通の）データ容量です。
  • UNIQUE SIZE は指定されたイメージによってのみ利用されているデータ容量です。
  • SIZE はイメージの仮想サイズです。 これはSHARED SIZEとUNIQUE SIZEを足し合わせたものです。

メモ

ネットワークに関する情報はディスクを消費しないため表示されません。

上位コマンド

コマンド 説明
docker system Docker を管理します。
コマンド 説明
docker system df Docker のディスク使用量を表示します。
docker system events サーバーからリアルタイムにイベントを取得します。
docker system info システムワイドな情報を表示します。
docker system prune 未使用データを削除します。