Ciclo de vida de un contenedor Docker

ciclo-de-vida-de-un-contenedor-docker
ciclo-de-vida-de-un-contenedor-docker

El ciclo de vida de un contenedor explica cómo cambia un contenedor Docker desde que se crea hasta que se ejecuta, se detiene, se reinicia o se elimina. Entenderlo evita una confusión muy habitual: pensar que un contenedor es una máquina encendida para siempre, cuando en realidad depende del proceso principal que ejecuta.

Esta lección está pensada para el curso Docker: vas a ver estados reales, comandos seguros de laboratorio y diferencias prácticas entre crear, arrancar, parar, reiniciar y borrar contenedores. No necesitas montar una aplicación compleja; el objetivo es entender el flujo.

👉 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.

Ciclo de vida de un contenedor Docker

Un contenedor nace a partir de una imagen, añade una capa de escritura y ejecuta un proceso principal. Mientras ese proceso exista, el contenedor puede estar funcionando; cuando termina, Docker conserva el estado y los logs hasta que decidas eliminarlo.

EstadoQué significaComando habitual
createdEl contenedor existe, pero todavía no está ejecutándose.docker create
runningEl proceso principal está activo.docker start o docker run
pausedLos procesos están congelados temporalmente.docker pause
exitedEl proceso terminó y el contenedor quedó detenido.docker stop o fin natural del proceso
restartingDocker intenta reiniciar el contenedor por política configurada.–restart
deadEstado anómalo en el que Docker no pudo limpiar o gestionar bien el contenedor.requiere inspección

Lo importante no es memorizar nombres, sino entender la transición: crear no es arrancar, parar no es borrar y borrar no elimina automáticamente todos los datos persistentes si usas volúmenes.

Antes de empezar

Ejecuta estos ejemplos en un entorno de pruebas. Usan imágenes pequeñas y nombres claros para que puedas limpiar al final. Aun así, revisa cada comando antes de copiarlo, especialmente los que eliminan contenedores.

  • Necesitas Docker instalado y acceso a una terminal.
  • Los ejemplos usan nombres que empiezan por ciclo- para evitar confusiones.
  • No ejecutes comandos de borrado sobre contenedores de producción.
  • Si trabajas en una máquina compartida, confirma antes con docker ps qué contenedores existen.

Crear, arrancar, detener y eliminar

Este laboratorio muestra el recorrido básico: crear un contenedor sin arrancarlo, iniciarlo, comprobar que está en ejecución, detenerlo y eliminarlo. Es la forma más clara de ver el ciclo de vida paso a paso.

docker create --name ciclo-nginx nginx:alpine
docker ps -a --filter name=ciclo-nginx
docker start ciclo-nginx
docker ps --filter name=ciclo-nginx
docker stop ciclo-nginx
docker ps -a --filter name=ciclo-nginx
docker rm ciclo-nginx

Qué debes observar

  • docker create deja el contenedor en estado created.
  • docker start lo mueve a running si el proceso principal arranca correctamente.
  • docker stop pide una parada ordenada y después el contenedor queda detenido.
  • docker rm elimina el contenedor detenido; si está en ejecución, Docker no lo borra salvo que fuerces la operación.

La parada ordenada es importante: Docker envía una señal de terminación y espera un tiempo de gracia antes de forzar el cierre. Para servicios reales, esto permite guardar estado o cerrar conexiones correctamente.

Cuando el proceso termina solo

No todos los contenedores son servicios permanentes. Algunos ejecutan una tarea y terminan. En ese caso verás el contenedor en estado exited, con un código de salida que ayuda a saber si terminó bien o falló.

docker run --name ciclo-exit alpine:3.20 sh -c "echo tarea terminada"
docker ps -a --filter name=ciclo-exit
docker inspect ciclo-exit --format '{{.State.Status}} {{.State.ExitCode}}'
docker logs ciclo-exit
docker rm ciclo-exit

Un código de salida cero suele indicar que el proceso terminó correctamente. Un código distinto de cero apunta a error, aunque siempre conviene revisar logs e inspección antes de sacar conclusiones rápidas.

  • Usa docker logs para leer la salida del proceso.
  • Usa docker inspect para ver estado, código de salida, hora de inicio y hora de finalización.
  • Usa docker ps -a para incluir contenedores detenidos en el listado.

Reinicio y políticas de recuperación

Un reinicio manual detiene y arranca el contenedor. Una política de reinicio, en cambio, le dice a Docker qué hacer si el proceso termina o si el daemon vuelve a arrancar. Es útil, pero no sustituye revisar por qué falla una aplicación.

docker run -d --name ciclo-restart --restart unless-stopped nginx:alpine
docker inspect ciclo-restart --format '{{.State.Status}} {{.HostConfig.RestartPolicy.Name}}'
docker restart ciclo-restart
docker rm -f ciclo-restart
PolíticaComportamientoCuándo usarla
noNo reinicia automáticamente.Laboratorios o tareas puntuales.
on-failureReinicia si el proceso termina con error.Servicios donde un fallo puntual puede recuperarse.
unless-stoppedReinicia salvo que lo hayas detenido manualmente.Servicios locales o de laboratorio persistente.
alwaysIntenta mantener el contenedor arriba.Servicios controlados con cuidado y monitorización.

Ten cuidado con reiniciar automáticamente algo que falla en bucle. Puede ocultar el problema real, llenar logs o consumir recursos. Primero entiende el error y después decide la política adecuada.

Datos, logs y limpieza segura

Borrar un contenedor elimina su capa de escritura, pero no necesariamente los datos guardados en volúmenes nombrados. Esta diferencia es clave para no perder información por accidente ni creer que una limpieza quitó todo.

  • Contenedor detenido: conserva logs y capa de escritura hasta que lo borres.
  • Contenedor eliminado: desaparece su estado local y ya no puedes inspeccionarlo igual.
  • Volumen nombrado: puede seguir existiendo aunque elimines el contenedor.
  • Imagen: no se borra por eliminar un contenedor; queda disponible para crear otros.

Antes de limpiar, revisa nombre, imagen y propósito. Evita comandos globales como prune en máquinas con trabajo real si no tienes claro qué recursos va a borrar.

Errores comunes

  • Pensar que docker stop elimina el contenedor. Solo lo detiene.
  • Creer que docker rm borra también todos los volúmenes nombrados. No lo asumas.
  • Confundir un contenedor en exited con un fallo: a veces una tarea terminó correctamente.
  • Usar docker rm -f por costumbre y cortar servicios sin revisar.
  • Aplicar políticas de reinicio para tapar errores de configuración.
  • No mirar logs ni código de salida antes de recrear el contenedor.

Si el contenedor se cae constantemente, no lo soluciones reiniciando a ciegas. Mira logs, inspecciona el estado y separa si el fallo viene de la imagen, la configuración, permisos, red, almacenamiento o del proceso interno.

Lecciones relacionadas del curso Docker

Documentación oficial y recursos

Dominar el ciclo de vida de un contenedor te permite operar Docker con más calma: sabes si debes crear, arrancar, detener, reiniciar, inspeccionar o borrar. También sabes cuándo no tocar nada hasta revisar logs y estado.

En un laboratorio puedes destruir y repetir para observar el ciclo de vida de un contenedor. En un entorno real, el orden correcto es observar, entender y actuar. Esa disciplina es la diferencia entre aprender Docker y romper servicios por ejecutar comandos de memoria.

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 *