Docker ERROR: for web 'ContainerConfig'

sudo docker-compose build 후

sudo docker-compose up을 하면 지속적으로 ERROR: for web 'ContainerConfig' 에러 발생

• docker 버전 : 26.1.3

• docker compose 버전 : 1.29.2

---

원인

ERROR: for web 'ContainerConfig'는 docker compose v1의 버그로 인한 문제로

기존의 docker compose 1.29.2 버전은 필드가 존재할 것을 가정하고 동작하기 때문에 최신 docker 에서는 해당 키를 찾지 못해 예외가 발생한다.

즉, docker 엔진을 최신 버전으로 업그레이드 하면서 발생한 docker compose v1의 호환성 버그가 원인

해결

docker compose를 최신 버전인 v2로 전환해야 한다.

1.sudo docker-compose down 으로 실행 중이거나 중지된 컨테이너 정리

2.docker compose v1 제거 sudo apt remove docker-compose

제거를 했음에도 docker-compose --version 으로 버전이 확인된다면 수동 설치된 docker compose 바이너리가 남아있을 수 있다.

2-1.바이너리 위치 확인 which docker-compose (ex. /usr/local/bin/docker-compose)

2-2.확인한 경로에 있는 docker compose 파일 수동 삭제 sudo rm /usr/local/bin/docker-compose

2-3.docker-compose --version 으로 삭제 확인

3.docker compose v2 설치

sudo apt update sudo

apt install docker-compose-v2

---

설치 후 버전 확인 docker compose version

잘 설치 되었다.

compose v2를 설치하면 하이픈 없이 docker compose 명령을 사용한다.

docker-compose.yml 파일은 그대로 활용할 수 있다.

sudo docker compose build

sudo docker compose up