Cómo usar el comando docker search para encontrar imágenes

Introducción

En este laboratorio, aprenderá cómo utilizar de manera efectiva el comando docker search para encontrar imágenes de contenedores en Docker Hub. Comenzará realizando búsquedas básicas de imágenes por nombre.

A partir de la búsqueda básica, luego explorará opciones para mostrar las descripciones completas, no truncadas, de los resultados de la búsqueda. Además, aprenderá cómo refinar sus búsquedas filtrando los resultados en función de criterios como el número de estrellas y el estado oficial. Finalmente, descubrirá cómo limitar el número de resultados mostrados y formatear la salida de la búsqueda utilizando una plantilla de Go para una visualización personalizada.

Skills Graph

Buscar imágenes en Docker Hub por nombre

En este paso, aprenderá cómo buscar imágenes de Docker en Docker Hub utilizando el comando docker search. Docker Hub es un servicio de registro basado en la nube proporcionado por Docker que le permite encontrar y compartir imágenes de contenedores.

La sintaxis básica del comando docker search es:

docker search [OPTIONS] TERM

Donde TERM es el término de búsqueda que desea utilizar para encontrar imágenes.

Comencemos buscando imágenes relacionadas con "ubuntu". Abra su terminal en el entorno LabEx y ejecute el siguiente comando:

docker search ubuntu

Debería ver una lista de imágenes relacionadas con Ubuntu. La salida normalmente incluye el nombre de la imagen, la descripción, las estrellas (número de "me gusta"), el estado oficial y el estado de la construcción automatizada.

La salida podría verse algo así (la salida exacta puede variar):

NAME                                                   DESCRIPTION                                       STARS     OFFICIAL   AUTOMATED
ubuntu                                                 Ubuntu is a Debian-based Linux operating sys...   15000     [OK]
ubuntu-upstart                                         Upstart is an event-based replacement for th...   50        [OK]
ubuntu/apache2                                         Apache2 web server                                60                   [OK]
ubuntu/nginx                                           Nginx web server                                  50                   [OK]
...

Este comando busca en Docker Hub imágenes cuyos nombres o descripciones coincidan con el término "ubuntu". Los resultados se muestran en formato de tabla.

Mostrar la descripción no truncada de los resultados de la búsqueda

En el paso anterior, buscó imágenes de Docker y vio que la columna de descripción podría estar truncada, lo que significa que no se muestra la descripción completa. Para ver la descripción completa, puede utilizar la opción --no-trunc con el comando docker search.

Volvamos a buscar "ubuntu", pero esta vez, usaremos la bandera --no-trunc para mostrar la descripción completa.

docker search --no-trunc ubuntu

Observe la salida. Ahora debería ver la descripción completa de cada imagen, sin ningún truncamiento. Esto es útil cuando necesita leer todos los detalles sobre una imagen antes de decidir utilizarla.

La opción --no-trunc es útil para obtener toda la información en la salida de varios comandos de Docker, no solo de docker search.

Filtrar los resultados de la búsqueda por estrellas y estado oficial

En este paso, aprenderá cómo filtrar los resultados de la búsqueda en función de criterios como el número de estrellas y si la imagen es oficial. Esto le ayudará a encontrar imágenes más relevantes y confiables.

Puede utilizar la opción --filter para aplicar filtros a su búsqueda. La opción --filter toma un par clave=valor.

Para filtrar por el número de estrellas, utilice la clave stars seguida del número mínimo de estrellas que desee. Por ejemplo, para encontrar imágenes de Ubuntu con al menos 1000 estrellas, ejecute:

docker search --filter stars=1000 ubuntu

Observe la salida. Ahora solo debería ver imágenes de Ubuntu que tienen 1000 o más estrellas.

También puede filtrar las imágenes oficiales utilizando la clave is-official con un valor de true. Las imágenes oficiales son mantenidas por Docker o los proveedores originales del software y generalmente se consideran más confiables.

Para encontrar imágenes oficiales de Ubuntu, utilice el siguiente comando:

docker search --filter is-official=true ubuntu

La salida mostrará solo las imágenes oficiales de Ubuntu.

Puede combinar múltiples filtros utilizando la opción --filter varias veces. Por ejemplo, para encontrar imágenes oficiales de Ubuntu con al menos 1000 estrellas, utilizaría:

docker search --filter is-official=true --filter stars=1000 ubuntu

Este comando reducirá los resultados para mostrar solo las imágenes oficiales de Ubuntu que han recibido al menos 1000 estrellas.

Limitar el número de resultados de la búsqueda

En este paso, aprenderá cómo limitar el número de resultados de búsqueda mostrados por el comando docker search. Esto es útil cuando está buscando un término general y solo desea ver los mejores resultados.

Puede utilizar la opción --limit para especificar el número máximo de resultados a mostrar. La opción --limit toma un valor entero.

Por ejemplo, para buscar "ubuntu" y limitar los resultados a los 5 primeros, ejecute el siguiente comando:

docker search --limit 5 ubuntu

Observe la salida. Ahora debería ver un máximo de 5 resultados para su consulta de búsqueda.

Puede combinar la opción --limit con otras opciones como --filter y --no-trunc. Por ejemplo, para encontrar las 3 mejores imágenes oficiales de Ubuntu con al menos 1000 estrellas y mostrar sus descripciones completas, utilizaría:

docker search --filter is-official=true --filter stars=1000 --limit 3 --no-trunc ubuntu

Este comando demuestra cómo puede combinar diferentes opciones para refinar su búsqueda y controlar la salida.

Formatear la salida de la búsqueda utilizando una plantilla de Go

En este paso, aprenderá cómo formatear la salida del comando docker search utilizando una plantilla de Go. Esto le permite personalizar la información mostrada y su presentación.

La opción --format le permite especificar una plantilla de Go para formatear la salida. Las plantillas de Go son potentes y flexibles para controlar la salida.

Vamos a formatear la salida para mostrar solo el nombre de la imagen y el número de estrellas, separados por una tabulación. La plantilla se verá así: {{.Name}}\t{{.Stars}}.

Ejecute el siguiente comando para buscar "ubuntu" y formatear la salida:

docker search --format "{{.Name}}\t{{.Stars}}" ubuntu

Debería ver una lista donde cada línea contiene el nombre de la imagen seguido de una tabulación y el número de estrellas.

Intentemos una plantilla un poco más compleja para mostrar el nombre, el estado oficial y la descripción, cada uno en una nueva línea. La plantilla será Name: {{.Name}}\nOfficial: {{.IsOfficial}}\nDescription: {{.Description}}\n.

docker search --format "Name: {{.Name}}\nOfficial: {{.IsOfficial}}\nDescription: {{.Description}}\n" --limit 3 ubuntu

Este comando mostrará el nombre, el estado oficial y la descripción de las 3 mejores imágenes de Ubuntu, con cada pieza de información en una línea separada. También incluimos la opción --limit 3 para mantener la salida concisa.

Utilizar plantillas de Go proporciona una forma poderosa de extraer y presentar la información específica que necesita de los resultados de docker search.

Resumen

En este laboratorio, aprendiste cómo usar el comando docker search para encontrar imágenes de Docker en Docker Hub. Comenzaste realizando una búsqueda básica de imágenes por nombre, observando el formato de salida predeterminado que incluye el nombre, la descripción, las estrellas, el estado oficial y el estado de construcción automatizada.

Luego, exploraste cómo mostrar la descripción completa, sin truncar, de los resultados de la búsqueda utilizando la opción --no-trunc. Además, aprendiste a refinar tus búsquedas filtrando los resultados en función del número de estrellas y el estado oficial, y cómo limitar el número de resultados mostrados. Finalmente, descubriste cómo personalizar el formato de salida de los resultados de la búsqueda utilizando una plantilla de Go.