docker search
| Descripción | Busca imágenes en Docker Hub |
|---|---|
| Uso | docker search [OPTIONS] TERM |
Descripción
Busca imágenes en Docker Hub
Opciones
| Opción | Predeterminado | Descripción |
|---|---|---|
-f, --filter | Filtra la salida según las condiciones proporcionadas | |
--format | Muestra la búsqueda con un diseño mejorado utilizando una plantilla Go | |
--limit | Número máximo de resultados de búsqueda | |
--no-trunc | No truncar la salida |
Ejemplos
Buscar imágenes por nombre
Este ejemplo muestra imágenes con un nombre que contiene 'busybox':
$ docker search busybox
NAME DESCRIPTION STARS OFFICIAL
busybox Busybox base image. 316 [OK]
progrium/busybox 50
radial/busyboxplus Full-chain, Internet enabled, busybox made... 8
odise/busybox-python 2
azukiapp/busybox This image is meant to be used as the base... 2
ofayau/busybox-jvm Prepare busybox to install a 32 bits JVM. 1
shingonoide/archlinux-busybox Arch Linux, a lightweight and flexible Lin... 1
odise/busybox-curl 1
ofayau/busybox-libc32 Busybox with 32 bits (and 64 bits) libs 1
peelsky/zulu-openjdk-busybox 1
skomma/busybox-data Docker image suitable for data volume cont... 1
elektritter/busybox-teamspeak Lightweight teamspeak3 container based on... 1
socketplane/busybox 1
oveits/docker-nginx-busybox This is a tiny NginX docker image based on... 0
ggtools/busybox-ubuntu Busybox ubuntu version with extra goodies 0
nikfoundas/busybox-confd Minimal busybox based distribution of confd 0
openshift/busybox-http-app 0
jllopis/busybox 0
swyckoff/busybox 0
powellquiring/busybox 0
williamyeh/busybox-sh Docker image for BusyBox's sh 0
simplexsys/busybox-cli-powered Docker busybox images, with a few often us... 0
fhisamoto/busybox-java Busybox java 0
scottabernethy/busybox 0
marclop/busybox-solr
Mostrar la descripción sin truncar (--no-trunc)
Este ejemplo muestra imágenes con un nombre que contiene 'busybox', al menos 3 estrellas y la descripción no se trunca en la salida:
$ docker search --filter=stars=3 --no-trunc busybox
NAME DESCRIPTION STARS OFFICIAL
busybox Busybox base image. 325 [OK]
progrium/busybox 50
radial/busyboxplus Full-chain, Internet enabled, busybox made from scratch. Comes in git and cURL flavors. 8
Limitar los resultados de la búsqueda (--limit)
El flag --limit es el número máximo de resultados devueltos por una búsqueda. Si no
se establece ningún valor, el demonio establece el valor predeterminado.
Filtrado (--filter)
El formato del flag de filtrado (-f o --filter) es un par clave=valor. Si hay más
de un filtro, pasa múltiples flags (por ejemplo, --filter is-official=true --filter stars=3).
Los filtros admitidos actualmente son:
- stars (entero - número de estrellas que tiene la imagen)
- is-automated (booleano - true o false) - si la imagen es automatizada o no (obsoleto)
- is-official (booleano - true o false) - si la imagen es oficial o no
stars
Este ejemplo muestra imágenes con un nombre que contiene 'busybox' y al menos 3 estrellas:
$ docker search --filter stars=3 busybox
NAME DESCRIPTION STARS OFFICIAL
busybox Busybox base image. 325 [OK]
progrium/busybox 50
radial/busyboxplus Full-chain, Internet enabled, busybox made... 8
is-official
Este ejemplo muestra imágenes con un nombre que contiene 'busybox', que tienen al menos 3 estrellas y son compilaciones oficiales:
$ docker search --filter is-official=true --filter stars=3 busybox
NAME DESCRIPTION STARS OFFICIAL
busybox Busybox base image. 325 [OK]
Dar formato a la salida (--format)
La opción de formato (--format) muestra la salida de la búsqueda de forma más amigable
utilizando una plantilla Go.
A continuación se listan los marcadores de posición válidos para la plantilla Go:
| Marcador de posición | Descripción |
|---|---|
.Name | Nombre de la imagen |
.Description | Descripción de la imagen |
.StarCount | Número de estrellas de la imagen |
.IsOfficial | "OK" si la imagen es oficial |
Cuando se utiliza la opción --format, el comando search
mostrará los datos exactamente como los declara la plantilla. Si utilizas la
directiva table, también se incluirán los encabezados de las columnas.
El siguiente ejemplo utiliza una plantilla sin encabezados y muestra las
entradas de Name y StarCount separadas por dos puntos (:) para todas las imágenes:
$ 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
Este ejemplo muestra la salida en formato de tabla:
$ docker search --format "table {{.Name}}\t{{.IsOfficial}}" nginx
NAME OFFICIAL
nginx [OK]
jwilder/nginx-proxy
richarvey/nginx-php-fpm
jrcs/letsencrypt-nginx-proxy-companion
million12/nginx-php
webdevops/php-nginx