배경과 문제 정의
맥을 초기화하고 Homebrew cask로 Docker Desktop 설치 후 docker compose가 동작하지 않음 터미널에 docker: ‘compose’ is not a docker command 메시지 출력, buildx도 동일 증상 재설치와 초기화를 반복했지만 변화 없음
환경
- macOS Ventura 13.0.1
- Apple Silicon M1
- Docker 20.10.21 build baeda1f
원인 가설
Docker Desktop에 포함된 CLI plugin 디렉터리가 docker가 검색하는 경로와 연결되지 않음 compose와 buildx는 독립 바이너리가 아니라 CLI plugin으로 배포됨
해결
CLI plugin 디렉터리에 심볼릭 링크 추가
mkdir -p /usr/local/lib/docker
ln -s /Applications/Docker.app/Contents/Resources/cli-plugins /usr/local/lib/docker/cli-plugins검증 및 메모
터미널에서 docker compose version, docker buildx version 확인 정상 출력되면 해결 맥 환경에 따라 사용자 홈의 ~/.docker/cli-plugins 경로를 사용할 수도 있음 변경 후 터미널 재시작 또는 쉘 재실행 권장