[Docker] 리눅스에서 도커 설치하기 (with. Ubuntu 24.04 LTS)

 

 

리눅스 배포판 중 하나인 Ubuntu에서 도커를 설치하는 방법에 대해 정리한 글입니다.

---

🖥️ 시스템 환경

• 호스트 운영체제 : Windows 11 Pro
• 가상 머신 소프트웨어 : VMware Workstation Pro 17
• 게스트 운영체제 : Ubuntu 24.04.2 LTS

윈도우에 도커를 바로 설치할 수도 있지만, 도커의 Hyper-v와 가상 머신 소프트웨어(ex. VMware, VirtualBox 등) 간의 충돌이 있을 수 있다하여 가상 머신에 설치한 Ubuntu에서 설치를 진행하였습니다.

---

🛠️ 도커 리눅스 버전 설치

만약, 리눅스 배포판 종류가 Ubuntu가 아니라면, 도커 공식문서를 참고하여 설치를 진행하시면 됩니다.

Install

 

리눅스 패키지 업데이트를 진행한다.

sudo apt update

도커 설치 및 운영에 필요한 패키지를 설치한다. (HTTPS 모듈, 인증서 모듈, 소프트웨어 모듈 등을 모두 설치)

sudo apt install apt-transport-https ca-certificates curl software-properties-common

• apt-transport-https : APT에서 HTTPS 프로토콜을 통한 패키지 저장소 접근을 가능하게 해주는 패키지
• ca-certificates : 시스템에서 신뢰하는 CA(Certificate Authority, 인증 기관)들의 SSL 인증서를 관리하는 패키지
• curl : 다양한 프로토콜(HTTP, HTTPS, FTP 등)을 지원하는 명령줄 기반 파일 전송 도구
• software-properties-common : 소프트웨어 저장소(PPA 등)를 쉽게 추가 및 관리할 수 있도록 도와주는 명령어 집합

설치가 완료되면, 도커의 GPG 키를 시스템에 등록한다. GPG 키는 다운로드 받은 도커 이미지가 중간에 변조된 내용 없이 올바른 버전인지를 확인하는 과정에서 사용된다.

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

GPG 키
GPG는 GNU Privacy Guard의 약자로, 공개키 암호화 방식을 활용해 파일, 메시지, 소프트웨어 등 여러 데이터의 서명(sign)과 암호화(encrypt)를 할 수 있게 하는 도구이다. 여기서 GPG 키는 패키지 저장소의 소프트웨어가 "신뢰할 수 있는지"를 검증하는 데 사용되는 공개키를 의미한다.

다음은 도커 저장소를 추가한다.

echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

도커 저장소가 추가되면, 다시 한 번 패키지 데이터 업데이트를 진행한다.

sudo apt update

그리고 도커와 도커 필수 패키지를 설치한다.

sudo apt install docker-ce docker-ce-cli containerd.io

• docker-ce : Docker Community Edition (도커 엔진, 컨테이너 실행/관리 핵심)
• docker-ce-cli : 도커 명령줄 클라이언트 (docker 명령어)
• containerd.io : 컨테이너 런타임 (도커 내부적으로 사용하는 핵심 컴포넌트)

설치가 완료되면, 도커 서비스를 시작하고 부팅 시 자동 시작을 활성화한다.

sudo systemctl start docker
sudo systemctl enable docker

도커 명령어를 사용할 때, sudo를 사용하지 않기 위해서 현재 사용자를 도커 그룹에 추가하고 도커 그룹 권한을 적용한다. (필수는 아니지만, 사용자를 도커 그룹에 추가하지 않으면 도커 명령어를 사용할 때마다 sudo를 반드시 앞에 붙여줘야 함)

sudo usermod -aG docker $USER
newgrp docker

도커가 정상적으로 설치되었는지 확인한다. (25.06.19. 기준 28.2.2 버전 설치)

docker --version

---