¿Por qué falla la comprobación de estado de un contenedor si la aplicación sigue abriéndose?

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.

Un contenedor puede seguir siendo utilizable aunque falle su control de estado, porque la sonda comprueba un comando, una dirección, un usuario o una condición de disponibilidad distintos de los de la ruta que usa el navegador.

En un servidor doméstico, la aplicación puede abrirse a través de un proxy inverso aunque Docker ejecute el comando de comprobación de estado dentro del contenedor contra localhost, una utilidad inexistente, el puerto equivocado o una dependencia que no está disponible temporalmente. Empieza por reproducir la sonda exacta dentro del contenedor y luego compara su destino y el resultado esperado con la ruta real del usuario antes de aumentar los reintentos o desactivar el control de estado.

Compara lo que comprueba el navegador con lo que comprueba el control de estado

Anota la URL y la ruta de red que permiten abrir la aplicación correctamente. Indica si el navegador llega a un proxy inverso, a un puerto publicado del host, a una IP local o directamente al contenedor.

Docker ejecuta la sonda configurada dentro del contenedor, por lo que puede comprobar un endpoint distinto al del navegador. Un caso de la comunidad de Docker mostró que una comprobación de estado fallaba porque la imagen no incluía el comando curl que usaba la sonda, aunque el proceso del servicio pudiera seguir ejecutándose.

Si la ruta que funciona en el navegador pasa por otro proxy o puerto, no tomes ese resultado como prueba de que el destino interno de la sonda sea correcto. Anota ambas rutas e identifica el primer componente que difiere.

Ejecuta el comando exacto de comprobación de estado dentro del contenedor

Copia exactamente el comando de comprobación de estado, incluida su forma de shell, la URL, las opciones, las credenciales y las variables de entorno. Ejecútalo dentro del contenedor en ejecución con el mismo usuario y captura el código de salida y el resultado.

Un contenedor marcado como no saludable puede seguir teniendo un proceso en ejecución, porque el estado de salud refleja el resultado de la sonda, no si los usuarios pueden cargar una página. El flujo de diagnóstico de Netdata distingue entre el fallo de la sonda y el fallo del proceso antes de cambiar el comportamiento de reinicio.

Si el comando se ejecuta correctamente de forma manual, compara el usuario de ejecución, el shell, el directorio de trabajo, el entorno y los tiempos usados por la comprobación automática. Si falla de forma manual, el error permite identificar la siguiente capa sin esperar a otro intervalo de comprobación de estado.

Comprueba la herramienta de la sonda, el shell, PATH y el usuario

Confirma que cada ejecutable del comando de comprobación de estado exista en la imagen actual y que el usuario del contenedor pueda ejecutarlo. Las imágenes mínimas pueden no incluir curl, wget, bash, herramientas de DNS o almacenes de certificados.

Las sondas en formato shell y en formato exec se comportan de manera diferente. Las comillas, las tuberías, la expansión de variables y los comandos compuestos requieren que haya un shell disponible, mientras que un comando directo necesita la ruta completa del ejecutable cuando el entorno de la comprobación de estado tiene un PATH limitado.

Ejecuta el comando con una ruta absoluta y el usuario de servicio previsto. Corrige la imagen o la comprobación en lugar de instalar herramientas de forma interactiva, porque cualquier cambio manual en el contenedor desaparecerá en la siguiente reconstrucción.

Verifica la dirección interna, el puerto y el protocolo

Inspecciona el servicio de escucha de la aplicación dentro del contenedor y compáralo con la URL de la comprobación. Un puerto publicado en el host, como 8080:80, no significa que el servicio escuche en el puerto 8080 dentro del contenedor.

Las comprobaciones de estado deben evaluar el estado de la aplicación que controla el contenedor. La guía práctica de Dash0 señala que una comprobación puede consultar un endpoint HTTP o inspeccionar un proceso, pero el endpoint debe reflejar el estado real de disponibilidad del contenedor, no una ruta disponible únicamente a través de un proxy externo.

Prueba 127.0.0.1, la dirección de escucha del contenedor y el nombre del servicio solo cuando corresponda. Si la aplicación solo se vincula a un socket Unix u otra interfaz, cambia la comprobación para que use el punto de entrada interno real.

Distingue el inicio lento de un fallo permanente

Mide cuánto tarda la aplicación, la migración de la base de datos, el calentamiento de la caché o la carga del modelo en responder en el endpoint correcto. Compara ese tiempo con start_period, interval, timeout y retries.

Compose puede bloquear los servicios dependientes cuando una dependencia sigue marcada como no saludable, aunque más tarde esté lista. Una regresión notificada de Compose mostró que un servicio pasaba a estar saludable solo después de que el fallo de la dependencia ya hubiera detenido la pila, lo que puso de manifiesto una ventana de inicio de la comprobación de estado demasiado corta.

Aumenta los tiempos solo cuando los registros demuestren que la aplicación avanza con normalidad. Más reintentos no deben ocultar un puerto incorrecto, una migración fallida, un certificado ausente o una base de datos inaccesible.

Mantén la comprobación acotada y verifica la recuperación

Decide si la comprobación de estado debe representar la actividad del proceso, la disponibilidad local de la aplicación o una cadena de dependencias más profunda. No marques un contenedor local como no saludable solo porque una API externa opcional no esté disponible.

La guía de ZimaSpace para encontrar la primera dependencia que falla es el siguiente paso cuando la aplicación no puede estar lista sin una base de datos, una caché o un servicio de red.

El problema se resuelve cuando la comprobación automática exacta se ejecuta correctamente tras el inicio normal, el contenedor se mantiene en buen estado durante los reinicios de las dependencias y el flujo de trabajo real de la aplicación sigue disponible. Mantén la comprobación lo bastante estricta para detectar un servicio averiado, pero lo bastante acotada para evitar falsos fallos causados por sistemas ajenos.

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.