[Solved] 도커(Docker) buildx 설치 방법 on Ubuntu

 

이 글을 보시는 분이라면 Ubuntu에서 docker buildx가 동작하지 않으셨기 때문에 찾아오셨을 겁니다.

실망시키지 않고 무조건 해결되는 방법을 알려드리겠습니다.

 

아마 여러분은 buildx가 설치되지 않아 ChatGPT 한테도 물어본 결과 아래와 같은 답변을 얻으셨을 겁니다.

### Buildx에 대한 ChapGPT 답변 ###
mkdir -p ~/.docker/cli-plugins
curl -SL https://github.com/docker/buildx/releases/latest/download/buildx-linux.amd64 -o ~/.docker/cli-plugins/docker-buildx
chmod +x ~/.docker/cli-plugins/docker-buildx

### Docker buildx 설치 확인 ###
$ docker buildx version

 

결론적으로 위에 있는 ChatGPT의 정보는 틀린 정보입니다.

위 명령어를 입력한 후 docker buildx version 명령어를 입력하면 아래와 같이 명령어가 작동하지 않을 겁니다.

 

 

 

  해결 방법 - (Docker 공식 홈페이지 참조)

 

1. 기존 설치된 Docker 삭제

가장 먼저 해야할 일은 기존 Ubuntu에 설치되어 있는 Docker를 삭제해야 합니다.

해당 정보는 Docker 공식 홈페이지에 있는 내용을 참고하였습니다.

 

https://docs.docker.com/engine/install/ubuntu/

Ubuntu

 

아래 명령어를 입력하여 기존 설치된 도커를 삭제해 주세요

### Docker 삭제 명령어 ###
for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do sudo apt-get remove $pkg; done

 

 

 

2. Docker 설치

Docker 공식 홈페이지에 명시되어 있는 Ubuntu Docker 설치 방법을 그대로 따라서 입력합니다.

### 1. Set up Docker's apt repository. ###

# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

### 2. Install the Docker packages. ###
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

 

설치가 완료되면 정상 설치가 되었는지만 확인하면 됩니다.

 

 

3. 정상 설치 확인

docker buildx 명령어로 버전을 확인 해보면 정상적으로 설치되었는지 알 수 있습니다.

버전이 출력되면 정상적으로 설치된 겁니다.

(혹시!! 그래도 안된다면 4번 번외편을 참고해주세요)

docker buildx version

docker buildx 버전 확인-1

 

 

4. 번외편 - 그래도 안된다면...

docker --help 명령어를 입력했을 때 스크롤을 내리다 보면 아래 사진과 같이

buildx가 Invalid Plugins(잘못된 플러그인)이라는 메시지가 나오는 분들은 ~/.docker/cli-plugins 하위에 있는 docker-buildx 파일을 삭제해야 합니다.

 

docker-buildx 파일 삭제

cd ~/.docker/cli-plugins
rm docker-buildx

 

삭제 후 바로 version 확인을 해보면 정상 동작 하는 것을 확인할 수 있습니다.

docker buildx 버전 확인-2

 

 

이 글이 도움이 되셨기를 바랍니다.

 

내용이 유용하셨다면 좋아요&댓글 부탁드립니다.
이 블로그를 이끌어갈 수 있는 강력한 힘입니다!

 

caul334@gmail.com