Mac에서 Docker가 메모리를 너무 많이 쓸 때: 원인 컨테이너 찾기와 제한하는 방법

가상 머신은 다른 앱처럼 macOS에서 메모리를 받으며, 설정한 Memory limit까지 받습니다. 그 안에서 Linux가 메모리를 컨테이너들에 나눠 주고, 남은 것은 macOS처럼 파일 캐시에 씁니다. 밖에서 보면 모두 똑같이, 메모리를 많이 붙잡고 있는 프로세스 하나로 보입니다.

어떻게 나뉘는지는 엔진만 알고 있으며, docker stats가 바로 그것을 엔진에 묻는 명령입니다. 거기서 CPU % 열은 가상 머신 CPU에 대한 비율이고, MEM %는 컨테이너 한도에 대한 비율이며, 컨테이너에 한도가 없으면 가상 머신 전체에 대한 비율입니다.

Docker Desktop은 기본적으로 Mac 메모리의 절반을 가져갑니다. 16 GB Mac이라면 8 GB입니다. 앱 서버, 데이터베이스, 캐시로 이루어진 일반적인 개발 스택은 대개 그보다 훨씬 적게 필요합니다. 평소처럼 스택을 실행하고, 가장 바쁠 때 docker stats의 합계를 지켜본 다음, Memory limit을 그보다 조금 높게 설정하세요.

너무 낮게 설정하면 가상 머신 안의 Linux가 메모리가 바닥난 컨테이너를 강제로 끝냅니다. docker inspect --format '{{.State.OOMKilled}}' 뒤에 컨테이너 이름을 붙여 실행하면, 그런 일이 있었을 때 true가 출력됩니다. 한도를 높이거나, 그 컨테이너에 따로 한도를 주어 다른 컨테이너까지 함께 쓰러뜨리지 않게 하세요.

컨테이너 하나에 한도를 걸면 누수가 있는 서비스가 가상 머신을 가득 채우지 못합니다. docker run 명령에는 --memory 512m 옵션을 추가하세요. Compose 파일에서는 해당 서비스에 mem_limit: 512m 설정을 추가합니다. 한도를 넘으면 컨테이너가 중단되며, docker stats에서 사용량 옆에 한도가 표시됩니다.

컨테이너를 중단하면 가상 머신 안의 메모리는 비워지지만, 가상 머신이 그 메모리를 항상 바로 macOS에 돌려주지는 않아서 활성 상태 보기의 수치가 높게 남아 있을 수 있습니다. Resource Saver는 Docker Desktop이 유휴 상태일 때 가상 머신을 꺼서 전부 돌려주며, 컨테이너가 필요하면 몇 초 만에 다시 시작합니다. Docker Desktop을 종료해도 마찬가지입니다.

이미지, 중단된 컨테이너, 볼륨, 빌드 캐시는 작업할수록 커지는 디스크 이미지 하나에 들어 있으며, Mac에서는 시스템 데이터에 포함됩니다. docker system df는 종류별로 얼마나 차지하는지 보여 줍니다. docker system prune 명령은 중단된 컨테이너, 사용하지 않는 네트워크, 태그 없는(dangling) 이미지, 빌드 캐시를 제거합니다. --volumes 옵션은 필요한 데이터가 담긴 볼륨이 없다고 확신할 때만 추가하세요. Docker Desktop 설정에서 Memory limit 옆에 있는 Disk usage limit으로 크기를 제한할 수 있습니다.