맥북 M1/M2/M3 도커 설치, 설정 끝! 바로 실행

맥북에 도커를 설치하려는데, M1 칩인지 Intel 칩인지 몰라 어떤 설치 파일을 받아야 할지 망설이고 있나요? 혹은 설치 후 초기 설정이 복잡하게 느껴지시나요? 최신 맥북은 대부분 M1, M2, M3 칩을 탑재하고 있어 일반적인 설치 방법과는 약간의 차이가 있습니다.

함께 보면 좋은 글: Sonoma 업데이트 후 맥 느려짐? 최적화 6가지 팁

이러한 칩셋 차이 때문에 발생하는 혼란은 설치 과정에서 불필요한 시간을 낭비하게 만들 수 있습니다. 이 글에서는 맥북의 칩셋 종류와 관계없이 도커를 빠르고 정확하게 설치하고, 바로 개발에 사용할 수 있도록 초기 설정을 완료하는 방법을 단계별로 상세하게 안내합니다.

도커 설치 전 필수 확인: 맥북 칩셋 종류 파악하기

맥북에 도커를 설치하기 전에 가장 먼저 해야 할 일은 자신의 맥북이 어떤 칩셋을 사용하는지 정확히 확인하는 것입니다. 이는 올바른 설치 파일을 다운로드하고 최적의 성능을 보장하는 데 결정적인 역할을 합니다. 최근 출시되는 맥북은 대부분 Apple Silicon(M1, M2, M3 시리즈) 칩을 탑재하고 있지만, 일부 구형 모델은 Intel 칩을 사용합니다. 이 두 칩셋은 아키텍처가 다르기 때문에 호환되는 소프트웨어를 설치해야 합니다.

Apple Silicon 칩은 ARM 아키텍처를 기반으로 하며, Intel 칩은 x86 아키텍처를 사용합니다. 도커는 이러한 아키텍처 차이를 고려하여 각기 다른 버전의 설치 파일을 제공합니다. 잘못된 버전을 설치하면 도커가 정상적으로 작동하지 않거나 심각한 성능 저하를 겪을 수 있습니다. 예를 들어, M1 맥북에 Intel 버전의 도커를 설치하려 하면 호환성 문제가 발생하여 설치 자체가 불가능할 수 있습니다.

실제 사용자 중에는 이러한 칩셋 구분을 놓쳐 설치에 어려움을 겪는 경우가 많습니다. 한 사용자는 "기존 맥북프로에서 장난감으로 docker 구성으로 주가, 뉴스를 selenium으로 수집하고 가공해서 telegram으로 알람주는 기능을 만들면서 놀고 있었습니다. 그러다가 이번에 M1 맥미니를 구매하면서 장난감을 옮겨봤습니다 ## 기존 구조 (2015 mac pro)"라고 말하며 M1 칩 환경에서의 새로운 설정 필요성을 언급했습니다 (출처: clien.net). 이처럼 칩셋 변경은 새로운 환경 설정의 시작을 의미합니다.

자신의 맥북 칩셋 종류를 확인하는 가장 쉬운 방법은 다음과 같습니다. 화면 왼쪽 상단의 Apple 메뉴를 클릭하고 '이 Mac에 관하여'를 선택하세요. 새로 나타나는 창에서 '개요' 탭의 '프로세서' 또는 '칩' 항목을 보면 Apple M1, M2, M3 또는 Intel Core i5, i7 등으로 표시됩니다. 이 정보를 바탕으로 올바른 설치 파일을 선택할 수 있습니다.

Photo by Farhad Irani on Pexels

맥북 M1/M2/M3용 도커 Desktop 설치 단계

이제 자신의 맥북 칩셋 종류를 확인했다면, 본격적으로 도커 Desktop을 설치할 차례입니다. 도커 Desktop은 도커 엔진, 도커 CLI 클라이언트, 도커 Compose, Kubernetes 등 도커 개발에 필요한 모든 도구를 통합하여 제공하는 애플리케이션입니다. M1, M2, M3 칩을 사용하는 맥북의 경우, Apple Silicon에 최적화된 버전을 설치해야 합니다.

먼저, 도커 공식 웹사이트(docker.com)에 접속합니다. 웹사이트는 자동으로 사용자의 운영체제와 칩셋을 감지하여 적절한 다운로드 링크를 제공하는 경우가 많지만, 직접 선택하는 것이 더 확실합니다. 홈페이지에서 'Get Docker' 또는 'Download' 버튼을 클릭하면 운영체제 선택 화면이 나타납니다. 여기서 'Mac'을 선택하고, 그 아래에서 'Apple Chip' 또는 'M1/M2/M3 Chip' 옵션을 선택하여 설치 파일을 다운로드합니다.

다운로드가 완료되면, 다운로드 폴더에 있는 '.dmg' 파일을 실행합니다. 그러면 도커 아이콘과 Applications 폴더 아이콘이 나타나는 창이 뜹니다. 도커 아이콘을 Applications 폴더로 드래그하여 복사하면 설치가 진행됩니다. 이 과정은 일반적인 맥 앱 설치와 동일하게 간단합니다.

설치가 완료되면 Applications 폴더에서 'Docker'를 찾아 실행합니다. 처음 실행 시 도커의 라이선스 동의 절차를 거치게 됩니다. 'Accept'를 클릭하여 진행하면, 도커 Desktop 애플리케이션이 실행되고 트레이 아이콘이 나타납니다. 이 과정에서 약 1~2분 정도 소요될 수 있습니다. 설치 파일 크기는 약 500MB 정도이며, 다운로드 속도는 인터넷 환경에 따라 달라집니다.

도커 Desktop 초기 설정: 개발 환경 최적화

도커 Desktop 설치를 마쳤다면, 이제 개발 생산성을 높이기 위한 몇 가지 초기 설정을 진행해야 합니다. 이 설정들은 도커 컨테이너가 사용할 시스템 리소스(CPU, 메모리 등)를 할당하고, 네트워크 설정을 구성하는 등 도커 환경을 최적화하는 데 도움을 줍니다.

도커 Desktop 애플리케이션을 실행한 후, 메뉴 막대에 있는 도커 아이콘을 클릭하고 'Settings' (또는 Preferences)를 선택합니다. 설정 창이 열리면 왼쪽 메뉴에서 'Resources' 섹션을 찾을 수 있습니다. 이 섹션에서 'Advanced' 탭을 선택하면 CPU, 메모리, 디스크 공간 등을 조절할 수 있습니다. 맥북의 사양에 따라 적절한 값을 설정하는 것이 중요합니다. 예를 들어, 16GB RAM을 가진 맥북이라면 도커에 4GB에서 8GB 사이의 메모리를 할당하는 것이 일반적입니다.

CPU 코어 할당도 성능에 영향을 미칩니다. 일반적으로 맥북의 물리적 코어 수의 절반 정도를 할당하는 것이 권장됩니다. 예를 들어, 8코어 CPU를 가진 맥북이라면 4코어를 도커에 할당할 수 있습니다. 디스크 공간은 사용할 도커 이미지와 볼륨의 크기를 고려하여 충분히 할당해야 합니다. 최소 50GB 이상을 권장하며, 사용량이 많다면 100GB 이상으로 설정할 수도 있습니다.

실제 사용자 중에는 리소스 설정을 잘못하여 컨테이너 실행 시 성능 문제를 겪는 경우가 있습니다. 한 개발자는 "처음에는 리눅스 서버에 SSH 접속해서 화면을 맥에 뿌리는 식으로 해봤다가, 이참에 Docker 사용에 도전해 봤습니다. 그걸 정리한 글: https://www.clien.net/service/board/lecture/15613374CLIEN · 다른 건 괜찮은 듯하지"라며 초기 설정의 중요성을 간접적으로 시사했습니다 (출처: clien.net). 이는 초기 설정이 원활한 도커 사용 경험의 바탕이 됨을 보여줍니다.

또한, 'Resources' 섹션의 'File Sharing' 탭에서 도커 컨테이너가 접근할 수 있는 로컬 파일 경로를 설정할 수 있습니다. 기본적으로 홈 디렉토리와 Applications 폴더 등이 포함되어 있지만, 필요에 따라 특정 프로젝트 폴더를 추가하여 컨테이너와 데이터를 쉽게 공유할 수 있습니다. 'Settings' 창의 'General' 탭에서는 도커 Desktop 시작 시 자동 실행 여부, 업데이트 설정 등을 구성할 수 있습니다. 'Docker Engine' 탭에서는 도커 데몬의 설정을 JSON 형식으로 직접 수정할 수 있으며, 이는 고급 사용자에게 유용합니다.

첫 도커 컨테이너 실행 및 관리하기

도커 Desktop 설치와 초기 설정이 모두 완료되었다면, 이제 실제로 도커 컨테이너를 실행해 볼 차례입니다. 가장 간단하고 널리 사용되는 예시는 웹 서버인 Nginx를 실행하는 것입니다. 이를 통해 도커의 기본적인 작동 방식을 이해하고 컨테이너를 관리하는 방법을 익힐 수 있습니다.

터미널 애플리케이션을 열고 다음 명령어를 입력하여 Nginx 컨테이너를 실행합니다. 이 명령어는 Nginx 최신 버전을 다운로드하고, 컨테이너를 백그라운드에서 실행하며, 호스트 머신의 8080 포트를 컨테이너의 80 포트와 연결합니다.

docker run -d -p 8080:80 --name my-nginx nginx:latest

위 명령어에서:

• docker run: 새로운 컨테이너를 생성하고 실행하는 명령어입니다.
• -d: 컨테이너를 백그라운드(detached mode)에서 실행합니다.
• -p 8080:80: 호스트 머신의 8080 포트를 컨테이너의 80 포트로 포워딩합니다.
• --name my-nginx: 컨테이너에 'my-nginx'라는 이름을 부여합니다.
• nginx:latest: 사용할 도커 이미지의 이름과 태그입니다. 'latest'는 최신 버전을 의미합니다.

명령어 실행 후, 웹 브라우저를 열고 http://localhost:8080으로 접속하면 Nginx 기본 환영 페이지를 볼 수 있습니다. 이는 도커 컨테이너가 성공적으로 실행되었음을 의미합니다.

컨테이너의 상태를 확인하려면 다음 명령어를 사용합니다.

docker ps

이 명령어는 현재 실행 중인 모든 컨테이너 목록을 보여줍니다. 방금 실행한 'my-nginx' 컨테이너가 목록에 나타나야 합니다. 컨테이너를 중지하려면 docker stop my-nginx, 완전히 삭제하려면 docker rm my-nginx 명령어를 사용합니다. 도커 Desktop 애플리케이션에서도 GUI를 통해 컨테이너를 확인하고 관리할 수 있습니다.

문제 해결 및 추가 팁

도커 설치 및 사용 중 예상치 못한 문제가 발생할 수 있습니다. 가장 흔한 문제 중 하나는 설치 후 도커 Desktop이 제대로 시작되지 않거나, 컨테이너 실행 시 오류가 발생하는 경우입니다. 이럴 때는 먼저 도커 Desktop 애플리케이션을 재시작해보는 것이 좋습니다. 메뉴 막대 아이콘을 클릭하여 'Quit Docker Desktop'을 선택한 후, Applications 폴더에서 다시 실행합니다.

만약 문제가 지속된다면, 도커 Desktop의 'Settings' > 'Troubleshoot' 섹션을 확인해 보세요. 여기에는 'Reset to factory defaults' 옵션이 있습니다. 이 옵션을 사용하면 도커 Desktop을 초기 상태로 되돌릴 수 있으며, 대부분의 설정 관련 문제를 해결할 수 있습니다. 다만, 이 옵션을 사용하면 모든 도커 이미지, 컨테이너, 볼륨 등이 삭제되므로 주의해야 합니다. 따라서 중요한 데이터는 미리 백업해두는 것이 좋습니다.

Apple Silicon 칩 환경에서는 Rosetta 2의 지원 범위와 도커의 호환성을 이해하는 것이 중요합니다. Apple Silicon 맥에서 Intel 기반의 애플리케이션을 실행하기 위해 Rosetta 2가 사용되지만, 도커 컨테이너 환경에서는 별도의 설정이 필요할 수 있습니다. 예를 들어, Intel 아키텍처용으로만 빌드된 이미지를 사용해야 한다면, 도커 Desktop 설정에서 'Emulate Intel x86_64 architecture'와 같은 옵션을 활성화해야 할 수 있습니다. 하지만 가능한 한 ARM 네이티브 이미지를 사용하는 것이 성능상 가장 좋습니다. Apple 공식 문서에 따르면, M1/M2/M3 칩은 ARM64 아키텍처를 사용하며, 대부분의 현대적인 소프트웨어는 ARM 버전을 지원합니다 (출처: Apple 지원 문서).

추가적으로, 도커 컨테이너의 로그를 확인하는 것은 문제 진단에 매우 유용합니다. 다음 명령어를 사용하여 컨테이너의 로그를 실시간으로 볼 수 있습니다.

docker logs -f my-nginx

여기서 -f 옵션은 로그를 실시간으로 따라가며 보여주는 기능입니다. 문제가 발생했을 때 어떤 오류 메시지가 출력되는지 확인하는 데 큰 도움이 됩니다. 또한, 컨테이너 내부의 프로세스 정보를 확인하고 싶다면 docker top my-nginx 명령어를 사용할 수 있습니다.