Mac에 Docker Desktop 설치하기

이 페이지는 Mac에서의 Docker Desktop 다운로드 링크, 시스템 요구 사항, 단계별 설치 지침을 제공해요.

출처: Install Docker Desktop on Mac

본문

Docker Desktop 약관: 더 큰 기업(직원 250명 초과 또는 연간 매출 1천만 달러 초과)에서 Docker Desktop을 상업적으로 사용하려면 유료 구독이 필요해요.

체크섬은 릴리스 노트를 참고하세요.

시스템 요구 사항

Apple silicon Mac: 지원되는 버전의 macOS(현재 및 이전 두 개의 주요 macOS 릴리스에서 지원). 최소 4GB RAM. 최상의 경험을 위해 Rosetta 2 설치를 권장해요. Rosetta 2는 더 이상 엄격히 필요하진 않지만, Darwin/AMD64를 사용할 때 여전히 Rosetta 2를 요구하는 몇 가지 선택적 명령줄 도구가 있어요. 명령줄에서 Rosetta 2를 수동 설치하려면:

$ softwareupdate --install-rosetta

Intel chip Mac: 지원되는 버전의 macOS, 최소 4GB RAM.

설치나 업데이트 전에 백그라운드에서 Docker를 호출할 수 있는 도구(VS Code, 터미널, 에이전트 앱)를 종료해요. 플릿을 관리하거나 MDM으로 설치한다면 PKG 설치 프로그램을 사용해요. 설치가 완료될 때까지 설치 프로그램 볼륨을 마운트된 채 유지해요. "Docker.app is damaged" 대화상자가 나타나면 macOS의 "Docker.app is damaged" 수정 문서를 참고하세요.

Mac에서 Docker Desktop 설치 및 실행하기

관리자 권한 없이 Docker Desktop을 설치하고 실행하는 방법은 FAQ를 참고하세요.

대화형으로 설치하기

페이지 상단의 다운로드 버튼이나 릴리스 노트에서 설치 프로그램을 다운로드해요.
Docker.dmg를 더블클릭해 설치 프로그램을 열고, Docker 아이콘을 Applications 폴더로 드래그해요. 기본적으로 Docker Desktop은 /Applications/Docker.app에 설치돼요.
Applications 폴더에서 Docker.app을 더블클릭해 Docker를 시작해요.
Docker 메뉴에 Docker Subscription Service Agreement가 표시돼요. 핵심 내용: Docker Desktop은 소기업(직원 250명 미만 AND 연간 매출 1천만 달러 미만), 개인 사용, 교육, 비상업적 오픈소스 프로젝트에는 무료예요. 그 외에는 전문적 사용에 유료 구독이 필요해요. 정부 기관에도 유료 구독이 필요해요. Docker Pro, Team, Business 구독은 Docker Desktop 상업 사용을 포함해요.
계속하려면 Accept 를 선택해요. 약관에 동의하지 않으면 Docker Desktop이 실행되지 않아요. 나중에 열어 동의할 수 있어요.
설치 창에서 다음 중 하나를 선택해요. Use recommended settings(비밀번호 필요. Docker Desktop이 필요한 설정을 자동으로 구성) 또는 Use advanced settings(Docker CLI 도구의 위치를 시스템 또는 사용자 디렉터리에 설정하고 기본 Docker 소켓 활성화. 4.88.0 이하 버전에선 privileged 포트 매핑도 활성화).
Finish 를 선택해요. 이전 단계에서 비밀번호가 필요한 구성을 적용했다면 비밀번호를 입력해 확인해요.

명령줄에서 설치하기

Docker.dmg를 다운로드한 후 터미널에서 다음 명령을 실행해 Applications 폴더에 설치해요.

$ sudo hdiutil attach Docker.dmg
$ sudo /Volumes/Docker/Docker.app/Contents/MacOS/install
$ sudo hdiutil detach /Volumes/Docker

기본적으로 /Applications/Docker.app에 설치돼요. macOS는 애플리케이션을 처음 사용할 때 보안 검사를 수행하므로 install 명령이 몇 분 걸릴 수 있어요.

설치 프로그램 플래그

install 명령은 다음 플래그를 받아요.

설치 동작

--accept-license: 첫 실행이 아니라 지금 Docker Subscription Service Agreement에 동의해요.
--user=: 설치 중 한 번 privileged 구성을 수행해요. 첫 실행 시 root 권한을 부여받을 필요가 없어요. 사용자 이름을 찾으려면 CLI에서 ls /Users를 입력해요.

보안 및 접근

--allowed-org=: 애플리케이션 실행 시 사용자가 로그인하고 지정된 Docker Hub 조직에 속해야 해요.
--admin-settings: 관리자가 조직 내 클라이언트 머신의 특정 Docker Desktop 설정을 제어하는 데 쓰는 admin-settings.json 파일을 자동으로 만들어요. --allowed-org= 플래그와 함께 사용해야 해요. 예: --allowed-org=<org> --admin-settings="{'configurationFileVersion': 2, 'enhancedContainerIsolation': {'value': true, 'locked': false}}"

프록시 구성

--proxy-http-mode=: HTTP 프록시 모드 설정. system(기본) 또는 manual 2가지 모드.
--override-proxy-http=: 나가는 HTTP 요청에 사용할 HTTP 프록시 URL 설정. --proxy-http-mode가 manual이어야 해요.
--override-proxy-https=: 나가는 HTTPS 요청에 사용할 HTTP 프록시 URL 설정. --proxy-http-mode가 manual이어야 해요.

Mac에 Docker Desktop 설치하기