Cómo reiniciar contenedores Docker

como-reiniciar-contenedores-docker
como-reiniciar-contenedores-docker

Para reiniciar contenedores Docker con seguridad, ejecuta docker restart sobre el nombre o ID del objeto. Docker detiene el proceso con la señal configurada, espera a que cierre y vuelve a iniciar el mismo contenedor. Aquí verás cómo comprobar el resultado y cuándo investigar el fallo en lugar de repetir el reinicio.

Un reinicio manual sirve para recuperar temporalmente un proceso o aplicar un apagado y arranque controlados. No repara la causa de un fallo recurrente ni actualiza la imagen o la configuración del contenedor.

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

Reiniciar contenedores Docker: qué hace docker restart

Al reiniciar contenedores Docker con docker restart, el motor detiene y vuelve a iniciar el mismo objeto con su configuración actual. Durante la parada envía la señal configurada; si el proceso no termina dentro del tiempo de espera, Docker lo fuerza y lo arranca de nuevo. La capa escribible y los montajes siguen asociados porque el contenedor no se elimina.

docker run -d --name restart-demo nginx:alpine
docker restart restart-demo
docker logs --tail 20 restart-demo
docker inspect restart-demo --format '{{.State.Status}} {{.RestartCount}}'
docker rm -f restart-demo

Qué comprobar al reiniciar contenedores Docker

El comando devuelve el nombre del contenedor si la operación se completa, pero eso no demuestra que la aplicación esté sana. Comprueba que el estado sea running, revisa las últimas líneas del registro y, si la imagen define un HEALTHCHECK, observa también su estado de salud. Un proceso puede seguir activo aunque el servicio que ofrece no responda.

En el ejemplo, docker logs muestra la salida reciente del proceso y docker inspect permite consultar el estado y el número de reinicios registrados. Si los registros muestran el mismo error tras cada arranque, deja de reiniciar en bucle y diagnostica la configuración, las dependencias o los recursos.

Reiniciar contenedores Docker manualmente o con una política automática

docker restart es una acción manual puntual: detiene y vuelve a iniciar un contenedor que eliges. Una política de reinicio como unless-stopped o on-failure define cuándo el daemon debe intentar iniciarlo automáticamente después de una salida. La política no corrige fallos de la aplicación; si el proceso falla repetidamente, busca la causa en los logs y en la configuración.

SituaciónQué hacerPor qué
Fallo puntualReiniciar y comprobar estado, salud y logs.Ver si el servicio se recupera y si el problema vuelve.
Fallos repetidosRevisar logs, configuración y recursos antes de otro reinicio.La política automática puede repetir el fallo indefinidamente.
Cambios en la imagen o configuraciónRecrear el contenedor con los parámetros nuevos.Restart reutiliza el objeto y no aplica esos cambios.
Servicio en producciónPlanificar la operación y revisar el impacto.Las conexiones activas pueden interrumpirse.

Controlar la señal y el tiempo de espera

El reinicio usa por defecto la señal de parada definida en la imagen, o SIGTERM si no hay otra señal configurada. Docker espera un tiempo antes de forzar la parada con SIGKILL; puedes ajustar el comportamiento cuando la aplicación necesita más o menos tiempo para cerrar.

  • Usa –timeout para definir los segundos de espera en esta operación.
  • Usa –signal solo cuando conozcas la señal que la aplicación necesita recibir.
  • En Linux, el valor predeterminado general es 10 segundos; el contenedor puede tener otro tiempo configurado.
  • Si el proceso no termina al vencer el plazo, Docker lo fuerza con SIGKILL y lo arranca de nuevo.

Errores comunes

  • Reiniciar varias veces sin consultar los logs; el ciclo puede ocultar un fallo que se repite.
  • Esperar que restart aplique cambios de imagen, puertos, montajes o variables: para cambiar la configuración hay que recrear el contenedor.
  • Confundir el comando manual con una política automática de reinicio.
  • Reiniciar en producción sin comprobar el impacto sobre conexiones y usuarios activos.
  • Tomar el estado running como prueba de que la aplicación funciona; revisa también su respuesta o HEALTHCHECK.

Lecciones relacionadas del curso

Documentación oficial y recursos

Usa el reinicio como una operación de recuperación controlada, no como sustituto del diagnóstico. Si el problema vuelve después de cada arranque, conserva los logs y revisa la causa antes de repetir la acción.

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 *