Cómo adaptar las políticas de reinicio de Docker a bases de datos, procesos de trabajo y aplicaciones web

Eva Wong es la redactora técnica y manitas residente en ZimaSpace. Es una geek de toda la vida apasionada por los laboratorios domésticos y el software de código abierto, y se especializa en traducir conceptos técnicos complejos en guías prácticas y fáciles de seguir. Eva cree que alojar servicios propios debería ser divertido, no intimidante. A través de sus tutoriales, ayuda a la comunidad a desmitificar la configuración del hardware, desde montar su primer NAS hasta dominar los contenedores Docker.

Adapta las políticas de reinicio de Docker al ciclo de vida y a la semántica de salida de cada servicio, en vez de asignar unless-stopped a todos los contenedores de un archivo Compose.

Las políticas de reinicio reaccionan cuando termina el proceso principal de un contenedor; una comprobación de estado puede marcar como no saludable un proceso que sigue ejecutándose sin reiniciarlo automáticamente. Por tanto, las bases de datos, los trabajadores, las aplicaciones web, las migraciones y las tareas programadas necesitan distintas opciones, según si deben permanecer activos, qué significa una salida normal y cómo debe notificarse un fallo repetido.

Separa el comportamiento de reinicio del estado de salud y de la preparación

Una política de reinicio determina si Docker debe volver a iniciar un contenedor cuando se detiene su proceso. Una comprobación de estado determina si el servicio en ejecución puede realizar una operación definida. La preparación de las dependencias determina si otro servicio debe iniciarse ya. Resuelven problemas relacionados, pero distintos.

Un artículo de 2026 sobre la separación entre salud y reinicio explica esta distinción y muestra cómo las condiciones de salud de Compose pueden retrasar el inicio de los servicios dependientes hasta que un servicio esté realmente listo.

No esperes que restart: always repare un proceso web en mal estado que nunca termina, ni que una comprobación de estado por sí sola lo reinicie. Haz que la aplicación termine cuando no sea seguro continuar, añade un mecanismo externo de corrección o configura alertas para el estado no saludable según el diseño del servicio.

Usa políticas de reinicio persistentes para bases de datos de larga duración

Normalmente, se espera que una base de datos de un servidor doméstico vuelva a iniciarse tras reiniciar el host o el daemon de Docker. unless-stopped suele ser una opción predeterminada práctica si se debe respetar la detención intencional por parte de un administrador; always es adecuada cuando, por diseño, el reinicio del sistema debe anular ese estado de detención manual.

Un artículo de julio de 2026 sobre las políticas de reinicio según la salida del proceso detalla las diferencias entre no, on-failure, always y unless-stopped, incluido el hecho de que la política reacciona a la salida del proceso, no al estado de salud.

La base de datos también necesita una comprobación de estado real y almacenamiento persistente. Reiniciar PostgreSQL repetidamente no puede solucionar un disco lleno, una configuración no válida, un estado dañado o una migración incompatible. Configura alertas ante reinicios repetidos en vez de considerarlos una resiliencia eficaz.

Elige la política del trabajador según la cola y la semántica de salida

Puede ser conveniente usar unless-stopped para un trabajador de cola de larga duración que deba estar siempre procesando tareas. Un trabajador de duración limitada o un proceso por lotes puede usar on-failure:N para que los errores transitorios reciban reintentos limitados, mientras que un fallo persistente se detenga y quede visible.

Una guía actual sobre reintentos limitados ante fallos destaca que el comportamiento de los reintentos debe corresponderse con que se espere que un proceso permanezca activo indefinidamente o que pueda finalizar con normalidad.

Averigua qué significa el código de salida 0 para la imagen del proceso en segundo plano. Si significa «trabajo completado», always puede convertir un trabajo puntual completado en un ciclo infinito. Si el proceso está pensado para ejecutarse como daemon, una salida limpia e inesperada aún puede justificar el reinicio automático mediante unless-stopped.

Mantén las aplicaciones web en ejecución durante largos periodos, pero condiciona su inicio a que las dependencias estén realmente listas

La mayoría de las aplicaciones web autoalojadas están pensadas para permanecer disponibles de forma continua, por lo que unless-stopped suele ser más fácil de entender que una política limitada que solo actúa ante fallos. La configuración de reinicio no elimina la necesidad de que la base de datos, la caché, el DNS, los secretos y las rutas montadas estén listos.

El diagnóstico relacionado de ZimaSpace sobre los ciclos de reinicio de contenedores causados por dependencias explica por qué reiniciar repetidamente la aplicación visible puede ocultar el fallo previo de la base de datos, la caché, el montaje, la migración o la memoria.

Usa comprobaciones del estado de las dependencias para ordenar el inicio cuando corresponda y limita los reintentos de la aplicación. Un servicio web que se bloquea cada cinco segundos hasta que se inicia PostgreSQL es menos fácil de supervisar que uno que espera a que esté listo y se inicia correctamente una sola vez.

Dota a las migraciones y los trabajos de una sola ejecución de un ciclo de vida finito

Los contenedores de migración, los importadores, las tareas de mantenimiento y los trabajos de inicialización puntuales no son procesos en segundo plano ordinarios. Su estado de éxito suele ser «salir con el código 0 y permanecer detenidos». Usar always o unless-stopped puede volver a ejecutar involuntariamente un trabajo ya completado.

Mantén explícitas las herramientas operativas de una sola ejecución, en lugar de permitir que se conviertan en servicios ocultos siempre activos. Una migración o un importador debería tener un estado de éxito finito que siga siendo visible tras la salida del comando.

Usa restart: "no" cuando el fallo deba detener el proceso para inspeccionarlo, o un on-failure limitado solo cuando sea seguro volver a ejecutar el comando. En el caso de las migraciones de esquemas, comprueba que se pueda repetir una migración aplicada parcialmente antes de automatizar los reintentos.

Prueba la política con modos de fallo reales

Para cada servicio, prueba una salida limpia del proceso, un fallo con código distinto de cero, un reinicio del host, un reinicio del daemon de Docker, una parada manual, una condición en la que no esté saludable pero siga en ejecución y una dependencia no disponible. Anota el estado esperado tras cada evento antes de considerar que la configuración es resiliente.

Registra el número de reinicios y genera una alerta cuando supere un umbral bajo dentro de un intervalo de tiempo. El reinicio automático debería reducir el tiempo de recuperación ante fallos transitorios; no debería ocultar un fallo persistente creando sin parar nuevos contenedores.

Una buena matriz de políticas es explícita: las bases de datos y las aplicaciones web de larga duración vuelven a iniciarse tras los reinicios de la infraestructura, los procesos en segundo plano se recuperan según la semántica de las colas, los trabajos finitos se detienen al completarse y las comprobaciones de estado y disponibilidad detectan fallos que la política de reinicio no puede detectar.

Soporte y consejos

Más para leer

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.