码头工人图像修剪
描述
删除未使用的图像
API 1.25+
客户端和守护程序API都必须至少为
1.25，
才能使用此命令。docker version在客户端上使用命令检查客户端和守护程序API版本。
用法
$ docker image prune [OPTIONS]
扩展说明
删除所有悬空的图像。如果-a指定，则还将删除所有容器未引用的所有图像。
有关此命令的示例用法，请参阅下面的示例部分。
选项
| 名称，简写 | 默认 | 描述 |
--all ， -a |
删除所有未使用的图像，而不仅仅是悬空的图像 | |
--filter |
提供过滤器值（例如'until = <timestamp>'） | |
--force ， -f |
不提示确认 |
例子
输出示例：
$ docker image prune -a
WARNING! This will remove all images without at least one container associated to them.
Are you sure you want to continue? [y/N] y
Deleted Images:
untagged: alpine:latest
untagged: alpine@sha256:3dcdb92d7432d56604d4545cbd324b14e647b313626d99b889d0626de158f73a
deleted: sha256:4e38e38c8ce0b8d9041a9c4fefe786631d1416225e13b0bfe8cfa2321aec4bba
deleted: sha256:4fe15f8d0ae69e169824f25f1d4da3015a48feeeeebb265cd2e328e15c6a869f
untagged: alpine:3.3
untagged: alpine@sha256:4fa633f4feff6a8f02acfc7424efd5cb3e76686ed3218abf4ca0fa4a2a358423
untagged: my-jq:latest
deleted: sha256:ae67841be6d008a374eff7c2a974cde3934ffe9536a7dc7ce589585eddd83aff
deleted: sha256:34f6f1261650bc341eb122313372adc4512b4fceddc2a7ecbb84f0958ce5ad65
deleted: sha256:cf4194e8d8db1cb2d117df33f2c75c0369c3a26d96725efb978cc69e046b87e7
untagged: my-curl:latest
deleted: sha256:b2789dd875bf427de7f9f6ae001940073b3201409b14aba7e5db71f408b8569e
deleted: sha256:96daac0cb203226438989926fc34dd024f365a9a8616b93e168d303cfe4cb5e9
deleted: sha256:5cbd97a14241c9cd83250d6b6fc0649833c4a3e84099b968dd4ba403e609945e
deleted: sha256:a0971c4015c1e898c60bf95781c6730a05b5d8a2ae6827f53837e6c9d38efdec
deleted: sha256:d8359ca3b681cc5396a4e790088441673ed3ce90ebc04de388bfcd31a0716b06
deleted: sha256:83fc9ba8fb70e1da31dfcc3c88d093831dbd4be38b34af998df37e8ac538260c
deleted: sha256:ae7041a4cc625a9c8e6955452f7afe602b401f662671cea3613f08f3d9343b35
deleted: sha256:35e0f43a37755b832f0bbea91a2360b025ee351d7309dae0d9737bc96b6d0809
deleted: sha256:0af941dd29f00e4510195dd00b19671bc591e29d1495630e7e0f7c44c1e6a8c0
deleted: sha256:9fc896fc2013da84f84e45b3096053eb084417b42e6b35ea0cce5a3529705eac
deleted: sha256:47cf20d8c26c46fff71be614d9f54997edacfe8d46d51769706e5aba94b16f2b
deleted: sha256:2c675ee9ed53425e31a13e3390bf3f539bf8637000e4bcfbb85ee03ef4d910a1
Total reclaimed space: 16.43 MB
筛选
过滤标志（--filter）格式为“键=值”。如果有多个过滤器，则传递多个标志（例如--filter "foo=bar" --filter "bif=baz"）
当前支持的过滤器是：
- 直到（
<timestamp>）-仅删除在给定时间戳记之前创建的图像 - 标签（
label=<key>，label=<key>=<value>，label!=<key>，或label!=<key>=<value>） -仅与删除的图像（或没有，如果label!=...被使用）指定的标签。
该until过滤器可以是Unix的时间戳，日期格式的时间戳，或转到时间字符串（例如10m，1h30m相对于守护机器的时间计算）。支持的格式为日期格式时间戳包括RFC3339Nano，RFC3339， ，2006-01-02T15:04:05，
2006-01-02T15:04:05.999999999，2006-01-02Z07:00和2006-01-02。如果您在时间戳记末尾未提供Z或
+-00:00时区偏移量，则将使用守护程序上的本地时区。提供Unix时间戳时，请输入seconds [.nanoseconds]，其中seconds是自1970年1月1日（UTC / GMT午夜）以来经过的秒数，不计算leap秒（又名Unix纪元或Unix时间），以及可选的。纳秒字段是一秒的分数，长度不超过9位数。
的label过滤器接受两种格式。一个是label=...（label=<key>或label=<key>=<value>），它会删除带有指定标签的图像。另一种格式是label!=...（label!=<key>或label!=<key>=<value>），它会删除没有指定标签的图像。
预测将要删除的内容
如果使用正过滤（测试标签的存在或标签具有特定值），则可以使用
docker image ls相同的过滤语法来查看哪些图像与您的过滤器匹配。但是，如果使用的是负过滤（测试对于不存在标签的或标签并不具有特定的值），这种类型的滤波器的不与工作
docker image ls所以不能容易地预测哪些图像将被移除。此外，即使您正在使用，确认提示也会docker image prune始终警告所有悬空的图像都将被删除--filter。
以下内容将删除之前创建的图像2017-01-04T00:00:00：
$ docker images --format 'table {{.Repository}}\t{{.Tag}}\t{{.ID}}\t{{.CreatedAt}}\t{{.Size}}'
REPOSITORY TAG IMAGE ID CREATED AT SIZE
foo latest 2f287ac753da 2017-01-04 13:42:23 -0800 PST 3.98 MB
alpine latest 88e169ea8f46 2016-12-27 10:17:25 -0800 PST 3.98 MB
busybox latest e02e811dd08f 2016-10-07 14:03:58 -0700 PDT 1.09 MB
$ docker image prune -a --force --filter "until=2017-01-04T00:00:00"
Deleted Images:
untagged: alpine:latest
untagged: alpine@sha256:dfbd4a3a8ebca874ebd2474f044a0b33600d4523d03b0df76e5c5986cb02d7e8
untagged: busybox:latest
untagged: busybox@sha256:29f5d56d12684887bdfa50dcd29fc31eea4aaf4ad3bec43daf19026a7ce69912
deleted: sha256:e02e811dd08fd49e7f6032625495118e63f597eb150403d02e3238af1df240ba
deleted: sha256:e88b3f82283bc59d5e0df427c824e9f95557e661fcb0ea15fb0fb6f97760f9d9
Total reclaimed space: 1.093 MB
$ docker images --format 'table {{.Repository}}\t{{.Tag}}\t{{.ID}}\t{{.CreatedAt}}\t{{.Size}}'
REPOSITORY TAG IMAGE ID CREATED AT SIZE
foo latest 2f287ac753da 2017-01-04 13:42:23 -0800 PST 3.98 MB
以下内容将删除10天以上（240h）前创建的图像：
$ docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
foo latest 2f287ac753da 14 seconds ago 3.98 MB
alpine latest 88e169ea8f46 8 days ago 3.98 MB
debian jessie 7b0a06c805e8 2 months ago 123 MB
busybox latest e02e811dd08f 2 months ago 1.09 MB
golang 1.7.0 138c2e655421 4 months ago 670 MB
$ docker image prune -a --force --filter "until=240h"
Deleted Images:
untagged: golang:1.7.0
untagged: golang@sha256:6765038c2b8f407fd6e3ecea043b44580c229ccfa2a13f6d85866cf2b4a9628e
deleted: sha256:138c2e6554219de65614d88c15521bfb2da674cbb0bf840de161f89ff4264b96
deleted: sha256:ec353c2e1a673f456c4b78906d0d77f9d9456cfb5229b78c6a960bfb7496b76a
deleted: sha256:fe22765feaf3907526b4921c73ea6643ff9e334497c9b7e177972cf22f68ee93
deleted: sha256:ff845959c80148421a5c3ae11cc0e6c115f950c89bc949646be55ed18d6a2912
deleted: sha256:a4320831346648c03db64149eafc83092e2b34ab50ca6e8c13112388f25899a7
deleted: sha256:4c76020202ee1d9709e703b7c6de367b325139e74eebd6b55b30a63c196abaf3
deleted: sha256:d7afd92fb07236c8a2045715a86b7d5f0066cef025018cd3ca9a45498c51d1d6
deleted: sha256:9e63c5bce4585dd7038d830a1f1f4e44cb1a1515b00e620ac718e934b484c938
untagged: debian:jessie
untagged: debian@sha256:c1af755d300d0c65bb1194d24bce561d70c98a54fb5ce5b1693beb4f7988272f
deleted: sha256:7b0a06c805e8f23807fb8856621c60851727e85c7bcb751012c813f122734c8d
deleted: sha256:f96222d75c5563900bc4dd852179b720a0885de8f7a0619ba0ac76e92542bbc8
Total reclaimed space: 792.6 MB
$ docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
foo latest 2f287ac753da About a minute ago 3.98 MB
alpine latest 88e169ea8f46 8 days ago 3.98 MB
busybox latest e02e811dd08f 2 months ago 1.09 MB
以下示例删除带有标签的图像deprecated：
$ docker image prune --filter="label=deprecated"
以下示例删除标签maintainer设置为的图像john：
$ docker image prune --filter="label=maintainer=john"
本示例删除没有maintainer标签的图像：
$ docker image prune --filter="label!=maintainer"
本示例将删除其维护者标签未设置为的图像john：
$ docker image prune --filter="label!=maintainer=john"
笔记
在
prune删除任何内容之前，系统会提示您进行确认，但是不会显示可能要删除的内容的列表。此外，docker image ls它不支持负过滤，因此很难预测实际会删除哪些图像。
上级命令
| 命令 | 描述 |
|---|---|
| 码头工人形象 | 管理图片 |
相关命令
| 命令 | 描述 |
| docker镜像构建 | 从Dockerfile构建映像 |
| 码头工人图像历史记录 | 显示图像的历史记录 |
| 泊坞窗图像导入 | 从tarball导入内容以创建文件系统映像 |
| 码头工人图像检查 | 在一张或多张图像上显示详细信息 |
| 码头工人图像加载 | 从tar存档或STDIN加载图像 |
| 码头工人形象ls | 列出图片 |
| 码头工人图像修剪 | 删除未使用的图像 |
| 码头工人图像拉 | 从注册表中提取图像或存储库 |
| 泊坞窗图片推送 | 将映像或存储库推送到注册表 |
| 泊坞窗映像rm | 删除一个或多个图像 |
| 泊坞窗图像保存 | 将一个或多个图像保存到tar存档（默认情况下流式传输到STDOUT） |
| 码头工人图像标签 | 创建一个引用了SOURCE_IMAGE的标签TARGET_IMAGE |