Docker usando memória demais no Mac? Como encontrar o contêiner e limitar o uso

A máquina virtual recebe memória do macOS como qualquer app, até o Memory limit que você definiu. Lá dentro, o Linux divide essa memória entre os contêineres e usa o que sobra para cache de arquivos, como o macOS faz. Visto de fora, tudo parece igual: um processo ocupando muita memória.

Só o motor sabe como ela está dividida, e é isso que o docker stats pergunta a ele. A coluna CPU % ali é uma fração das CPUs da máquina virtual, e MEM % é uma fração do limite do contêiner, ou da máquina virtual inteira quando o contêiner não tem limite.

O Docker Desktop fica com metade da memória do seu Mac por padrão: 8 GB em um Mac de 16 GB. Uma stack de desenvolvimento típica, com um servidor de app, um banco de dados e um cache, geralmente precisa de bem menos. Rode sua stack como de costume, acompanhe o total no docker stats no pico e defina o Memory limit um pouco acima disso.

Se o limite ficar baixo demais, o Linux dentro da máquina virtual para os contêineres que ficam sem memória. Execute docker inspect --format '{{.State.OOMKilled}}' seguido do nome de um contêiner: ele mostra true quando isso aconteceu. Aumente o limite ou dê a esse contêiner um limite próprio, para que ele não derrube os outros junto.

Um limite em um contêiner impede que um serviço com vazamento encha a máquina virtual. Com docker run, adicione --memory 512m. Em um arquivo Compose, defina mem_limit: 512m no serviço. O contêiner é parado se passar do limite, e docker stats mostra o limite ao lado do uso.

Parar contêineres libera memória dentro da máquina virtual, mas a máquina nem sempre a devolve ao macOS na mesma hora, então o valor dela no Monitor de Atividade pode continuar alto. O Resource Saver devolve tudo desligando a máquina quando o Docker Desktop está ocioso, e ela volta em poucos segundos quando um contêiner precisa. Encerrar o Docker Desktop tem o mesmo efeito.

Imagens, contêineres parados, volumes e o cache de build ficam em uma única imagem de disco que cresce conforme você trabalha, e no Mac ela entra em Dados do Sistema. docker system df mostra quanto cada tipo ocupa. docker system prune remove contêineres parados, redes sem uso, imagens pendentes e o cache de build; adicione --volumes só se tiver certeza de que nenhum volume guarda dados de que você precisa. O Disk usage limit, ao lado do Memory limit nos ajustes do Docker Desktop, limita esse tamanho.