¿Cómo evitar que los registros de Docker llenen el disco de arranque del host?

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.

Detén el proceso que genera los registros de inmediato, identifica el destino de registro activo, configura la rotación con límites y corrige el error o el ciclo de reinicios que genera la avalancha.

En un NAS o servidor doméstico basado en Docker, la unidad de arranque puede llenarse aunque los archivos multimedia y las bases de datos estén en otro conjunto de almacenamiento, ya que la salida estándar y de error de los contenedores, los datos del diario de systemd y los archivos propios de las aplicaciones pueden seguir guardándose en el sistema de archivos del sistema. El procedimiento seguro consiste en conservar suficientes pruebas recientes, detener el crecimiento descontrolado, determinar qué capa de registro ocupa el espacio, configurar la retención para los servicios existentes y futuros, y comprobar que la aplicación subyacente ya no genera el mismo volumen de registros.

Localiza el almacén de registros que realmente está creciendo

Comprueba el espacio libre en el sistema de archivos de arranque y compara el tamaño de la raíz de datos de Docker, los archivos de registro de cada contenedor, el diario del sistema y los directorios de registros de aplicaciones montados desde el host. Anota las rutas más grandes antes de borrar o truncar nada.

Un caso de falta de espacio en disco en Docker reveló que los resúmenes habituales de Docker no mostraban el principal consumidor porque el archivo de registro predeterminado crecía por separado. La prueba decisiva fue un registro de contenedor en constante crecimiento en la ruta de almacenamiento local de Docker.

Inspecciona el controlador de registros configurado y la ruta de registro de cada contenedor en ejecución; después, identifica el archivo más grande y relaciónalo con el nombre del contenedor y los mensajes recientes. Si ningún registro de contenedor explica el uso del espacio, revisa journald y las carpetas propias de las aplicaciones en lugar de suponer que todos los problemas de espacio en disco relacionados con Docker corresponden a json-file.

Detén el contenedor que genera más registros antes de la limpieza de emergencia

Cuando la unidad de arranque está casi llena, pausa o detén el contenedor que esté generando registros con mayor rapidez. Guarda el tramo final del registro con un límite, el número de reinicios, el estado de salida, la versión de la imagen, el entorno, los montajes y el primer error que se repite antes de liberar espacio.

Los administradores suelen descubrir que los registros JSON de los contenedores pueden consumir el espacio restante en el disco cuando no hay configurado un límite de tamaño. Un largo debate en Stack Overflow identifica el crecimiento ilimitado de los registros JSON como un riesgo de capacidad independiente de los datos de imágenes y volúmenes.

No elimines a ciegas un archivo de registro activo mientras Docker aún lo tiene abierto, ni elimines directorios arbitrarios del árbol de metadatos de Docker. Usa el procedimiento de rotación o truncamiento admitido por la plataforma solo después de detener el proceso que genera los registros; luego, confirma que los bloques liberados son visibles antes de reiniciar cualquier servicio afectado.

Aplica una rotación con límites definidos a cada servicio de larga duración

Establece explícitamente un controlador de registro y límites de rotación definidos en el servicio de Compose o en la configuración del contenedor. Para el controlador JSON, que es el más común, los controles importantes son un tamaño máximo de archivo y un número limitado de archivos conservados.

Un hilo de rotación de la comunidad de Docker explica que opciones como max-size y max-file limitan cuánto historial local conserva cada contenedor. El requisito operativo es una política de rotación con límites definidos, no un archivo que crezca indefinidamente.

Elige los límites según la rapidez con la que debas diagnosticar un incidente y el espacio del disco de arranque que el host pueda reservar de forma segura. Recrea el servicio para que el contenedor en ejecución reciba la nueva configuración de registro; después, inspecciona su configuración efectiva y realiza una pequeña prueba controlada para comprobar que los archivos rotan como se espera.

Establece valores predeterminados para los contenedores futuros sin suponer que cambiarán los existentes

Configura un valor predeterminado a nivel del daemon o de la plataforma para los contenedores nuevos, de modo que la ausencia de una opción en un servicio no restablezca silenciosamente el registro local ilimitado. Puedes permitir que los servicios críticos usen una configuración más específica cuando sus necesidades de diagnóstico sean diferentes.

Cambiar el valor predeterminado de registro de Docker no reescribe retroactivamente la configuración del host de todos los contenedores existentes. Las mismas recomendaciones de la comunidad distinguen los valores predeterminados del daemon de la configuración de creación de cada contenedor, por lo que los servicios antiguos deben inspeccionarse y recrearse deliberadamente.

Implementa primero el cambio en un servicio no crítico. Confirma que la recuperación de registros, la supervisión, las alertas y los flujos de trabajo de soporte sigan funcionando; luego vuelve a crear los servicios restantes en lotes controlados, sin eliminar sus volúmenes persistentes.

Corrige el evento que provoca la avalancha de registros

La rotación limita los daños, pero no soluciona un contenedor que se reinicia cada pocos segundos, vuelve a intentar conectarse a una base de datos inaccesible, registra cada comprobación de estado, recibe un ataque o una avalancha de solicitudes, o se dejó en modo de depuración tras la resolución de problemas.

Un usuario de Docker atribuyó un archivo JSON de aproximadamente 80 GB al exceso de salida de depuración, lo que ilustra cómo la salida de nivel de depuración puede saturar un disco de arranque incluso cuando la rotación es la medida de protección inmediata.

Agrupa los mensajes repetidos por frecuencia y hora de la primera aparición; luego corrige el error raíz más temprano. La guía de ZimaSpace para encontrar una dependencia que provoca un bucle de reinicios es el siguiente paso de diagnóstico cuando los fallos de conexión, montaje, secretos o preparación generan una avalancha de registros.

Controla por separado los registros de Docker, Journald y las aplicaciones

Un contenedor puede enviar la salida estándar a Docker y, al mismo tiempo, escribir sus propios archivos en un montaje enlazado, y el propio servicio de Docker puede enviar eventos del demonio a journald. Cada destino tiene un responsable distinto de la retención y puede llenar el mismo sistema de archivos de arranque de forma independiente.

Los operadores de servidores domésticos han informado que los directorios de registros de las aplicaciones siguen creciendo, pese a esperar que la rotación a nivel de Docker los mantuviera bajo control. Un caso de la comunidad de TrueNAS destaca la necesidad de identificar qué capa de registro controla la retención antes de ajustar los límites.

Registra una línea base posterior a la reparación del uso del disco de arranque, los archivos de registro más grandes, el tamaño del diario, los recuentos de reinicios de contenedores y el crecimiento diario. La reparación solo estará completa cuando cada destino activo tenga una política con límites, el servicio ruidoso se mantenga estable con su carga de trabajo normal y un reinicio deliberado no vuelva a crear archivos ilimitados.

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.