Um contentor em execução mantém o limite de memória antigo quando a configuração editada do Compose nunca foi aplicada ao cgroup ativo desse contentor.
Alterar o YAML não modifica, por si só, um contentor existente, e um reinício normal inicia o mesmo contentor com a configuração definida no momento da criação. A confusão também resulta de comparar um limite máximo de memória com uma reserva, um limite de swap, o âmbito pai do systemd ou uma definição de heap da aplicação. Verifique o valor efetivo do cgroup e o ID do contentor antes de concluir que o Docker ignorou a alteração.
Leia o limite do cgroup em execução em vez de confiar no YAML
Registe o ID do contentor, a data de criação, os dados da inspeção do Docker, a versão do cgroup e os ficheiros de controlo de memória utilizados pelo processo em execução.
O kernel Linux define memory.max como limite máximo rígido do cgroup, enquanto memory.high aplica pressão de recuperação de memória sem funcionar como o mesmo limite absoluto.
Se o cgroup em execução ainda contiver o valor antigo, a configuração não foi aplicada. Se contiver o novo valor, mas a monitorização indicar o contrário, verifique as unidades, a contabilização da cache, a swap e as métricas ao nível da aplicação.
Distinga o reinício da recriação do contentor
Compare o ID do contentor antes e depois do comando utilizado para implementar a alteração. Registe se o comando foi restart, up, create, uma ação da interface do NAS ou uma atualização direta do Docker.
O Docker indica que o Compose restart não aplica alterações à configuração, porque reinicia os contentores de serviço existentes.
Utilize uma atualização controlada do Compose que recrie o serviço ou, quando adequado, uma atualização de recursos em execução suportada. Guarde os dados da inspeção anteriores para poder verificar o campo alterado.
Valide o modelo final do Compose e o campo de memória
Gere a configuração efetiva do Compose depois de aplicar todos os ficheiros, perfis e substituições de variáveis de ambiente. Verifique se o limite pertence ao serviço ativo.
A especificação do Compose define mem_limit como limite de memória de um serviço e exige coerência quando também são declarados limites equivalentes em deploy.
Um valor num ficheiro de substituição não utilizado, num perfil inativo, num serviço com o nome mal escrito ou noutra interface do Stack não altera o modelo implementado. Compare a configuração gerada com os dados da inspeção do Docker.
Separe o limite máximo, a reserva e a swap
Registe o limite máximo de memória, a reserva ou o limite flexível, o limite de swap, a utilização atual, a utilização máxima e os eventos OOM. Não trate todos os valores relacionados com memória como um único limite.
A documentação de controlo de recursos do Systemd distingue MemoryHigh de MemoryMax e mostra que os cgroups pai podem impor limites adicionais a serviços e contentores.
Um contentor pode parecer exceder uma reserva porque uma reserva não é o mesmo que um limite máximo. Também pode utilizar swap ou cache de páginas, que alguns painéis de controlo excluem ou apresentam em separado.
Verifique se o heap do runtime tem um limite próprio
Nas aplicações Java, registe a deteção da JVM compatível com contentores, o heap máximo, a memória direta, os metadados de classe, as pilhas de threads e as opções transmitidas pela imagem ou pela configuração da aplicação.
A Oracle documenta que a JVM dimensiona o heap com base nas restrições de memória disponíveis e permite que MaxRAMPercentage defina a fração do heap.
Alterar o limite do contentor pode não produzir o heap de aplicação esperado quando uma opção explícita -Xmx ou uma percentagem continua em vigor. A memória de heap também não corresponde à utilização total de memória do processo.
Verifique os limites do Node.js e de outras aplicações
Inspecione as opções do runtime, as variáveis de ambiente, o número de processos de trabalho, as caches e os limites internos de memória. Compare-os com o limite do sistema operativo.
A documentação do Node.js descreve max-old-space-size como um limite de heap do V8, que pode permanecer inalterado mesmo depois de o contentor receber uma alocação cgroup maior ou menor.
Um limite do contentor protege o anfitrião; não ajusta automaticamente todas as aplicações. Defina o runtime abaixo do limite máximo do contentor, deixando margem para alocações nativas e para a cache do sistema de ficheiros.
Aplique uma alteração e verifique-a sob uma carga controlada
Gere o modelo final do Compose, recrie apenas o serviço afetado, confirme o novo ID do contentor e o cgroup ativo e, em seguida, execute uma carga de trabalho limitada enquanto monitoriza a utilização e os eventos de OOM.
O artigo do ZimaSpace Tech & AI Hub explica o que acontece quando um contentor atinge o limite ativo; este artigo centra-se em comprovar que um limite alterado foi efetivamente implementado.
O problema fica resolvido quando a configuração gerada, a inspeção do contentor, os ficheiros cgroup, o heap do runtime e o limite de falha observado correspondem todos à política pretendida após o reinício.
Perguntas frequentes
Reiniciar um contentor aplica um limite de memória do Compose alterado?
Não. Normalmente, um reinício usa a mesma configuração existente do contentor. Recrie o serviço ou use uma atualização em execução suportada.
Um contentor pode exceder temporariamente o seu limite máximo de memória?
A contabilização do kernel e a recuperação de memória podem mostrar temporariamente valores próximos ou ligeiramente acima de um limite, mas a utilização sustentada de memória não recuperável no limite máximo leva à gestão de OOM do cgroup.
Porque é que a aplicação continua a indicar o tamanho de heap antigo?
O runtime da aplicação pode ter uma opção explícita de heap ou calcular uma percentagem apenas no arranque. Recrie ou reinicie-o depois de validar o limite do contentor.
Assistência e dicas
Mais para ler

Como manter vídeos para adultos no seu NAS ocultos dos membros da família
Mantenha os vídeos para adultos privados num NAS familiar. Verifique as permissões das pastas, o acesso às bibliotecas do Plex e do Jellyfin, as...

O que verificar antes de carregar um modelo da comunidade em Transformers
Utilize a atualização da sandbox Jinja do Transformers para rever a proveniência dos modelos, os modelos de chat, o código remoto, os pesos serializados...

Execute o Mirage localmente: OCR e deteção de objetos a partir de uma imagem
Experimente o pequeno modelo de visão local da Cactus Compute, valide o OCR e a extração de objetos com dados reais e compreenda os...



