docker images命令详解

1、Usage

docker images [OPTIONS] [REPOSITORY[:TAG]]

2、常用选项

选项	描述
--all，-a	显示所有镜像（默认隐藏中间镜像）
--digests	显示镜像的摘要
--filter,-f	根据条件对输出结果进行过滤
--format	格式化输出结果
--no-trunc	不截断输出，即输出镜像完整的ID
--quiet,-q	只显示镜像ID

3、显示镜像信息

• 列出最近创建的镜像

  docker images
  

  

• 列出指定镜像名kfmirrors.io/datamining:117的信息

  docker images kfmirrors.io/datamining:117
  

  

• 列出镜像名为kfmirrors.io/datamining的所有镜像信息

  docker images kfmirrors.io/datamining
  

  

  也可以使用模糊查找的方式：

  docker images kfmirrors.io/datamining:*
  

  

• 显示镜像完整的ID

  docker images --no-trunc
  

  

• 显示镜像的摘要

  docker images --digests
  

  

4、显示结果过滤

介绍

结果过滤是通过-f或--filter参数进行处理的，格式为：-f <key>=<value>，若有多个过滤条件，则需要有过个过滤参数，如：-f "foo=bar" --filter "bif=baz"；

当前支持的过滤条件为：

• dangling（布尔值，true 或者 false）；
• label（label=<key>或者label=<key>=<value>）；
• before（<image-name>[:<tag>], <image id> 或者<image@digest>），筛选在给定镜像之前创建的镜像；
• since（<image-name>[:<tag>], <image id> 或者<image@digest>），筛选再给定镜像之后创建的镜像；
• reference，筛选引用与给定镜像相匹配的镜像；

示例

• 查询的镜像

  docker images -f "dangling=true"
  

  

• 删除的镜像

  docker rmi $(docker images -f "dangling=true" -q)
  

• 查询指定label标签为com.example.version的镜像

  docker images -f "label=com.example.version"
  

  

• 查询指定label标签为com.example.version，且version为1.0的镜像

  docker images -f "label=com.example.version=1.0"
  

  

• 筛选在kfmirrors.io/datamining:117镜像之前创建的镜像

  docker images -f "before=kfmirrors.io/datamining:117"
  

  

• 筛选在kfmirrors.io/datamining:115镜像之后创建的镜像

  docker images -f "since=kfmirrors.io/datamining:115"
  

  

• 筛选与给定参考相匹配的镜像

  ## 镜像名中存在/的是无法匹配的
  docker images -f=reference='*datamining*:*libc'
  

  

5、格式化输出

介绍

使用--format参数对输出进行格式化处理，有效的占位符如下：

占位符	描述
.ID	镜像ID
.Repository	镜像名
.Tag	镜像标签
.Digest	镜像摘要
.CreatedSince	自创建镜像以来的时间
.CreatedAt	镜像创建的时间
.Size	镜像大小

示例

• 显示镜像ID和镜像名

  docker images --format "{{.ID}}: {{.Repository}}"
  

  

• 以表格的形式显示镜像ID、镜像名和镜像标签

  docker images --format "table {{.ID}}\t{{.Repository}}\t{{.Tag}}"