Cómo configurar políticas de reinicio en Docker

como-configurar-politicas-de-reinicio-en-docker
como-configurar-politicas-de-reinicio-en-docker

Saber cómo configurar políticas de reinicio en Docker te ayuda a decidir qué debe pasar cuando un contenedor se detiene: quedarse apagado, reiniciarse si falla o volver a arrancar después de reiniciar el daemon.

Una política de reinicio no arregla una aplicación rota. Sirve para controlar el comportamiento del contenedor ante fallos, reinicios del host o salidas inesperadas. Si se usa mal, puede ocultar errores reales en un bucle infinito.

En esta lección vas a aprender cómo configurar políticas de reinicio en Docker, qué diferencias hay entre no, on-failure, always y unless-stopped, y cómo verificar la política aplicada.

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

Configurar políticas de reinicio en Docker

La forma directa de configurar una política al crear un contenedor es usar la opción –restart. Esta opción define cómo debe reaccionar Docker si el contenedor termina. Por eso, cómo configurar políticas de reinicio en Docker debe entenderse como una decisión operativa, no solo como una opción de la CLI.

docker run -d --name web --restart unless-stopped nginx:alpine

En este ejemplo, el contenedor se ejecuta en segundo plano y Docker intentará mantenerlo disponible salvo que tú lo detengas explícitamente.

PolíticaQué haceCuándo usarla
noNo reinicia el contenedor automáticamente.Tareas puntuales o pruebas manuales.
on-failureReinicia solo si el proceso termina con error.Servicios donde una salida correcta debe respetarse.
alwaysIntenta reiniciar siempre que el contenedor se detenga.Servicios que deben volver incluso tras reiniciar Docker.
unless-stoppedReinicia salvo que lo hayas detenido manualmente.Opción habitual para servicios persistentes.

Usar on-failure con límite de intentos

Cuando una aplicación puede fallar al arrancar, on-failure permite reiniciarla solo si el proceso termina con error. También puedes limitar el número de intentos para evitar bucles interminables.

docker run -d --name worker --restart on-failure:3 alpine:3.20 sh -c "exit 1"

Este ejemplo es de laboratorio: el comando termina con error y Docker intentará reiniciarlo hasta el límite indicado. En un servicio real, revisa logs antes de aumentar intentos.

Diferencia entre always y unless-stopped

always intenta devolver el contenedor a ejecución incluso después de reiniciar el daemon. unless-stopped se parece, pero respeta mejor la intención del administrador cuando el contenedor fue detenido manualmente.

docker run -d --name servicio-always --restart always nginx:alpine
docker run -d --name servicio-unless --restart unless-stopped nginx:alpine

Para muchos laboratorios y servicios persistentes, unless-stopped suele ser más cómodo porque evita que un contenedor detenido a propósito vuelva inesperadamente tras reiniciar Docker.

Cambiar la política de un contenedor existente

Si el contenedor ya existe, no siempre necesitas recrearlo. Puedes actualizar la política con docker update y verificarla después con docker inspect.

docker update --restart unless-stopped nombre_contenedor
docker inspect nombre_contenedor --format "RestartPolicy={{.HostConfig.RestartPolicy.Name}} MaximumRetryCount={{.HostConfig.RestartPolicy.MaximumRetryCount}}"

Este cambio afecta al comportamiento futuro. No soluciona por sí solo la causa del fallo; solo define qué hará Docker si el contenedor vuelve a detenerse.

Políticas de reinicio con Docker Compose

En proyectos Compose, declara la política en el archivo del servicio. Así el comportamiento queda versionado junto con el resto de la configuración.

services:
  web:
    image: nginx:alpine
    restart: unless-stopped

Evita configurar la política a mano si el servicio se gestiona con Compose, porque el próximo despliegue puede sobrescribir o contradecir el cambio manual.

Verificar reinicios y diagnosticar bucles

Una política de reinicio puede convertir un fallo en un bucle rápido. Por eso debes revisar estado, contador de reinicios y logs cuando un servicio no se mantiene estable.

docker ps -a
docker inspect nombre_contenedor --format "Status={{.State.Status}} Restarting={{.State.Restarting}} RestartCount={{.RestartCount}}"
docker logs --tail 100 nombre_contenedor

Si RestartCount sube continuamente, no lo tapes aumentando la política de reinicio. Primero investiga por qué el proceso principal termina.

Errores comunes con políticas de reinicio

El error más peligroso es usar always para ocultar una aplicación que falla. El contenedor parecerá intentar recuperarse, pero los logs mostrarán el mismo error una y otra vez.

Otro error es aplicar una política de reinicio a trabajos que deben terminar. Si un contenedor ejecuta una tarea puntual y termina correctamente, quizá no debe reiniciarse.

También conviene distinguir reiniciar un contenedor de resolver la causa. Si el problema es una variable ausente, permisos incorrectos o una base de datos inaccesible, la política solo repetirá el fallo.

Lecciones relacionadas del curso Docker

Documentación oficial y recursos

En resumen, cómo configurar políticas de reinicio en Docker consiste en elegir un comportamiento acorde al tipo de servicio. Un demonio persistente no necesita la misma política que una tarea puntual.

Usa la política como mecanismo de recuperación, no como sustituto del diagnóstico. Si un contenedor entra en bucle, revisa logs, estado y configuración antes de declarar que el problema está solucionado.

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 *