반응형

 

이 글을 보시는 분이라면 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

Jumpstart your client-side server applications with Docker Engine on Ubuntu. This guide details prerequisites and multiple methods to install Docker Engine on Ubuntu.

docs.docker.com

 

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

### 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

반응형

'IT > Docker' 카테고리의 다른 글

[Docker] 도커 필수 명령어 원페이지 정리 노트  (8) 2022.03.17
반응형

 

도커를 처음 배우기 시작할 때 꼭 필요한 기본 명령어를 한페이지 분량으로 정리하였습니다.

아래 정리된 명령어 모음은 도커를 운영할 때 사용하시면 분명 도움이 될겁니다.

 

 

 

  현재 내가 가진 이미지 출력

1
docker images
cs

 

  이미지 다운로드 (hub에서 검색하여 이름 파악)

1
docker pull <이미지이름>:<tag>
cs

ex1) docker pull httpd
ex2) docker pull ubuntu:18.04

 

 

  이미지를 실행하여 컨테이너 만들기

1
2
# 기본 명령어
docker run <이미지이름>
cs

ex) docker run httpd

 

1
2
# 이름지정 옵션
docker run --name <컨테이너 이름> <이미지>
cs

ex) docker run --name ws1 httpd

 

1
2
# 포트포워딩 옵션
docker run -p <host포트>:<컨테이너포트> <이미지>
cs

ex) docker run -p 80:80 httpd

 

1
2
#호스트<->컨테이너간 파일시스템 연결 옵션
docker run -p 8080:80 -v <호스트폴더>:<컨테이너폴더> <이미지>
cs

ex) docker run -p 8080:80 -v ~/Desktop/htdocs:/usr/local/apache2/htdocs httpd

 

1
2
# 컨테이너 만들고 접속하기 ( /bin/bash 실행)
docker run --name <컨테이너 이름> -it <이미지>:<tag> /bin/bash
cs

ex) docker run --name ubuntu_18.04 -it ubuntu:18.04 /bin/bash

 

 

  실행중인 컨테이너 중지

1
2
docker stop <컨테이너 이름>
docker stop <컨테이너 ID>
cs

 

  정지된 컨테이너 재시작

1
2
docker start <컨테이너 이름>
docker start <컨테이너 ID>
cs

 

  컨테이너에 대한 log 출력하기

1
2
docker logs <컨테이너 이름>
docker logs -f <컨테이너 이름>          #실시간 로그보기
cs

 

  컨테이너에 삭제

1
2
docker rm <컨테이너 이름>        #중지 후 삭제할 수 있음
docker rm --force <컨테이너 이름>        #중지않아도 강제 삭제
cs

 

  이미지 삭제

1
docker rmi <이미지명>
cs

 

  실행중인 컨테이너 정보확인

1
2
docker ps
docker ps -a          #중지된 컨테이너까지 모두 확인할 때
cs

 

  커맨드라인 실행

1
docker exec <컨테이너명> <실행할 명령어>
cs

ex) docker exec ws1 pwd

 

1
2
#컨테이너로 접속하여 지속적으로 명령어를 쳐야할때
docker exec -it <컨테이너명> <shell종류>
cs

ex) docker exec -it ws1 /bin/sh

 

 

  Dockerfile을 통한 이미지 생성

1
docker build -t <생성할 이미지명>:<태그명> <Dockerfile위치>
cs

ex) docker build -t echotest:1.0 .\

 

 

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

caul334@gmail.com

 

 

반응형

'IT > Docker' 카테고리의 다른 글

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

+ Recent posts