¿Por qué un contenedor en ejecución mantiene su antiguo límite de memoria después de cambiar el archivo Compose?

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 en ejecución conserva su antiguo límite de memoria cuando la configuración de Compose editada nunca se aplicó al cgroup activo de ese contenedor.

Cambiar el archivo YAML no modifica por sí solo un contenedor existente, y un reinicio normal inicia el mismo contenedor con la configuración que tenía al crearse. La confusión también puede deberse a comparar un límite estricto de memoria con una reserva, una asignación de intercambio, el ámbito principal de systemd o la configuración del heap de la aplicación. Antes de concluir que Docker ignoró el cambio, diagnostica el valor efectivo del cgroup y el ID del contenedor.

Lee el límite del cgroup activo en lugar de confiar en el archivo YAML

Registra el ID del contenedor, la hora de creación, el resultado de la inspección de Docker, la versión de cgroup y los archivos de control de memoria utilizados por el proceso en ejecución.

El kernel de Linux define memory.max como el límite estricto del cgroup, mientras que memory.high aplica presión de recuperación de memoria sin actuar como el mismo límite absoluto.

Si el cgroup activo sigue teniendo el valor anterior, la configuración no se aplicó. Si tiene el nuevo valor, pero la monitorización indica otra cosa, comprueba las unidades, la contabilización de la caché, el intercambio y las métricas de la aplicación.

Distingue entre reiniciar y volver a crear el contenedor

Compara el ID del contenedor antes y después del comando usado para implementar el cambio. Registra si el comando fue restart, up, create, una acción de la interfaz de usuario del NAS o una actualización directa de Docker.

Docker indica que Compose restart no aplica cambios de configuración, ya que reinicia los contenedores de servicio existentes.

Usa una actualización controlada de Compose que vuelva a crear el servicio, o una actualización de recursos en vivo compatible, cuando corresponda. Conserva el resultado de la inspección anterior para poder verificar el cambio del campo.

Valida el modelo final de Compose y el campo de memoria

Genera la configuración efectiva de Compose después de aplicar todos los archivos, perfiles y sustituciones de variables de entorno. Comprueba si el límite corresponde al servicio activo.

La especificación de Compose define mem_limit como un límite de memoria del servicio y exige coherencia cuando también se declaran límites equivalentes de deploy.

Un valor en un archivo de anulación que no se usa, un perfil inactivo, un nombre de servicio mal escrito o una interfaz de usuario de Stack diferente no modifica el modelo implementado. Compara la configuración generada con la inspección de Docker.

Distingue entre límite estricto, reserva e intercambio

Registra el límite estricto de memoria, la reserva o el límite flexible, el límite de intercambio, el uso actual, el uso máximo y los eventos OOM. No consideres todos los valores relacionados con la memoria como un único límite.

La documentación de control de recursos de systemd distingue MemoryHigh de MemoryMax y muestra que los cgroups principales pueden imponer límites adicionales a los servicios y contenedores.

Un contenedor puede parecer que supera una reserva porque una reserva no equivale a un límite estricto. También puede consumir memoria de intercambio o caché de páginas que algunos paneles excluyen o muestran por separado.

Comprueba si el montón del entorno de ejecución tiene su propio límite

Para las aplicaciones Java, registra la detección de contenedores de la JVM, el tamaño máximo del montón, la memoria directa, los metadatos de clase, las pilas de subprocesos y las opciones que proporciona la imagen o la configuración de la aplicación.

Oracle documenta que la JVM dimensiona su montón a partir de las restricciones de memoria disponibles y permite que MaxRAMPercentage establezca la fracción del montón.

Cambiar el límite del contenedor puede no producir el montón esperado de la aplicación si sigue vigente un valor explícito de -Xmx o un porcentaje. Además, la memoria del montón no equivale al uso total de memoria del proceso.

Comprueba los límites de Node.js y de otras aplicaciones

Inspecciona los indicadores del entorno de ejecución, las variables de entorno, el número de procesos de trabajo, las cachés y los objetivos de memoria internos. Compáralos con el límite del sistema operativo.

Node.js documenta max-old-space-size como un límite del montón de V8, que puede permanecer sin cambios aunque el contenedor reciba una asignación cgroup mayor o menor.

Un límite de contenedor protege el host; no ajusta automáticamente todas las aplicaciones. Configura el entorno de ejecución por debajo del límite del contenedor, dejando margen para las asignaciones nativas y la caché del sistema de archivos.

Aplica un solo cambio y verifica con una carga controlada

Renderiza el modelo final de Compose, vuelve a crear solo el servicio afectado, confirma el nuevo ID del contenedor y el cgroup activo, y luego ejecuta una carga de trabajo acotada mientras observas el uso y los eventos de falta de memoria.

El artículo de ZimaSpace Tech & AI Hub explica qué ocurre cuando un contenedor alcanza su límite activo; este artículo se centra en demostrar que el límite modificado se implementó realmente.

El problema se resuelve cuando la configuración renderizada, la inspección del contenedor, los archivos de cgroup, el montón del entorno de ejecución y el límite de fallo observado coinciden con la política prevista después de reiniciar.

Preguntas frecuentes

¿Reiniciar un contenedor aplica un cambio en el límite de memoria de Compose?

No. Normalmente, un reinicio usa la misma configuración existente del contenedor. Vuelve a crear el servicio o utiliza una actualización en vivo compatible.

¿Puede un contenedor superar temporalmente su límite estricto de memoria?

La contabilidad del kernel y la recuperación de memoria pueden mostrar brevemente valores cercanos o ligeramente superiores a un límite, pero un uso sostenido e irrecuperable en el límite estricto provoca que cgroup gestione la falta de memoria.

¿Por qué la aplicación sigue informando del tamaño de montón anterior?

El tiempo de ejecución de la aplicación puede tener una opción explícita para el montón o calcular un porcentaje solo al iniciarse. Vuelve a crearla o reiníciala después de validar el límite del contenedor.

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.