🚢 도커의 묘한 변덕: M1 맥에서 credsStore 문제 해결하기

문제 상황: 갑자기 도커가 이미지를 당겨오지 못해요!

오늘도 평화롭게 개발하던 중, 갑자기 도커가 이미지를 가져오지 못하는 상황이 발생했습니다. 다른 팀원들의 컴퓨터에서는 모두 정상 작동하는데, 유독 제 M1 맥북에서만 문제가 발생했습니다.

Docker failed to solve: nginx:1.21.0-alpine: error getting credentials - err: exit status 1, out: ``

심지어 docker pull nginx:1.21.0-alpine 명령어로 직접 이미지를 받아보려 해도 같은 에러가 발생했습니다.

무슨 일이 벌어진 걸까요?

원인 분석: credsStore의 미스터리

문제의 원인을 찾기 위해 구글링과 도커 포럼을 뒤지던 중, 도커 인증 정보 저장소와 관련된 문제일 가능성을 발견했습니다.

도커 설정 파일을 확인해보기로 했습니다:

vi ~/.docker/config.json

그리고 범인을 발견했습니다! 파일 내용에 "credsStore": "desktop" 항목이 있었습니다.

원인 설명

Apple Silicon 맥(M1/M2)에서는 도커 데스크톱의 인증 저장소(credential store) 관련 문제가 간헐적으로 발생합니다. 이는 다음과 같은 이유로 발생할 수 있습니다:

1. Docker Desktop 업데이트 후 설정 충돌: 업데이트 과정에서 인증 관리자 설정이 잘못될 수 있습니다.
2. 키체인 접근 권한 문제: macOS 키체인과 도커의 통합 과정에서 권한 문제가 발생할 수 있습니다.
3. ARM 아키텍처 호환성 문제: Apple Silicon 칩을 사용하는 맥에서 일부 도커 컴포넌트가 완벽하게 최적화되지 않아 발생하는 문제일 수 있습니다.

해결 방법: credsStore 제거하기

해결 방법은 놀랍도록 간단했습니다. config.json 파일에서 "credsStore": "desktop" 부분을 삭제하면 됩니다.

1. 텍스트 에디터로 설정 파일 열기:

   vi ~/.docker/config.json

2. "credsStore": "desktop" 항목 삭제

3. 파일 저장 후 도커 재시작:

   docker context use default

   또는 Docker Desktop 앱 재시작

결과: 다시 평화로운 도커 생활

설정을 변경한 후, 도커 빌드를 다시 시도했더니...

짜잔! 성공적으로 이미지를 가져오고 빌드가 완료되었습니다. 🎉

추가 팁: 비슷한 문제의 다른 해결책

인터넷에서 찾아본 추가 해결 방법들을 공유합니다:

1. Docker Desktop 사용자 인증 재설정

1. Docker Desktop 앱 메뉴에서 Sign out 후 다시 로그인
2. Settings → Docker Engine에서 설정 초기화

2. Docker 자격 증명 도우미 변경

macOS에서는 osxkeychain 자격 증명 도우미를 사용할 수 있습니다:

{
  "credsStore": "osxkeychain"
}

3. Docker Desktop 완전 재설치

완전한 재설치가 필요한 경우:

# Docker Desktop 제거
/Applications/Docker.app/Contents/MacOS/Docker --uninstall

# 관련 파일 삭제
rm -rf ~/Library/Group\ Containers/group.com.docker
rm -rf ~/Library/Containers/com.docker.docker
rm -rf ~/.docker

# 재설치 후 처음부터 설정

4. 특정 버전 사용하기

가끔은 특정 버전의 도커 이미지가 호환성 문제를 일으킬 수 있습니다. 다른 태그를 시도해보세요:

docker pull nginx:1.21-alpine
# 또는
docker pull nginx:alpine

마치며

M1/M2 맥에서 Docker를 사용할 때 가끔씩 이런 묘한 문제가 발생할 수 있습니다. 대부분은 간단한 설정 변경으로 해결되지만, 가끔은 설정을 다시 확인해야 할 수도 있습니다.

문제가 해결되어 다행이지만, 도커가 업데이트될 때마다 config.json 파일을 확인해야 하는 점은 아쉽습니다. 도커 팀에서 이 문제를 영구적으로 해결해주길 바라며... 당분간은 가끔씩 config.json 파일을 체크하는 습관을 들여야겠네요! 😄

---

여러분도 비슷한 문제를 겪고 계신가요? 다른 해결 방법을 알고 계시다면 댓글로 공유해주세요!