Debugging dentro de Contenedores

Depurar dentro de un contenedor consiste en observar sin alterar primero: estado, proceso principal, variables no sensibles, rutas montadas y red. El objetivo es localizar la capa que falla antes de cambiar la imagen o añadir paquetes sin criterio.

Ejemplo resuelto

Si el contenedor termina inmediatamente, empieza por su estado y salida, no por abrir una shell en un proceso que ya murió.

1. Revisa si está running o exited y conserva el código de salida.

2. Consulta los logs del arranque.

3. Inspecciona el comando configurado y el directorio de trabajo.

4. Si sigue activo, entra con una shell disponible y verifica rutas y procesos.

Error frecuente: instalar herramientas dentro del contenedor y considerar resuelto el problema; corrígelo usando observación temporal y trasladando la solución al Dockerfile solo después de identificar la causa.

Para el servicio local ficticio api, empieza por docker compose ps -a y docker compose logs --tail=50 api. Si terminó, docker compose exec no puede entrar en él: usa inspección del comando y una ejecución temporal de diagnóstico que no monte datos sensibles. Conserva el error de archivo ausente antes de corregirlo.

Pruébalo

Simula un servicio cuyo comando apunta a /app/bin/missing. Escribe la secuencia de diagnóstico y el cambio mínimo.

Comprueba tu resultado

Debes identificar que la ruta no existe mediante estado, logs o inspección, corregir el comando para apuntar a un archivo real y obtener un proceso principal activo, sin modificar datos persistentes.