Tema 5 · Depuración & Acceso

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 a tail -f en 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 flujo STDIN para recibir comandos.
  • -t (pseudo-TTY): Asigna una consola virtual con colores y soporte de cursor.
⚠️ Bash vs Sh: En imágenes basadas en Debian o Ubuntu el shell disponible suele ser /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:

depuracion-docker.sh
Solo lectura
# 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
1 Pregunta
Pregunta 1
¿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.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.