docker search

在Docker Hub中搜索镜像

语法

docker search [可选项] TERM

选项

 -f，--filter filter　　   　根据提供的条件过滤输出

--format string　　       使用Go模板进行漂亮的打印搜索

--limit int                    最多搜索结果数，可以是1 ~ 100，默认为25

--no-trunc                   不要截断输出，默认false

实例

按名称搜索镜像

搜索 tomcat 镜像

docker search tomcat

限制搜索结果的数量（--limit）

显示前十条 tomcat 镜像

docker search --limit 10 tomcat

 

 显示非截断的描述（--no-trunc）

docker search --no-trunc tomcat

过滤（-f 或 --filter）

支持的过滤器：

• stars                 镜像的星数
• is-automated     是否是自动构建的镜像
• is-official           是否是官方镜像

有多个过滤器时，需要传递多个 -f 或 --filter 标志

1）搜索至少3颗星的 tomcat 镜像 

docker search --filter stars=3 tomcat

 

2）搜索官方版本的 tomcat 镜像

docker search --filter is-official=true tomcat

3）搜索自动构建的，且至少3颗星的 tomcat 镜像

docker search --filter is-automated=true --filter stars=3 tomcat

格式化输出（--format）

GO 模板的有效占位符：

.name　　　　　　   镜像名称

.Description            镜像描述

.StarCount              镜像星数

.IsOfficial                官方镜像

.IsAutomated          自动构建的镜像

使用 --format 选项时，search 命令将完全按照模板的声明输出数据。如果显示列标题，需要加上 table 伪指令。

1）以 “镜像名：星数” 且不带列标题的格式显示 tomcat 镜像

docker search --format "{{.Name}}: {{.StarCount}}" tomcat

2）带列标题的格式显示

docker search --format "table {{.Name}}\t{{.StarCount}}\t{{.IsAutomated}}" --limit 5 tomcat