92f10fe228
This fix tries to address the issue raised in #23055. Currently `docker search` result caps at 25 and there is no way to allow getting more results (if exist). This fix adds the flag `--limit` so that it is possible to return more results from the `docker search`. Related documentation has been updated. Additional tests have been added to cover the changes. This fix fixes #23055. Signed-off-by: Yong Tang <yong.tang.github@outlook.com>
2.3 KiB
% DOCKER(1) Docker User Manuals % Docker Community % JUNE 2014
NAME
docker-search - Search the Docker Hub for images
SYNOPSIS
docker search [-f|--filter[=[]]] [--help] [--limit[=LIMIT]] [--no-trunc] TERM
DESCRIPTION
Search Docker Hub for images that match the specified TERM. The table
of images returned displays the name, description (truncated by default), number
of stars awarded, whether the image is official, and whether it is automated.
Note - Search queries will only return up to 25 results
OPTIONS
-f, --filter=[] Filter output based on these conditions:
- stars=
- is-automated=(true|false)
- is-official=(true|false)
--help Print usage statement
--limit=LIMIT Maximum returned search results. The default is 25.
--no-trunc=true|false Don't truncate output. The default is false.
EXAMPLES
Search Docker Hub for ranked images
Search a registry for the term 'fedora' and only display those images ranked 3 or higher:
$ docker search --filter=stars=3 fedora
NAME DESCRIPTION STARS OFFICIAL AUTOMATED
mattdm/fedora A basic Fedora image corresponding roughly... 50
fedora (Semi) Official Fedora base image. 38
mattdm/fedora-small A small Fedora image on which to build. Co... 8
goldmann/wildfly A WildFly application server running on a ... 3 [OK]
Search Docker Hub for automated images
Search Docker Hub for the term 'fedora' and only display automated images ranked 1 or higher:
$ docker search --filter=is-automated=true --filter=stars=1 fedora
NAME DESCRIPTION STARS OFFICIAL AUTOMATED
goldmann/wildfly A WildFly application server running on a ... 3 [OK]
tutum/fedora-20 Fedora 20 image with SSH access. For the r... 1 [OK]
HISTORY
April 2014, Originally compiled by William Henry (whenry at redhat dot com) based on docker.com source material and internal work. June 2014, updated by Sven Dowideit SvenDowideit@home.org.au April 2015, updated by Mary Anthony for v2 mary@docker.com April 2016, updated by Vincent Demeester vincent@sbr.pm