Ubuntu에 Docker Engine 설치하기

APT repository를 활용하여 Ubuntu OS에 Docker Engine을 설치하는 방법에 대해 정리해보고자 한다.

OS 필수 사양 확인하기

우분투에서 도커를 사용하기 위해서는 다음의 우분투 버전을 사용해야 한다.

• Ubuntu Mantic 23.10
• Ubuntu Jammy 22.04 (LTS)
• Ubuntu Focal 20.04 (LTS)

+ 다른/이전 도커 버전 삭제하기

만약 도커 엔진을 설치하기 위해 다양한 삽질(..)을 했다면 깔끔하게 삭제를 해주면 된다.

for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do sudo apt-get remove $pkg; done

도커 엔진 설치하기

1. Docker의 패키지 저장소 설정하기: APT repository 사용

• 필요한 의존성 패키지 설치하기

sudo apt-get install ca-certificates curl

• 디렉토리 생성 및 권한 설정하기

# -m: 디렉토리/파일 의 권한 설정 옵션
# 0755:
#    - 읽기, 실행: 모든 사용자에게 권한 부여
#    - 쓰기: 소유자에게만 권한 부여
# -d: 디렉토리 생성 옵션
sudo install -m 0755 -d /etc/apt/keyrings

• 도커 공식 GPG 키 다운로드하기

# curl: url을 활용해 데이터를 가져와줘
# -f: 오류가 발생하더라도 오류메세지를 출력하지 말아줘 (silent 모드로 작동)
# -s: 진행사항을 표시하지 말아줘
# -S: 진행사항을 표시하지만 오류가 발생하면 오류메세지를 출력하지 말아줘
# -L: 서버가 리디렉션을 하는 경우 해당 리디렉션을 따라가줘
# -o: 다운로드 된 데이터를 저장할 파일의 경로지정 옵션
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc

• 다운로든 GPG 키 파일의 권한 설정하기

# a+r: 모든 사용자에게 읽기 권한을 부여할게
sudo chmod a+r /etc/apt/keyrings/docker.asc

• apt 소스에 레포지토리 추가하기

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

• 시스템 업데이트하기

sudo apt-get update

2. 도커 패키지 설치하기

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

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