Docker 이미지는 성공적으로 다운로드되었으나, 컨테이너 생성 단계에서 unsupported shim version (3): not implemented 에러가 발생한 상황입니다.

🚨 원인 분석

이 에러는 docker-ce (Docker 데몬)와 이를 실행하는 컨테이너 런타임인 containerd의 버전 불일치로 인해 발생합니다.

이전에 docker.socket 서비스를 재시작/재설치하는 과정이나 우분투 시스템 업데이트 과정에서 docker.io와 containerd 패키지 간의 버전에 꼬임이 생겼을 가능성이 매우 높습니다.

🚀 해결 방법 (단계별 진행)

가장 깔끔한 해결책은 containerd 서비스를 재시작하거나, Docker 관련 구성요소 패키지를 최신 버전으로 일괄 업데이트/재설치하는 것입니다.

1단계: 기존 실패한 컨테이너 잔재 제거

에러가 발생하며 생성만 되고 구동되지 않은 oracle-xe 컨테이너를 삭제합니다.

docker rm -f oracle-xe

2단계: containerd 및 docker 서비스 재시작

런타임 데몬(containerd)을 완전히 다시 띄워 심(shim) 버전 충돌을 해소합니다.

sudo systemctl restart containerd
sudo systemctl restart docker

💡 만약 위의 2단계 후에도 동일한 에러가 발생한다면? (패키지 동기화)

우분투 기본 리포지토리의 docker.io 및 containerd 패키지 버전을 일치시키는 업그레이드를 진행합니다.

sudo apt update
sudo apt install --reinstall -y docker.io containerd
sudo systemctl restart containerd
sudo systemctl restart docker

📦 3단계: Oracle XE 다시 실행 및 검증

이제 이미지는 이미 로컬에 다운로드된 상태이므로(Downloaded newer image), 실행 명령어를 치면 즉시 구동됩니다.

docker run -d --name oracle-xe -p 1521:1521 -e ORACLE_PASSWORD=secret gvenzl/oracle-xe:21-slim

구동 후 로그 확인:

docker logs -f oracle-xe

로그 출력 하단에 DATABASE IS READY TO USE! 문구가 나오면 정상 구축 완료입니다!