码头工人搜索
描述
在Docker Hub中搜索图像
用法
$ docker search [OPTIONS] TERM
扩展说明
在Docker Hub中搜索图像
有关此命令的示例用法，请参阅下面的示例部分。
选项
| 名称，简写 | 默认 | 描述 |
--filter ， -f |
根据提供的条件过滤输出 | |
--format |
使用Go模板进行漂亮的打印搜索 | |
--limit |
25 |
最多搜索结果数 |
--no-trunc |
不要截断输出 |
例子
按名称搜索图像
本示例显示名称包含“ busybox”的图像：
$ docker search busybox
NAME DESCRIPTION STARS OFFICIAL AUTOMATED
busybox Busybox base image. 316 [OK]
progrium/busybox 50 [OK]
radial/busyboxplus Full-chain, Internet enabled, busybox made... 8 [OK]
odise/busybox-python 2 [OK]
azukiapp/busybox This image is meant to be used as the base... 2 [OK]
ofayau/busybox-jvm Prepare busybox to install a 32 bits JVM. 1 [OK]
shingonoide/archlinux-busybox Arch Linux, a lightweight and flexible Lin... 1 [OK]
odise/busybox-curl 1 [OK]
ofayau/busybox-libc32 Busybox with 32 bits (and 64 bits) libs 1 [OK]
peelsky/zulu-openjdk-busybox 1 [OK]
skomma/busybox-data Docker image suitable for data volume cont... 1 [OK]
elektritter/busybox-teamspeak Lightweight teamspeak3 container based on... 1 [OK]
socketplane/busybox 1 [OK]
oveits/docker-nginx-busybox This is a tiny NginX docker image based on... 0 [OK]
ggtools/busybox-ubuntu Busybox ubuntu version with extra goodies 0 [OK]
nikfoundas/busybox-confd Minimal busybox based distribution of confd 0 [OK]
openshift/busybox-http-app 0 [OK]
jllopis/busybox 0 [OK]
swyckoff/busybox 0 [OK]
powellquiring/busybox 0 [OK]
williamyeh/busybox-sh Docker image for BusyBox's sh 0 [OK]
simplexsys/busybox-cli-powered Docker busybox images, with a few often us... 0 [OK]
fhisamoto/busybox-java Busybox java 0 [OK]
scottabernethy/busybox 0 [OK]
marclop/busybox-solr
显示非截断的描述（--no-trunc）
本示例显示名称包含“ busybox”，至少3星的图像，并且输出中的描述不被截断：
$ docker search --filter=stars=3 --no-trunc busybox
NAME DESCRIPTION STARS OFFICIAL AUTOMATED
busybox Busybox base image. 325 [OK]
progrium/busybox 50 [OK]
radial/busyboxplus Full-chain, Internet enabled, busybox made from scratch. Comes in git and cURL flavors. 8 [OK]
限制搜寻结果（--limit）
该标志--limit是搜索返回的最大结果数。此值的范围可以是1到100。默认值为--limit25。
筛选
过滤标志（-f或--filter）格式为一key=value对。如果有多个过滤器，则传递多个标志（例如--filter is-automated=true --filter stars=3）
当前支持的过滤器是：
- 星星（整数-图像具有的星星数）
- is-automated（布尔值-真或假）-图像是否自动
- 是官方的（布尔值-正确或错误）-图片是否正式
星星
本示例显示名称包含“ busybox”且至少三颗星的图像：
$ docker search --filter stars=3 busybox
NAME DESCRIPTION STARS OFFICIAL AUTOMATED
busybox Busybox base image. 325 [OK]
progrium/busybox 50 [OK]
radial/busyboxplus Full-chain, Internet enabled, busybox made... 8 [OK]
是自动的
本示例显示名称包含“ busybox”的图像，并且它们是自动构建的：
$ docker search --filter is-automated=true busybox
NAME DESCRIPTION STARS OFFICIAL AUTOMATED
progrium/busybox 50 [OK]
radial/busyboxplus Full-chain, Internet enabled, busybox made... 8 [OK]
是官方的
本示例显示名称包含“ busybox”，至少三颗星且为官方版本的图像：
$ docker search --filter is-official=true --filter stars=3 busybox
NAME DESCRIPTION STARS OFFICIAL AUTOMATED
progrium/busybox 50 [OK]
radial/busyboxplus Full-chain, Internet enabled, busybox made... 8 [OK]
格式化输出
格式化选项（--format）使用Go模板漂亮地打印搜索输出。
Go模板的有效占位符为：
| 占位符 | 描述 |
|---|---|
.Name |
图片名称 |
.Description |
图片说明 |
.StarCount |
图像的星数 |
.IsOfficial |
如果图像是官方的，则单击“确定” |
.IsAutomated |
如果图像构建是自动的，则单击“确定” |
使用该--format选项时，该search命令将完全按照模板的声明输出数据。如果使用
table伪指令，则还包括列标题。
以下示例使用不带标题的模板，Name并为所有图像输出StarCount用冒号（:）分隔的
和条目：
$ docker search --format "{{.Name}}: {{.StarCount}}" nginx
nginx: 5441
jwilder/nginx-proxy: 953
richarvey/nginx-php-fpm: 353
million12/nginx-php: 75
webdevops/php-nginx: 70
h3nrik/nginx-ldap: 35
bitnami/nginx: 23
evild/alpine-nginx: 14
million12/nginx: 9
maxexcloo/nginx: 7
本示例输出表格式：
$ docker search --format "table {{.Name}}\t{{.IsAutomated}}\t{{.IsOfficial}}" nginx
NAME AUTOMATED OFFICIAL
nginx [OK]
jwilder/nginx-proxy [OK]
richarvey/nginx-php-fpm [OK]
jrcs/letsencrypt-nginx-proxy-companion [OK]
million12/nginx-php [OK]
webdevops/php-nginx [OK]
上级命令
| 命令 | 描述 |
|---|---|
| 码头工人 | Docker CLI的基本命令。 |