mirror of
https://github.com/docker/docs.git
synced 2026-03-27 22:38:54 +07:00
c588fbe5ca
Regenerated the yaml files after fixing a bug in the generator script that caused some extended descriptions and examples to not be included. Also fixes the generated YAML to use the "long form" format, instead of the compact format (where newlines were encoded as `\n`). This makes the YAML more "human readable", and makes reviewing updates easier. Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
233 lines
9.2 KiB
YAML
233 lines
9.2 KiB
YAML
command: docker search
|
|
short: Search the Docker Hub for images
|
|
long: |-
|
|
Search [Docker Hub](https://hub.docker.com) for images
|
|
|
|
See [*Find Public Images on Docker Hub*](https://docs.docker.com/engine/tutorials/dockerrepos/#searching-for-images) for
|
|
more details on finding shared images from the command line.
|
|
|
|
> **Note**: Search queries return a maximum of 25 results.
|
|
usage: docker search [OPTIONS] TERM
|
|
pname: docker
|
|
plink: docker.yaml
|
|
options:
|
|
- option: automated
|
|
value_type: bool
|
|
default_value: "false"
|
|
description: Only show automated builds
|
|
deprecated: true
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
- option: filter
|
|
shorthand: f
|
|
value_type: filter
|
|
description: Filter output based on conditions provided
|
|
deprecated: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
- option: format
|
|
value_type: string
|
|
description: Pretty-print search using a Go template
|
|
deprecated: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
- option: limit
|
|
value_type: int
|
|
default_value: "25"
|
|
description: Max number of search results
|
|
deprecated: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
- option: no-trunc
|
|
value_type: bool
|
|
default_value: "false"
|
|
description: Don't truncate output
|
|
deprecated: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
- option: stars
|
|
shorthand: s
|
|
value_type: uint
|
|
default_value: "0"
|
|
description: Only displays with at least x stars
|
|
deprecated: true
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
examples: |-
|
|
### Search images by name
|
|
|
|
This example displays images with a name containing 'busybox':
|
|
|
|
```none
|
|
$ 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
|
|
```
|
|
|
|
### Display non-truncated description (--no-trunc)
|
|
|
|
This example displays images with a name containing 'busybox',
|
|
at least 3 stars and the description isn't truncated in the output:
|
|
|
|
```bash
|
|
$ 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 search results (--limit)
|
|
|
|
The flag `--limit` is the maximum number of results returned by a search. This value could
|
|
be in the range between 1 and 100. The default value of `--limit` is 25.
|
|
|
|
### Filtering
|
|
|
|
The filtering flag (`-f` or `--filter`) format is a `key=value` pair. If there is more
|
|
than one filter, then pass multiple flags (e.g. `--filter is-automated=true --filter stars=3`)
|
|
|
|
The currently supported filters are:
|
|
|
|
* stars (int - number of stars the image has)
|
|
* is-automated (boolean - true or false) - is the image automated or not
|
|
* is-official (boolean - true or false) - is the image official or not
|
|
|
|
#### stars
|
|
|
|
This example displays images with a name containing 'busybox' and at
|
|
least 3 stars:
|
|
|
|
```bash
|
|
$ 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]
|
|
```
|
|
|
|
#### is-automated
|
|
|
|
This example displays images with a name containing 'busybox'
|
|
and are automated builds:
|
|
|
|
```bash
|
|
$ 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]
|
|
```
|
|
|
|
#### is-official
|
|
|
|
This example displays images with a name containing 'busybox', at least
|
|
3 stars and are official builds:
|
|
|
|
```bash
|
|
$ 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 the output
|
|
|
|
The formatting option (`--format`) pretty-prints search output
|
|
using a Go template.
|
|
|
|
Valid placeholders for the Go template are:
|
|
|
|
| Placeholder | Description |
|
|
| -------------- | --------------------------------- |
|
|
| `.Name` | Image Name |
|
|
| `.Description` | Image description |
|
|
| `.StarCount` | Number of stars for the image |
|
|
| `.IsOfficial` | "OK" if image is official |
|
|
| `.IsAutomated` | "OK" if image build was automated |
|
|
|
|
When you use the `--format` option, the `search` command will
|
|
output the data exactly as the template declares. If you use the
|
|
`table` directive, column headers are included as well.
|
|
|
|
The following example uses a template without headers and outputs the
|
|
`Name` and `StarCount` entries separated by a colon for all images:
|
|
|
|
```bash
|
|
{% raw %}
|
|
$ 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
|
|
{% endraw %}
|
|
```
|
|
|
|
This example outputs a table format:
|
|
|
|
```bash
|
|
{% raw %}
|
|
$ 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]
|
|
{% endraw %}
|
|
```
|
|
deprecated: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
|