맥북에서 컨테이너 기반 가상화 환경을 구축할 때 도커(Docker)는 필수적인 도구입니다. 특히 개발 환경을 통일하고, 배포 과정을 간소화하는 데 큰 도움이 됩니다. 이 글에서는 2025년 현재, 애플 실리콘(M1, M2 칩) 기반 맥북 사용자도 쉽게 따라 할 수 있도록 Homebrew(brew)를 이용한 도커 설치 및 기본적인 사용법에 대해 상세히 안내합니다. 최신 맥북 환경에 최적화된 설치 과정과 명령어 팁을 확인하고, 빠르고 효율적인 개발 환경을 구축해 보세요.
📚 함께 읽으면 좋은 글
맥북 도커 설치 전 필수 준비 사항 확인하기
도커를 설치하기 전에 맥북 시스템이 요구 사항을 충족하는지 확인해야 합니다. 특히 최근의 M1, M2 칩을 사용하는 애플 실리콘 맥북의 경우, Intel 기반 맥북과 설치 과정에 약간의 차이가 있을 수 있습니다. 이 가이드에서는 Homebrew를 사용하여 도커를 설치하는 가장 간편하고 권장되는 방법을 중점적으로 다룹니다.
Homebrew 설치 및 최신 버전 유지 상세 더보기
Homebrew는 맥OS에서 패키지를 관리하는 데 사용되는 인기 있는 도구입니다. 도커 설치에 앞서, Homebrew가 설치되어 있지 않다면 먼저 설치해야 합니다. 터미널을 열고 다음 명령어를 입력하세요.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"만약 이미 설치되어 있다면, 다음 명령어로 Homebrew를 최신 상태로 업데이트하세요. 이는 설치 오류를 방지하는 데 중요합니다.
brew updateHomebrew 설치가 완료되었다면, 이제 다음 단계를 진행할 준비가 된 것입니다.
Homebrew를 이용한 맥북 도커 데스크톱 설치 단계 확인하기
Homebrew를 통해 도커 데스크톱(Docker Desktop)을 설치하는 것은 매우 간단합니다. 이 방법은 수동으로 .dmg 파일을 다운로드하여 설치하는 것보다 더 빠르고 편리합니다. Homebrew의 cask 기능을 사용하여 애플리케이션을 설치할 수 있습니다.
도커 데스크톱 설치 명령어 상세 더보기
터미널에서 다음 명령어를 실행하여 도커 데스크톱을 설치합니다.
brew install --cask docker이 명령어를 실행하면 Homebrew가 도커 데스크톱 설치 파일을 다운로드하고 자동으로 애플리케이션 폴더에 설치를 완료합니다. 설치 과정 중 관리자 비밀번호를 요구할 수 있습니다.
설치 후 초기 실행 및 환경 설정 보기
설치가 완료되면, Launchpad 또는 응용 프로그램 폴더에서 Docker 애플리케이션을 찾아 실행합니다. 도커가 처음 실행될 때 몇 가지 초기 설정을 진행하며, 필요한 권한을 요청할 수 있습니다. 최신 맥북 운영체제에서는 보안을 위해 도커에 대한 시스템 권한을 수동으로 허용해야 할 수도 있습니다. 안내에 따라 권한을 부여하고, 서비스 약관에 동의한 후 도커 대시보드가 나타나면 설치가 성공적으로 완료된 것입니다.
M1 M2 애플 실리콘 맥북 도커 환경 설정 팁 확인하기
애플 실리콘(M1, M2 칩) 맥북은 ARM 아키텍처를 사용하기 때문에, Intel 기반(x86_64) 이미지와의 호환성 문제가 발생할 수 있습니다. 다행히 최신 도커 데스크톱 버전은 이러한 아키텍처 차이를 잘 처리하도록 업데이트되었습니다. 하지만 성능 최적화 및 호환성을 위해 몇 가지 설정을 확인하는 것이 좋습니다.
아키텍처 호환성 및 에뮬레이션 상세 더보기
M1/M2 맥북용 도커는 기본적으로 ARM 아키텍처에 최적화된 이미지를 사용합니다. 만약 Intel 기반 이미지를 사용해야 한다면, 도커는 Rosetta 2와 유사한 기술을 사용하여 에뮬레이션합니다. 성능 저하를 최소화하려면 가능하면 arm64 또는 multi-arch를 지원하는 이미지를 사용하는 것이 가장 좋습니다.
도커 리소스 할당 최적화 보기
도커 데스크톱의 설정 (Preferences) 메뉴로 이동하여 Resources 탭을 확인합니다. 여기서 도커가 사용할 수 있는 CPU, 메모리, 스왑 공간의 양을 설정할 수 있습니다. 개발 환경의 요구 사항에 맞춰 리소스를 적절히 할당하여 시스템의 전체적인 성능을 유지하는 것이 중요합니다.
- CPU: 일반적으로 시스템 코어 수의 절반 정도를 할당하는 것이 좋습니다.
- Memory: 컨테이너가 많이 필요한 경우를 대비하여 4GB 이상을 권장합니다.
기본 도커 명령어 사용법 및 설치 확인 확인하기
도커 데스크톱 설치가 완료되고 실행되었다면, 터미널을 통해 도커가 정상적으로 작동하는지 확인하고 몇 가지 기본적인 명령어를 연습해 볼 차례입니다. 이는 도커를 활용하는 첫걸음이 됩니다.
도커 설치 확인 및 버전 상세 더보기
터미널에서 다음 명령어를 입력하여 도커 클라이언트 및 서버의 버전 정보를 확인합니다. 두 버전이 모두 출력되면 도커가 정상적으로 설치된 것입니다.
docker --version docker version테스트용 컨테이너 실행 및 이미지 관리 보기
도커의 가장 기본적인 동작인 컨테이너 실행을 테스트 해보세요. 공식 hello-world 이미지를 실행하여 설치가 완벽하게 되었음을 검증할 수 있습니다.
docker run hello-world성공적으로 실행되면 다음과 같은 메시지가 출력됩니다.
Hello from Docker! This message shows that your installation appears to be working correctly.
자주 사용되는 기본 명령어는 다음과 같습니다.
| 명령어 | 설명 |
|---|---|
docker images |
다운로드된 이미지 목록 확인 |
docker ps -a |
모든 컨테이너(실행 중, 종료됨) 목록 확인 |
docker pull [이미지 이름] |
이미지 다운로드 |
도커 컴포즈(Docker Compose)를 이용한 다중 컨테이너 환경 설정 확인하기
단일 컨테이너가 아닌 여러 서비스(예: 웹 서버, 데이터베이스, 캐시)를 함께 관리해야 할 경우, 도커 컴포즈(Docker Compose)를 사용하는 것이 일반적입니다. 도커 데스크톱을 Homebrew로 설치했다면, 도커 컴포즈는 보통 함께 설치됩니다.
도커 컴포즈 설치 확인 상세 더보기
도커 컴포즈의 설치 여부를 확인하려면 다음 명령어를 사용하세요.
docker compose version버전 정보가 출력되면 정상적으로 사용할 수 있습니다.
YAML 파일을 이용한 서비스 정의 보기
도커 컴포즈는 docker-compose.yml 파일을 사용하여 애플리케이션의 서비스를 정의합니다. 이 파일에는 각 컨테이너의 이미지, 포트 매핑, 환경 변수, 볼륨 설정 등이 포함됩니다. YAML 파일 작성을 통해 복잡한 다중 컨테이너 환경을 하나의 명령어로 쉽게 실행하고 관리할 수 있습니다.
예시 YAML 파일 구조:
version: "3.8" services: web: image: nginx:latest ports: - "80:80" db: image: postgres:latest environment: POSTGRES_PASSWORD: mysecretpassword이 파일을 저장한 디렉토리에서 다음 명령어로 모든 서비스를 한번에 실행할 수 있습니다.
docker compose up -d맥북 도커 사용 중 발생 가능한 문제 해결 팁 확인하기
맥북에서 도커를 사용하는 동안 몇 가지 일반적인 문제가 발생할 수 있습니다. 대부분은 도커 데스크톱 설정, 리소스 부족 또는 권한 문제와 관련되어 있습니다. 문제 발생 시 당황하지 말고 아래 팁들을 확인해 보세요.
도커 데몬이 시작되지 않을 때 상세 더보기
도커 데스크톱을 실행했는데도 터미널에서 docker 명령어가 작동하지 않거나 “Cannot connect to the Docker daemon” 오류가 발생할 수 있습니다. 이 경우, 도커 데스크톱 앱이 완전히 실행되었는지, 그리고 시스템 트레이(상단 메뉴바)의 도커 아이콘이 녹색(실행 중)인지 확인하세요. 문제가 지속되면 도커 데스크톱 앱을 재시작하거나, 앱 설정에서 Troubleshoot > Restart Docker Desktop 기능을 사용해 보세요.
느린 성능 또는 리소스 부족 해결 보기
컨테이너의 동작이 눈에 띄게 느리다면, 도커 데스크톱 설정의 Resources 탭에서 할당된 CPU 코어와 메모리 양이 충분한지 확인하세요. 또한, 불필요하게 실행 중인 컨테이너나 사용하지 않는 이미지를 정리하여 시스템 리소스를 확보하는 것도 중요합니다.
docker system prune -a위 명령어는 종료된 컨테이너, 사용되지 않는 네트워크, 빌드 캐시, 사용되지 않는 이미지 등을 삭제하여 공간을 확보합니다.
📌 추가로 참고할 만한 글
FAQ 자주 묻는 질문
Q Homebrew로 도커를 설치하는 것이 공식 웹사이트에서 다운로드하는 것보다 좋은가요?
A Homebrew를 사용하는 것은 패키지 관리의 일관성 측면에서 좋습니다. Homebrew를 통해 설치하면 업데이트나 제거를 터미널 명령어로 간편하게 관리할 수 있으며, 개발 환경에 필요한 다른 도구들(예: Node, Python)과 함께 일괄적으로 관리할 수 있다는 장점이 있습니다. 공식 웹사이트 다운로드도 물론 완벽하게 작동합니다.
Q M1/M2 맥북에서 Intel 기반 이미지를 사용하면 성능이 많이 느려지나요?
A 네, 성능 저하가 발생할 수 있습니다. M1/M2 칩은 ARM 아키텍처를 사용하며, Intel 기반(x86_64) 이미지를 실행할 때는 에뮬레이션 과정을 거쳐야 합니다. 이 에뮬레이션 과정에서 네이티브 ARM 이미지에 비해 처리 속도가 느려지고 리소스 소모가 증가할 수 있습니다. 가능하면 ARM 아키텍처를 지원하는 이미지(대부분의 공식 이미지는 multi-arch 지원)를 사용하는 것이 최적의 성능을 보장합니다.
Q 도커 컨테이너 내부의 파일을 맥북에서 직접 수정할 수 있나요?
A 네, 볼륨 마운트(Volume Mount) 기능을 사용하면 가능합니다. docker run 명령어 또는 docker-compose.yml 파일에서 맥북의 특정 로컬 디렉토리를 컨테이너 내부의 디렉토리에 연결(마운트)할 수 있습니다. 이렇게 하면 맥북에서 파일을 수정하면 컨테이너 내부에도 실시간으로 반영됩니다.