5. Inspección, Logs y Acceso Interactivo: docker logs, inspect y exec -it
Aprende a diagnosticar errores en contenedores en ejecución consultando logs en tiempo real y abriendo una terminal interactiva bash/sh dentro del contenedor.
Diagnóstico y Depuración en Docker
Cuando un contenedor se niega a arrancar o una aplicación responde con error HTTP 500, no podemos limitarnos a "adivinar". Docker proporciona herramientas de nivel profesional para inspeccionar la salida estándar del proceso y conectarse interactivamente a su interior.
1. Lectura de Registros con docker logs
En la filosofía de doce factores (12-Factor App) adoptada por Docker, los contenedores no deben escribir logs en archivos locales rotativos; en su lugar, todo log debe emitirse a stdout y stderr. Docker captura automáticamente estos flujos y los expone mediante docker logs:
docker logs mi-contenedor: Imprime todo el historial de logs desde el arranque.docker logs -f mi-contenedor: Modo follow (equivalente atail -fen Linux); mantiene la conexión abierta y muestra nuevos logs en tiempo real.docker logs --tail 50 mi-contenedor: Muestra solo las últimas 50 líneas.
2. Acceso Interactivo con docker exec -it
El comando docker exec ejecuta un comando secundario dentro de un contenedor que ya está corriendo:
-i(interactivo): Mantiene abierto el flujoSTDINpara recibir comandos.-t(pseudo-TTY): Asigna una consola virtual con colores y soporte de cursor.
/bin/bash. Sin embargo, en imágenes ultraligeras basadas en Alpine Linux (como nginx:alpine o node:alpine), bash no viene instalado; debes usar /bin/sh.
3. Metadatos de Red y Configuración con docker inspect
docker inspect <nombre_o_id> devuelve un objeto JSON exhaustivo con todos los detalles del contenedor: dirección IP asignada en la red bridge, montajes de volúmenes, variables de entorno inyectadas, políticas de reinicio y estado de salud (healthcheck).
⚡ Comandos Prácticos de Depuración y Conexión SSH Virtual
Ejemplos para seguir logs en vivo, entrar a una terminal interactiva y filtrar la IP con jq o formato Go template:
# 1. Monitorear los logs de acceso y errores de Nginx en tiempo real
docker logs -f --tail 100 mi-servidor-web
# 2. Entrar a la consola de un contenedor Alpine (sh)
docker exec -it mi-servidor-web sh
# 3. Entrar a la consola de un contenedor Ubuntu/Debian (bash)
docker exec -it mi-app-laravel bash
# 4. Ejecutar un comando puntual sin entrar a la terminal (ej: versión de PHP dentro del contenedor)
docker exec mi-app-laravel php -v
# 5. Obtener únicamente la dirección IP asignada al contenedor usando formateo Go
docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' mi-servidor-web
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Qué combinación de banderas es obligatoria para abrir una sesión interactiva de shell dentro de un contenedor con "docker exec"?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar Docker & Contenedores: De Cero a Producción y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.