Porque é que um contentor em execução mantém o limite de memória antigo depois de o ficheiro Compose ser alterado?

Eva Wong é a redatora técnica e entusiasta residente na ZimaSpace. Uma geek desde sempre, apaixonada por homelabs e software de código aberto, dedica-se a traduzir conceitos técnicos complexos em guias práticos. A Eva acredita que a auto-hospedagem deve ser divertida, não intimidante. Através dos seus tutoriais, ajuda a comunidade a desmistificar configurações de hardware, desde montar o primeiro NAS até dominar os contentores Docker.

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

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.