Docker/Colima 연결 에러 해결 가이드

문제 발생

docker ps 또는 docker-compose ps 명령어를 입력했을 때 error during connect: ... EOR 메시지가 나온다면, 이는 Docker Client가 Colima에서 실행 중인 Docker(엔진)에 정상적으로 연결되지 못했음을 의미합니다.

error during connect: Get "도메인주소/버전/containers/json": EOF

 

보통 다음 중 한 가지 이유로 발생

• Colima 가상 머신이 정지되었거나 비정상적인 상태일 때

• Colima 가상 머신은 실행 중이지만, 그 내부의 Docker 데몬 프로세스에 문제가 발생했을 때

• Docker 소켓 파일 자체에 손상이 발생했거나 권한 문제가 있을 때

 

Colima 상태 확인

문제를 해결하기 전 Colima의 상태 확인하는 것이 중요

colima status

결과가 INFO[0001] colima is running...로 나오더라도, 실제 Docker 클라이언트와의 연결은 문제가 있을 수 있습니다. Colima가 '실행 중'이라고 보고해도, 내부 Docker 데몬이 제대로 작동하지 않으면 위와 같은 연결 에러가 발생할 수 있기 때문입니다.

문제 해결: Colima 재시작 (권장)

Colima가 실행 중이라고 하더라도, 내부 Docker 데몬의 비정상적인 상태를 리셋하기 위한 가장 효과적이고 권장되는 방법은 Colima를 완전히 정지시킨 후 다시 시작하는 것입니다. (Restart 대신 Stop후, Start를 통해 재시작해주세요)

Colima 정지: 현재 실행 중인 Colima 가상 머신과 그 안의 모든 Docker 프로세스를 종료합니다.

colima stop

Colima 시작: Colima 가상 머신과 Docker 데몬을 다시 시작합니다.

colima start

Docker 연결 재확인: Colima가 정상적으로 시작된 것을 확인한 후, Docker 클라이언트 명령어를 다시 실행하여 연결 문제를 해결했는지 확인합니다.

docker ps

이때 더 이상 error during connect 메시지가 나타나지 않고, 실행 중인 컨테이너 목록(없다면 빈 목록)이 정상적으로 표시된다면 문제 해결