우분투에 Docker 설치하기

startingfindmistake·2025년 12월 14일

우분투에 Docker를 설치해보자

첫번째로 현재 우분투에 Docker가 설치되어 있는지 확인해보자

sudo docker run hello-world

output

sudo: docker: command not found

찾을수 없다고 나온다.




공식 문서를 보면은 혹시 모를 미리 설치된 도커 파일이 충돌하는 패키지를 제거하기 위해 다음 명령을 실행한다.

sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc podman-docker containerd runc | cut -f1)



Docker 저장소(Repository)설정

Docker를 설치하기 위해 필요한 필수 패키지를 설치하고, 공식 GPG키 (보안키)를 등록합니다.



  1. apt패키지 인덱스 업데이트 및 필수 패키지 설치
# apt 업데이트
sudo apt-get update

# 필수 패키지 설치
sudo apt-get install ca-certificates curl


  1. Docker 공식 GPG키 등록
# keyrings 디렉토리 생성
$ sudo install -m 0755 -d /etc/apt/keyrings

# GPG 키 다운로드 및 저장
$ 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


  1. 소스 리스트에 Docker 저장소 추가
$ sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Signed-By: /etc/apt/keyrings/docker.asc
EOF


  1. 저장소가 추가되었으므로 apt를 다시 업데이트 한다.
$ sudo apt update



  1. Docker패키지를 최신버전으로 설치한다.(Docker Engine, CLI, Containerd, 플로그인 등)
$ sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin


메모
Docker서비스는 설치 후 자동으로 시작됩니다.
Docker가 실행중인지 확인하려면 다음 명령어를 입력해보자

$ sudo systemctl status docker

실행중인게 확인되면 초록색으로 active(running)으로 표시가 된다.




일부 시스템에서는 이 기능이 비활성화되어 있을 수 있으며,
수동으로 시작해야 할 수 있습니다.

$  sudo systemctl start docker


  1. Docker가 잘 설치되어 있는지 확인하기 위해 Docker 이미지를 실행하여 설치가 성공적으로 완료되었는지 확인한다.
 sudo docker run hello-world

설치가 잘 완료되었다면 아래 문구가 output으로 나온다

Hello from Docker!
This message shows that your installation appears to be working correctly.
profile
도움이되었다면 그것으로 충분 합니다.

0개의 댓글