M1 M2 맥 도커 설치: 애플실리콘 최적화 설정 A to Z

M1, M2, M3 맥북에 도커를 설치하려고 했더니 인텔 칩셋 기반의 기존 설정 가이드와 달라 어디서부터 손대야 할지 막막하셨을 겁니다.

이는 애플 실리콘 칩셋이 기존 인텔 칩셋과 다른 ARM64 아키텍처를 사용하기 때문에 발생하는 근본적인 변화 때문입니다.

이 글에서는 애플 실리콘 맥에 Docker Desktop을 성공적으로 설치하고, 최적의 성능을 위한 설정부터 자주 겪는 문제 해결까지, A부터 Z까지 모든 과정을 명확하게 안내해 드리겠습니다.

애플 실리콘 맥과 도커의 새로운 패러다임

애플 실리콘 칩셋은 기존 인텔 맥이 사용하던 x86-64 아키텍처와 달리 ARM64 아키텍처를 기반으로 합니다. 이러한 근본적인 변화는 도커 환경 설정에도 큰 영향을 미칩니다. 과거 인텔 맥에서는 단순히 도커 데스크톱을 설치하고 컨테이너를 실행하면 되었지만, 애플 실리콘에서는 실행하려는 이미지의 아키텍처를 고려해야 하는 상황이 발생합니다.

하지만 걱정할 필요는 없습니다. 도커 팀은 애플 실리콘 칩셋 출시와 동시에 ARM64에 최적화된 Docker Desktop 버전을 빠르게 선보였습니다. 이 덕분에 애플 실리콘 맥 사용자들은 인텔 맥 사용자들보다 더 나은 성능과 전력 효율로 도커를 사용할 수 있게 되었습니다. 중요한 것은 이 새로운 환경에 맞춰 올바른 버전의 도커를 설치하고 적절히 설정하는 것입니다.

또한, 애플 실리콘 맥에는 ‘로제타 2(Rosetta 2)’라는 강력한 번역 계층이 내장되어 있어, ARM64 환경에서도 x86-64 기반으로 빌드된 애플리케이션이나 도커 이미지를 거의 80% 이상의 호환성으로 실행할 수 있습니다. 이 기능은 아직 ARM64용 이미지가 없는 레거시 프로젝트나 특정 개발 환경을 다룰 때 매우 유용하게 활용됩니다.

Photo by Pixabay on Pexels

M1/M2/M3 맥에 Docker Desktop 설치 및 초기 설정

애플 실리콘 맥에 Docker Desktop을 설치하는 과정은 비교적 간단하지만, 몇 가지 핵심 단계를 정확히 따르는 것이 중요합니다. 인텔 맥용 버전을 실수로 설치하지 않도록 주의해야 합니다. 공식 웹사이트에서 ARM64 아키텍처용 설치 파일을 다운로드하는 것이 첫 번째이자 가장 중요한 단계입니다.

설치 후에는 도커 데스크톱의 설정(Settings) 메뉴에 접속하여 시스템 리소스를 효율적으로 할당하는 것이 중요합니다. 기본 설정으로도 작동하지만, 본인의 맥북 사양과 주로 사용하는 컨테이너의 요구사항에 맞춰 CPU 코어 수와 메모리 용량을 조정하면 체감 성능이 크게 향상될 수 있습니다. 일반적으로는 CPU 2~4코어, 메모리 4~8GB를 권장합니다.

또한, 초기 실행 시 도커 데스크톱은 필요한 구성 요소를 자동으로 설치하고 시작합니다. 이 과정에서 인터넷 연결이 필수적이며, 약 10분 내외의 시간이 소요될 수 있습니다. 모든 과정이 완료되면 상단 메뉴바에 도커 아이콘이 나타나며, ‘Docker Desktop is running’ 메시지를 확인할 수 있습니다.

1. Docker Desktop 다운로드 — Docker 공식 웹사이트에 접속하여 ‘Download for Mac with Apple chip’ 버튼을 클릭하여 설치 파일을 다운로드합니다.
2. 설치 파일 실행 — 다운로드된 DMG 파일을 열고 ‘Docker’ 아이콘을 ‘Applications’ 폴더로 드래그하여 설치합니다.
3. 애플리콘션 실행 및 권한 허용 — Applications 폴더에서 Docker를 실행합니다. 처음 실행 시 시스템 권한 요청 메시지가 나타나면 비밀번호를 입력하고 허용합니다.
4. 초기 설정 완료 및 로그인 (선택 사항) — Docker Desktop이 초기 설정을 진행하고 필요한 구성 요소를 다운로드합니다. 이 과정에서 도커 허브 계정으로 로그인할 수 있지만 필수는 아닙니다.
5. 리소스 할당 조정 — Docker Desktop이 완전히 실행되면 상단 메뉴바의 도커 아이콘을 클릭하고 ‘Settings’로 들어갑니다. ‘Resources’ 탭에서 CPU, Memory, Swap 등의 리소스를 사용 환경에 맞게 조정합니다. (예: CPU 4코어, Memory 6GB)

Photo by Jakub Pabis on Pexels

애플 실리콘 환경 도커 최적화 가이드

애플 실리콘 맥에서 도커의 성능을 극대화하려면 단순히 설치하는 것을 넘어 몇 가지 핵심 설정을 최적화해야 합니다. 첫 번째는 파일 공유 방식입니다. Docker Desktop 4.x 버전부터는 VirtioFS가 기본 파일 공유 방식으로 도입되어, 기존 gRPC FUSE 방식보다 월등히 빠른 파일 I/O 성능을 제공합니다. 이는 특히 마운트된 볼륨을 많이 사용하는 개발 환경에서 체감 성능을 크게 높여줍니다.

두 번째는 리소스 할당의 미세 조정입니다. 앞서 언급했듯이, ‘Settings > Resources’에서 CPU, Memory, Swap 값을 조정할 수 있습니다. M1/M2/M3 맥은 통합 메모리 아키텍처를 사용하므로, 과도한 메모리 할당은 오히려 전체 시스템 성능에 영향을 줄 수 있습니다. 보통 시스템 메모리의 50% 정도를 도커에 할당하고, 필요한 경우 점진적으로 늘려나가는 것을 권장합니다.

마지막으로, BuildKit 사용을 활성화하는 것입니다. BuildKit은 도커 이미지 빌드 시간을 단축하고 캐싱 효율성을 높여주는 차세대 빌더입니다. `DOCKER_BUILDKIT=1 docker build` 명령어를 사용하거나, Docker Desktop 설정에서 ‘Use Docker Compose V2’를 활성화하여 최신 빌드 환경을 활용할 수 있습니다. 이는 개발 워크플로우에서 이미지 빌드가 잦은 경우 최대 30%까지 시간을 절약해 줄 수 있습니다.

Photo by Ruben Boekeloo on Pexels

자주 겪는 문제 해결과 호환성 팁

애플 실리콘 맥에서 도커를 사용하다 보면 ‘image not found’나 ‘exec format error’와 같은 메시지를 마주칠 수 있습니다. 이는 대부분 실행하려는 도커 이미지가 ARM64 아키텍처용이 아닌 x86-64 아키텍처용으로 빌드되었을 때 발생합니다. 이 경우 몇 가지 해결책이 있습니다.

가장 좋은 방법은 해당 서비스의 ARM64 기반 이미지를 직접 찾아 사용하는 것입니다. 많은 공식 이미지들은 `latest` 태그 외에 `arm64` 또는 `aarch64`와 같은 플랫폼별 태그를 제공합니다. 예를 들어, `ubuntu:latest` 대신 `ubuntu:latest-arm64`와 같이 명시하여 pull을 시도해 볼 수 있습니다. 만약 특정 이미지가 ARM64 버전을 제공하지 않는다면, `docker buildx`를 사용하여 멀티 아키텍처 이미지를 직접 빌드하는 방법도 있습니다. 이 방법은 조금 더 복잡하지만, 장기적으로 안정적인 환경을 구축하는 데 도움이 됩니다.

만약 ARM64 이미지를 찾을 수 없고, 직접 빌드하기도 어렵다면 Rosetta 2의 도움을 받을 수 있습니다. Docker Desktop 설정에서 ‘Use Rosetta for x86/amd64 emulation on Apple Silicon’ 옵션을 활성화하면, ARM64 맥에서도 x86-64 이미지를 실행할 수 있습니다. 성능 저하는 다소 발생할 수 있지만, 호환성 문제로 작업이 중단되는 상황을 피할 수 있는 효과적인 방법입니다.