docker container prune

說明移除所有已停止的容器
用法docker container prune [選項]

說明

移除所有已停止的容器。

選項

選項預設值說明
--filter提供篩選值(例如 until=<timestamp>
-f, --force不提示確認

範例

清理容器

$ docker container prune
WARNING! This will remove all stopped containers.
Are you sure you want to continue? [y/N] y
Deleted Containers:
4a7f7eebae0f63178aff7eb0aa39cd3f0627a203ab2df258c1a00b456cf20063
f98f9c2aa1eaf727e4ec9c0283bc7d4aa4762fbdba7f26191f26c97f64090360

Total reclaimed space: 212 B

篩選 (--filter)

篩選旗標 (--filter) 的格式為「key=value」。如果有多個篩選器,請傳遞多個旗標(例如,--filter "foo=bar" --filter "bif=baz"

目前支援的篩選器為

  • until (<timestamp>) - 僅移除在指定時間戳記之前建立的容器
  • label (label=<key>label=<key>=<value>label!=<key>label!=<key>=<value>) - 僅移除具有(或不具有,如果使用 label!=...)指定標籤的容器。

until 篩選器可以是 Unix 時間戳記、日期格式的時間戳記,或是相對於守護行程機器時間計算的 Go duration 字串(例如 10m1h30m)。支援的日期格式時間戳記格式包括 RFC3339Nano、RFC3339、2006-01-02T15:04:052006-01-02T15:04:05.9999999992006-01-02T07:002006-01-02。如果您沒有在時間戳記的結尾提供 Z+-00:00 時區偏移量,則會使用守護行程上的本地時區。提供 Unix 時間戳記時,請輸入秒數[.奈秒],其中秒數是指自 1970 年 1 月 1 日(UTC/GMT 午夜)以來經過的秒數,不計閏秒(又稱 Unix 紀元或 Unix 時間),而可選的 .nanoseconds 欄位是 不超過九位數的秒數分數。

label 篩選器接受兩種格式。一種是 label=...label=<鍵>label=<鍵>=<值>),它會移除具有指定標籤的容器。另一種格式是 label!=...label!=<鍵>label!=<鍵>=<值>),它會移除沒有指定標籤的容器。

以下指令會移除建立超過 5 分鐘的容器

$ docker ps -a --format 'table {{.ID}}\t{{.Image}}\t{{.Command}}\t{{.CreatedAt}}\t{{.Status}}'

CONTAINER ID        IMAGE               COMMAND             CREATED AT                      STATUS
61b9efa71024        busybox             "sh"                2017-01-04 13:23:33 -0800 PST   Exited (0) 41 seconds ago
53a9bc23a516        busybox             "sh"                2017-01-04 13:11:59 -0800 PST   Exited (0) 12 minutes ago

$ docker container prune --force --filter "until=5m"

Deleted Containers:
53a9bc23a5168b6caa2bfbefddf1b30f93c7ad57f3dec271fd32707497cb9369

Total reclaimed space: 25 B

$ docker ps -a --format 'table {{.ID}}\t{{.Image}}\t{{.Command}}\t{{.CreatedAt}}\t{{.Status}}'

CONTAINER ID        IMAGE               COMMAND             CREATED AT                      STATUS
61b9efa71024        busybox             "sh"                2017-01-04 13:23:33 -0800 PST   Exited (0) 44 seconds ago

以下指令會移除在 2017-01-04T13:10:00 之前建立的容器

$ docker ps -a --format 'table {{.ID}}\t{{.Image}}\t{{.Command}}\t{{.CreatedAt}}\t{{.Status}}'

CONTAINER ID        IMAGE               COMMAND             CREATED AT                      STATUS
53a9bc23a516        busybox             "sh"                2017-01-04 13:11:59 -0800 PST   Exited (0) 7 minutes ago
4a75091a6d61        busybox             "sh"                2017-01-04 13:09:53 -0800 PST   Exited (0) 9 minutes ago

$ docker container prune --force --filter "until=2017-01-04T13:10:00"

Deleted Containers:
4a75091a6d618526fcd8b33ccd6e5928ca2a64415466f768a6180004b0c72c6c

Total reclaimed space: 27 B

$ docker ps -a --format 'table {{.ID}}\t{{.Image}}\t{{.Command}}\t{{.CreatedAt}}\t{{.Status}}'

CONTAINER ID        IMAGE               COMMAND             CREATED AT                      STATUS
53a9bc23a516        busybox             "sh"                2017-01-04 13:11:59 -0800 PST   Exited (0) 9 minutes ago