Docker-compose.yml: `version` is obsolete 오류 해결

🌟 INDEX

• Docker-compose.yml: `version` is obsolete
• 오류 분석
• 오류 해결

---

Docker-compose.yml: `version` is obsolete

프로젝트 업데이트 후 도커에서 재빌드 하려니 갑자기 `version` is obsolete 오류가 발생하였습니다.

지난주 금요일까지 잘 사용하던 명령어인데...

오류 분석

D:\Docker\liyo>docker-compose up -d --build
time="2024-08-19T10:51:56+09:00" 
level=warning msg="D:\Docker\ConnectedICS\apigateway\gatewayserver\docker-compose.yml:version is obsolete"
request returned Internal Server Error for API route and version 
http://%2F%2F.%2Fpipe%2FdockerDesktopLinuxEngine/v1.46/containers/json?all=1&filters=%7B%22label%22%3A%7B%22com.docker.compose.config-hash%22%3Atrue%2C%22com.docker.compose.project%3Dgatewayserver%22%3Atrue%7D%7D, 
check if the server supports the requested API version

이 오류 메시지는 Docker Compose 파일의 version 필드가 더 이상 사용되지 않는다고 안내하고 있습니다.

Docker 데몬과 Docker Compose 버전 간의 호환성 문제로 발생한 것으로 보입니다.

 

Docker Compose V2 ( = Cli plugin)에서는 항상 최신 버전의 compose 파일 스키마를 사용하기 때문에 version 필드가 더 이상 필요하지 않다고 합니다.

 

오류 해결

version: '3.8'
services:
  backservice-beusr:
    build:
      context: .
      dockerfile: Dockerfile-dev
    image: 'liyo'
    hostname: liyo
    container_name: liyo
    ports:
      - "1004:1004"
    user: root
    volumes:
      - "./log:/opt/app/log"
    networks:
      backend:
        aliases:
          - "liyo"
          
networks:
  backend:
    driver: bridge
    external: true
    internal: true

오류 발생 시점 사용하고 있던 docker-compose.yml 파일입니다.

 

services:
  backservice-beusr:
    build:
      context: .
      dockerfile: Dockerfile-dev
    image: 'liyo'
    hostname: liyo
    container_name: liyo
    ports:
      - "1004:1004"
    user: root
    volumes:
      - "./log:/opt/app/log"
    networks:
      backend:
        aliases:
          - "liyo"
          
networks:
  backend:
    driver: bridge
    external: true
    internal: true

첫 번째 라인의 version을 지워주었습니다.

D:\Docker\liyo>docker-compose up -d --build
request returned Internal Server Error for API route and version 
http://%2F%2F.%2Fpipe%2FdockerDesktopLinuxEngine/v1.46/containers/json?
all=1&filters=%7B%22label%22%3A%7B%22com.docker.compose.config-hash%22%3Atrue%2C%22com.docker.compose.project%3Dbearvd%22%3Atrue%7D%7D, check if the server supports the requested API version

D:\Docker\liyo>

 

version 을 없앤 후 빌드를 돌려보니, request returned Internal Server Error for API route and version 오류가 발생하였습니다.

 

Docker Compose는 Docker 데몬의 API 버전 1.46을 요청했지만, 데몬이 이 버전을 지원하지 않는 것으로 보입니다.

이로 인해 Docker Compose가 컨테이너 목록을 가져오는 API 요청에 실패했고, 내부 서버 오류(Internal Server Error)가 발생했습니다.

 

윈도우 운영체제가 업데이트되면서 WSL 도 자동으로 업데이트되어야 하지만, 함께 업데이트되지 않아 호환성에 문제가 생긴 것 같습니다.

 

WSL 은 Windows 운영체제 내에서 Linux 배포판을 실행할 수 있게 해주는 기능입니다.

wsl --update

해당 명령어로 Windows Subsystem for Linux (WSL) 구성 요소를 업데이트해 주었습니다.

 

업데이트를 통한 작업은 아래와 같습니다.

1. WSL 구성 요소의 최신 버전으로 업데이트합니다.
2. 설치된 Linux 배포판의 커널 버전을 최신 버전으로 업데이트합니다.
3. WSL 관련 Windows 구성 요소를 최신 버전으로 업데이트합니다.

업데이트를 완료하니 도커에서 API 경로 및 버전에 대한 요청이 내부 서버 오류를 반환했습니다

Docker Desktop이 사용하는 WSL 배포판이 예기치 않게 종료되었습니다.

이는 일반적으로 외부 엔티티가 WSL을 종료(예: wsl --shutdown) 하기 때문에 발생합니다.

Docker Desktop을 다시 시작합니다. 

 

Restart를 통해 재시작해 주었습니다.

 

 

재 시작 후 빌드가 잘 돌아가는 모습입니다.