Cómo inspeccionar una imagen Docker

como-inspeccionar-una-imagen-docker
como-inspeccionar-una-imagen-docker

Saber cómo inspeccionar una imagen en Docker te permite revisar metadatos, arquitectura, variables, configuración por defecto y detalles importantes antes de ejecutar un contenedor.

Inspeccionar una imagen no modifica nada. Es una consulta de lectura que te ayuda a entender qué vas a lanzar, qué comando trae por defecto y qué información registró Docker sobre esa imagen.

👉 Y recuerda, si quieres aprender más de Linux, visita el curso de Linux gratis.

🐳 Si quieres aprender más de Docker, visita el curso de Docker gratis.

Cómo inspeccionar una imagen en Docker

La herramienta principal es docker inspect. Aunque también sirve para contenedores, redes y volúmenes, aplicada a una imagen devuelve información estructurada en JSON.

docker image inspect nginx:alpine

El resultado incluye campos como identificador, etiquetas, arquitectura, sistema operativo, configuración, variables de entorno, entrypoint, comando por defecto y capas raíz de la imagen.

Qué datos puedes revisar al inspeccionar una imagen

DatoPara qué sirveCampo habitual
ArquitecturaConfirmar si la imagen coincide con tu plataforma.Architecture
VariablesVer valores definidos por la imagen.Config.Env
ComandoEntender qué se ejecutará por defecto.Config.Cmd
EntrypointRevisar el proceso inicial.Config.Entrypoint
CapasRelacionar la imagen con su sistema de archivos.RootFS.Layers

Cómo filtrar la salida de docker inspect

Como la salida completa puede ser larga, puedes usar formato Go templates para consultar un campo concreto. Esto resulta práctico en scripts o revisiones rápidas.

docker image inspect nginx:alpine --format "{{.Architecture}} {{.Os}}"
docker image inspect nginx:alpine --format "{{json .Config.Cmd}}"

El primer comando muestra plataforma básica. El segundo imprime el comando por defecto en formato JSON, útil cuando el valor puede contener varios elementos.

Ejemplo práctico de inspección

Un flujo sencillo consiste en descargar una imagen conocida, inspeccionarla y revisar su configuración antes de usarla como base para pruebas.

docker pull nginx:alpine
docker image inspect nginx:alpine --format "ID={{.Id}}"
docker image inspect nginx:alpine --format "Entrypoint={{json .Config.Entrypoint}} Cmd={{json .Config.Cmd}}"

Este bloque te permite confirmar qué imagen tienes localmente y qué proceso se lanzará si creas un contenedor sin sobrescribir el comando.

Diferencia entre inspeccionar imagen y contenedor

Una imagen es una plantilla de solo lectura. Un contenedor es una ejecución concreta basada en esa imagen. Por eso inspeccionar una imagen responde preguntas sobre la plantilla, mientras que inspeccionar un contenedor muestra estado, red, mounts, límites y runtime.

Si buscas por qué un servicio se cayó, inspecciona el contenedor. Si buscas qué trae una imagen antes de ejecutarla, inspecciona la imagen.

Errores comunes al inspeccionar imágenes

Un error frecuente es asumir que docker inspect hace una auditoría de seguridad. No es así: muestra metadatos y configuración. Para vulnerabilidades necesitas herramientas de escaneo y revisión de procedencia.

Otro error es usar etiquetas ambiguas como latest sin confirmar el digest o la versión real. Para despliegues reproducibles, conviene trabajar con versiones explícitas o digest cuando el flujo lo requiera.

Lecciones relacionadas del curso Docker

Documentación oficial y recursos

Buenas prácticas al inspeccionar imágenes

Usa docker inspect para confirmar datos antes de ejecutar imágenes desconocidas o antes de crear documentación interna. Es especialmente útil para verificar entrypoint, comando por defecto y variables esperadas.

Cuando estés aprendiendo cómo inspeccionar una imagen, no intentes memorizar todo el JSON. Empieza por los campos que responden preguntas prácticas: qué arquitectura tiene, qué comando ejecuta, qué variables declara y qué capas forman su sistema de archivos.

En equipos de operaciones, esta revisión también ayuda a documentar decisiones. Si una imagen cambia de entrypoint, de variable esperada o de arquitectura, puedes detectar la diferencia antes de desplegarla en un entorno donde el fallo sería más caro.

Otra práctica útil es guardar comandos de inspección con –format en notas internas o scripts pequeños. Así cualquier persona del equipo puede repetir la misma comprobación sin depender de una lectura manual de cientos de líneas JSON en cada despliegue real importante y seguro.

Por eso, dominar cómo inspeccionar una imagen no es solo una tarea puntual. Es una habilidad de diagnóstico que complementa el uso de docker pull, docker run, docker history y las herramientas de escaneo.

En resumen, aprender cómo inspeccionar una imagen te ayuda a trabajar con Docker de forma más controlada. No sustituye a un escaneo de seguridad, pero sí ofrece información esencial para operar con criterio.

Comentarios

No hay comentarios aún. ¿Por qué no comienzas el debate?

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *