# docker search **Descripción:** Busca imágenes en Docker Hub **Uso:** `docker search [OPTIONS] TERM` ## Descripción Busca imágenes en [Docker Hub](https://hub.docker.com) ## 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': ```console $ 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) {#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: ```console $ 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) {#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) {#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: ```console $ 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: ```console $ 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) {#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: ```console $ 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: ```console $ 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 ```