Un container in esecuzione mantiene il vecchio limite di memoria quando la configurazione Compose modificata non è mai stata applicata al cgroup attivo del container.
Modificare lo YAML non modifica di per sé un container esistente e un normale riavvio avvia lo stesso container con la stessa configurazione impostata al momento della creazione. La confusione deriva anche dal confronto tra un limite rigido di memoria e una riserva, la disponibilità di swap, l'ambito systemd padre o l'impostazione dell'heap dell'applicazione. Prima di concludere che Docker abbia ignorato la modifica, verifica il valore effettivo del cgroup e l'ID del container.
Leggi il limite del cgroup attivo anziché fidarti dello YAML
Registra l'ID del container, l'ora di creazione, l'output dell'ispezione di Docker, la versione di cgroup e i file di controllo della memoria usati dal processo in esecuzione.
Il kernel Linux definisce memory.max come limite rigido del cgroup, mentre memory.high applica una pressione di recupero della memoria senza fungere da limite massimo assoluto equivalente.
Se il cgroup attivo contiene ancora il valore precedente, la configurazione non è stata applicata. Se contiene il nuovo valore ma il monitoraggio indica altro, controlla le unità, il conteggio della cache, lo swap e le metriche a livello di applicazione.
Distingui tra riavvio e ricreazione del container
Confronta l'ID del container prima e dopo il comando usato per distribuire la modifica. Registra se il comando era restart, up, create, un'azione dall'interfaccia NAS o un aggiornamento diretto di Docker.
Docker dichiara che Compose restart non applica le modifiche alla configurazione, perché riavvia i container di servizio esistenti.
Usa un aggiornamento Compose controllato che ricrei il servizio oppure, se appropriato, un aggiornamento delle risorse live supportato. Conserva il precedente output dell'ispezione per poter verificare il campo modificato.
Convalida il modello Compose finale e il campo della memoria
Renderizza la configurazione Compose effettiva dopo aver applicato tutti i file, i profili e le sostituzioni delle variabili d'ambiente. Verifica che il limite appartenga al servizio attivo.
La specifica di Compose definisce mem_limit come limite di memoria di un servizio e richiede coerenza quando sono dichiarati anche limiti equivalenti in deploy.
Un valore in un file di override inutilizzato, un profilo inattivo, un servizio con nome errato o un'interfaccia utente diversa di Stack non modifica il modello distribuito. Confronta la configurazione renderizzata con l'ispezione di Docker.
Distingui tra limite rigido, riserva e swap
Registra il limite rigido di memoria, la riserva o il limite flessibile, il limite di swap, l'utilizzo attuale, l'utilizzo massimo e gli eventi OOM. Non considerare ogni valore relativo alla memoria come un unico limite massimo.
La documentazione sul controllo delle risorse di Systemd distingue tra MemoryHigh e MemoryMax e mostra che i cgroup padre possono imporre limiti aggiuntivi a servizi e container.
Un container può sembrare superare una prenotazione perché una prenotazione non equivale a un limite massimo. Può inoltre usare lo swap o la page cache, che alcuni pannelli di monitoraggio escludono o riportano separatamente.
Verifica se l'heap del runtime ha un proprio limite
Per le applicazioni Java, registra il rilevamento dei container da parte della JVM, l'heap massimo, la memoria diretta, il metaspace, gli stack dei thread e i flag passati dall'immagine o dalla configurazione dell'app.
Oracle spiega che la JVM dimensiona l'heap in base ai vincoli di memoria disponibili e permette di usare MaxRAMPercentage per impostare la frazione dell'heap.
Modificare il limite del container potrebbe non produrre l'heap previsto dall'applicazione se è ancora impostato un valore esplicito per -Xmx o una percentuale. Inoltre, la memoria dell'heap non corrisponde all'utilizzo totale di memoria del processo.
Verifica Node.js e gli altri limiti a livello di applicazione
Esamina i flag del runtime, le variabili d'ambiente, il numero di worker, le cache e i limiti interni di memoria. Confrontali con il limite del sistema operativo.
La documentazione di Node.js definisce max-old-space-size come limite dell'heap V8, che può rimanere invariato anche dopo che al container viene assegnato un limite cgroup maggiore o minore.
Un limite del container protegge l'host, ma non regola automaticamente ogni applicazione. Imposta il runtime al di sotto del limite del container, lasciando margine per le allocazioni native e la cache del filesystem.
Applica una modifica alla volta e verifica con un carico controllato
Genera il modello Compose finale, ricrea solo il servizio interessato, conferma il nuovo ID del container e il cgroup attivo, quindi esegui un carico di lavoro controllato monitorando l'utilizzo e gli eventi OOM.
L'articolo dell'hub Tech & AI di ZimaSpace spiega cosa succede quando un container raggiunge il limite attivo; questo articolo si concentra sulla verifica dell'effettiva applicazione di un limite modificato.
Il problema è risolto quando, dopo il riavvio, la configurazione generata, l'ispezione del container, i file cgroup, l'heap del runtime e il limite di errore osservato corrispondono tutti alla policy prevista.
Domande frequenti
Riavviare un container applica una modifica al limite di memoria in Compose?
No. Di norma, un riavvio usa la stessa configurazione del container esistente. Ricrea il servizio oppure usa un aggiornamento live supportato.
Un container può superare temporaneamente il proprio limite massimo di memoria?
La contabilizzazione del kernel e il reclaim possono mostrare brevemente valori vicini o leggermente superiori a un limite, ma un uso prolungato e non recuperabile al limite massimo attiva la gestione OOM di cgroup.
Perché l'app continua a segnalare la vecchia dimensione dell'heap?
Il runtime dell'applicazione potrebbe avere un flag heap esplicito oppure calcolare una percentuale solo all'avvio. Ricrealo o riavvialo dopo aver verificato il limite del container.
Assistenza e consigli
Altre letture

Come tenere nascosti i video per adulti sul tuo NAS ai tuoi familiari
Tieni privati i video per adulti su un NAS familiare. Controlla le autorizzazioni delle cartelle, l’accesso alle librerie di Plex e Jellyfin, le miniature,...

Cosa controllare prima di caricare un modello della community in Transformers
Usa l’aggiornamento della sandbox Jinja di Transformers per esaminare la provenienza dei modelli, i template di chat, il codice remoto, i pesi serializzati e...

Esegui Mirage in locale: OCR e rilevamento degli oggetti da una sola immagine
Prova il piccolo modello di visione locale di Cactus Compute, verifica l’OCR e l’estrazione degli oggetti con input reali e comprendi i limiti di...



