Cómo pausar y reanudar contenedores Docker

como-pausar-y-reanudar-contenedores-docker

Cómo pausar y reanudar contenedores Docker sirve para suspender temporalmente los procesos de una instancia y continuar después desde el mismo punto. Docker pausa todos los procesos del contenedor; no los apaga ni les pide cerrar conexiones o guardar su estado.

En Linux, Docker utiliza el mecanismo freezer de cgroups para congelar esos procesos. La aplicación no recibe una señal normal de apagado mientras está pausada. Por eso, pause es distinto de stop: úsalo solo cuando quieras interrumpir brevemente la ejecución y aceptes que el servicio deje de responder durante ese intervalo.

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

Qué cambia al pausar un contenedor

El contenedor pasa de running a paused y Docker suspende todos sus procesos, no solo el proceso principal. Su configuración, la capa escribible y los volúmenes permanecen asociados a la instancia. La pausa no elimina datos ni libera por sí sola la memoria que ya está asignada.

Aunque la configuración de red y los puertos publicados sigan presentes, la aplicación no puede procesar peticiones mientras sus procesos están congelados. Los clientes pueden quedarse esperando o agotar su tiempo de espera. Al reanudar, los procesos continúan; eso no sustituye un apagado limpio y no garantiza que una transacción en curso se haya completado de forma segura.

Docker tampoco permite ejecutar un proceso nuevo con docker exec mientras el contenedor permanece pausado. Reanúdalo primero si necesitas inspeccionar su interior.

Diferencias entre pausar, detener y reiniciar

AcciónQué ocurreCuándo elegirla
docker pauseSuspende todos los procesos del contenedor sin detenerlos de forma ordenada.Congelación temporal y controlada.
docker unpauseReanuda los procesos suspendidos.Continuar la ejecución después de una pausa.
docker stopEnvía la señal de parada configurada y espera el plazo de gracia.Apagar un servicio sin forzar su cierre.
docker startArranca un contenedor detenido que ya existe.Volver a poner en marcha una instancia parada.
docker restartDetiene y arranca de nuevo el mismo contenedor.Reiniciar un servicio; no lo deja congelado.

Sintaxis básica de docker pause y docker unpause

Ambos comandos reciben el nombre o ID de uno o varios contenedores existentes. Para pausar, el contenedor debe estar en ejecución. Para reanudarlo, identifica la instancia que aparece como pausada:

docker pause NOMBRE
docker unpause NOMBRE

No uses un nombre de ejemplo directamente en un servidor. Comprueba el objetivo con docker ps -a antes de actuar; si la instancia pertenece a un proyecto Compose, utiliza el nombre de servicio y los comandos de Compose que aparecen más abajo.

Prueba segura en un contenedor de laboratorio

Este flujo crea una instancia temporal de Nginx, comprueba su estado, la pausa, verifica el cambio y la reanuda. Al final la detiene con una señal de parada normal y elimina el contenedor ya detenido:

docker run -d --name pause-demo nginx:alpine
docker ps --filter name=pause-demo
docker pause pause-demo
docker ps --filter status=paused
docker inspect --format '{{.State.Status}}' pause-demo
docker unpause pause-demo
docker inspect --format '{{.State.Status}}' pause-demo
docker stop pause-demo
docker rm pause-demo

Después de docker pause, la consulta de estado debe identificar la instancia como pausada; en docker ps puede mostrarse como Up con la indicación Paused. Tras docker unpause vuelve a running. La última parte del bloque limpia únicamente el contenedor de prueba; docker stop lo detiene antes de docker rm.

Usar pause y unpause con Docker Compose

Si el contenedor forma parte de un proyecto Compose, puedes pausar un servicio o todos los servicios. Sustituye proyecto por el servicio definido en el archivo Compose; no confundas ese nombre con un nombre fijo de contenedor.

docker compose pause web
docker compose ps
docker compose unpause web

La pausa afecta los procesos del servicio indicado, pero no reemplaza la gestión de dependencias ni una política de mantenimiento. Si el objetivo es retirar temporalmente una aplicación de producción, prepara primero el tráfico y las comprobaciones de salud del entorno.

Cuándo conviene pausar y cuándo no

  • Usa pause solo para una suspensión breve y controlada cuando necesites congelar los procesos sin destruir la instancia.
  • Prefiere stop para detener un servicio y darle oportunidad de cerrar conexiones, escribir datos pendientes y liberar recursos de ejecución.
  • No uses pause como solución a un contenedor que falla o como forma de reiniciarlo: primero revisa estado y registros.
  • Ten presente que los clientes pueden sufrir cortes o tiempos de espera y que el contenedor sigue ocupando recursos mientras permanece pausado.

Errores frecuentes al pausar contenedores

  • El contenedor no está en ejecución: identifica su estado con docker ps -a. Si está detenido, pause no lo arranca; usa start cuando corresponda.
  • docker exec falla mientras está pausado: es el comportamiento esperado. Ejecuta docker unpause antes de iniciar un comando dentro del contenedor.
  • La aplicación no responde: revisa si quedó pausada y reanúdala; no la borres ni la reinicies antes de identificar el estado.
  • Se espera que pause cierre conexiones o guarde datos: no envía la señal de apagado de stop. Para un cierre controlado, reanuda y usa docker stop.
  • Se deja pausado durante mucho tiempo: los procesos no avanzan y la aplicación puede perder conexiones o mantener recursos ocupados. Evalúa si realmente necesitas conservar esa instancia.

Lecciones relacionadas del curso Docker

Documentación oficial y recursos

Pausar congela temporalmente los procesos; detener permite cerrarlos. Comprueba el estado, elige la operación según su efecto y reanuda el contenedor cuando termine la pausa.

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 *