[docker] ubuntu 최신 릴리즈에서 docker-compose " Error while fetching server API version: HTTPConnection.request()" 오류 해결 방법

문제 발생

기존에 사용하던 버전에서 벗어나 Ubuntu 24.01 LTS 릴리즈를 이번에 nginx proxy manager 서버를 구축하는데에 사용하였다. docker-compose를 작성하여 올리려 했지만, 아래와 같은 오류가 출력되었다.

 

구글링 중, 우연히 해당 오류에 대한 내용이 Ubuntu 개발자 포럼에서 이를 issue로 올린 게시글을 보고 해답을 찾았다. 따라서 이에 대한 해결 방법을 공유하고자 한다.

 

 

오류 내용

필자의 경우 아래 오류 본문이 출력되었다.

docker.errors.DockerException: Error while fetching server API version: HTTPConnection.request() got an unexpected keyword argument 'chunked'

root@aoi-no-proxy-server:/home/aoi# sudo docker-compose up -d
Traceback (most recent call last):
  File "/usr/bin/docker-compose", line 33, in <module>
    sys.exit(load_entry_point('docker-compose==1.29.2', 'console_scripts', 'docker-compose')())
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/lib/python3/dist-packages/compose/cli/main.py", line 81, in main
    command_func()
  File "/usr/lib/python3/dist-packages/compose/cli/main.py", line 200, in perform_command
    project = project_from_options('.', options)
              ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/lib/python3/dist-packages/compose/cli/command.py", line 60, in project_from_options
    return get_project(
           ^^^^^^^^^^^^
  File "/usr/lib/python3/dist-packages/compose/cli/command.py", line 152, in get_project
    client = get_client(
             ^^^^^^^^^^^
  File "/usr/lib/python3/dist-packages/compose/cli/docker_client.py", line 41, in get_client
    client = docker_client(
             ^^^^^^^^^^^^^^
  File "/usr/lib/python3/dist-packages/compose/cli/docker_client.py", line 170, in docker_client
    client = APIClient(use_ssh_client=not use_paramiko_ssh, **kwargs)
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/lib/python3/dist-packages/docker/api/client.py", line 197, in __init__
    self._version = self._retrieve_server_version()
                    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/lib/python3/dist-packages/docker/api/client.py", line 221, in _retrieve_server_version
    raise DockerException(
docker.errors.DockerException: Error while fetching server API version: HTTPConnection.request() got an unexpected keyword argument 'chunked'

 

 

일부 포럼에서는 python3-urllib 라이브러리와 python3-requests 모듈의 부재로 인해 야기된다고 주장하여 확인해봤다.

apt list --installed | grep python3-requests
apt list --installed | grep python3-urllib3

하지만, 해당 라이브러리들은 이미 시스템에 잘 설치되어 있었다.

 

 

해결 방법

 

구글링 중, 아래 게시글을 찾았다.

https://bugs.launchpad.net/ubuntu/+source/docker-compose/+bug/2056735

Bug #2056735 “docker.errors.DockerException: Error while fetchin... : Bugs : docker-compose package : Ubuntu

 

한 유저가 " python3-compose의 버그이고 패키지 중 하나의 비호환성과 관련이 있다고 생각한다" 라고 작성했다. 그리고 추가로, docker-compose 명령이 아닌, docker compose 명령으로  실행하면 잘 작동한다고 한다.

 

해보니깐 잘 됐다는 거.... Launchpad 에서도 이를 심각하다고 인지하여 Issue 상태를 Bug로 격상하였다고 한다