본문으로 건너뛰기

Mac 에서 Docker 개발 환경 구성하는 방법

플랫폼엔지니어링 / development-environment담당자이지훈새 버전 제안일26.10.22
AI 요약

Docker Desktop 은 250인 이상 기업에서 무료로 쓸 수 없으므로 Rancher Desktop 을 설치하고, Kubernetes 를 끄고 백그라운드 실행과 관리자 권한을 켠 뒤 docker.sock 심볼릭 링크를 만든다.

목적

Mac 로컬 환경에서 Docker 를 쓸 수 있게 만든다.

왜 Rancher Desktop 인가

Docker Desktop 의 라이선스 정책 때문에 250인 이상 기업에서는 무료 버전을 쓸 수 없다. 대체 솔루션으로 Rancher 와 Podman 을 검토했고, Podman 은 Docker Compose 사용 시 호환성 문제가 있어 Rancher Desktop 을 선택했다.

수행 방법

1. Rancher Desktop 설치

http://rancherdesktop.io 에 접속해 [Download for macOS (Apple Silicon)] 을 선택하면 dmg 파일이 내려온다. 실행해서 설치한다.

2. 설치 후 확인할 네 가지

항목 설정 이유
Kubernetes 체크를 해제해 Disable 한다 k8s 를 Enable 하면 cluster 실행을 위한 컨테이너가 떠서 노트북 자원을 꽤 쓴다. Kubernetes 를 학습할 때만 Enable 하고, 필요 없으면 Disable 한 뒤 앱을 재시작한다
백그라운드 실행 Startup 자동 시작을 체크하고, Start in the background 와 Quit when closing application window 도 함께 체크한다 Rancher Desktop 앱이 종료되면 Docker Runtime 도 같이 내려간다. 두 항목을 켜 두면 실수로 Runtime 이 내려가는 것을 막는다
관리자 권한 Administrative Access 를 체크한다 컨테이너 실행 시 권한 문제로 충돌이 나지 않도록 sudo 권한을 준다
docker.sock 심볼릭 링크 아래 명령을 실행한다 docker ps 같은 명령을 실행하면 docker 바이너리가 /var/run/docker.sock 에서 데몬을 찾는다. Rancher 는 다른 위치에 docker.sock 을 만들기 때문에 링크가 필요하다
sudo ln -s ~$USER/.rd/docker.sock /var/run/docker.sock

3. Docker 와 Docker Compose 설치

brew install docker docker-compose

확인 방법

docker ps 명령으로 Rancher 에서 실행된 Docker 데몬이 살아 있는지 확인한다. Rancher Desktop 이 내려가 데몬도 내려간 경우와 정상 실행된 경우의 출력이 다르다.

활용 예

Docker Compose 로 Airflow 서버를 실행할 수 있다. 방법은 Airflow 공식 문서의 howto/docker-compose 를 따른다.

관련 문서

대상 경로
uv 로 Python 프로젝트 관리하는 방법 technology-data/development-environment/uv-python-project.md
DE 파트 업무 환경과 운영 시스템 technology-data/platform-engineering/de-part-environment.md

코멘트

코멘트 필터