Ubuntu에 Docker 및 Docker Compose V2 설치 완벽 가이드 🐳✨

D: Ubuntu에 Docker와 Docker Compose V2를 설치하는 방법을 단계별로 상세히 설명합니다! 개발 환경 구축을 위한 필수 가이드입니다.

🔍 시작 전 확인 사항

1. Ubuntu 버전: 20.04 LTS 또는 22.04 LTS 권장
2. 터미널 접근 권한: sudo 권한이 있는 사용자로 진행
3. 기존 Docker 삭제 (선택 사항):

   sudo apt-get remove docker docker-engine docker.io containerd runc

🚀 1. Docker 설치하기

(1) 필수 패키지 설치

저장소 설정을 위해 필요한 패키지를 설치합니다.

sudo apt-get update
sudo apt-get install ca-certificates curl gnupg lsb-release

(2) Docker 공식 GPG 키 추가

Docker의 공식 패키지 인증을 위해 키를 추가합니다.

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

(3) Docker 저장소 등록

안정적인 버전의 Docker를 설치하기 위해 저장소를 추가합니다.

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

(4) Docker 엔진 설치

저장소를 업데이트한 후 Docker를 설치합니다.

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

(5) 설치 확인

정상적으로 설치되었는지 확인합니다.

sudo docker run hello-world

✅ Hello from Docker! 메시지가 출력되면 성공!

📦 2. Docker Compose V2 설치

Docker Compose V2는 docker compose 명령어로 사용됩니다. (기존 docker-compose와 다름)

(1) Docker Compose V2 활성화

sudo apt-get install docker-compose-plugin

(2) 버전 확인

docker compose version

출력 예: Docker Compose version v2.17.2

(3) 기존 V1 삭제 (선택 사항)

sudo apt-get remove docker-compose

⚙️ 3. Docker 권한 설정 (선택 사항)

기본적으로 Docker는 sudo 권한이 필요합니다. 사용자 계정에 권한을 부여하려면:

sudo usermod -aG docker $USER

🔄 재로그인 필요! (터미널 재시작 또는 newgrp docker 실행)

🚀 4. Docker Compose 예제 실행해보기

간단한 docker-compose.yml 파일로 테스트해보세요!

(1) 예제 파일 생성

mkdir test-docker-compose && cd test-docker-compose
nano docker-compose.yml

다음 내용을 붙여넣기:

version: "3.8"
services:
  web:
    image: nginx:alpine
    ports:
      - "8080:80"
  redis:
    image: redis:alpine

(2) 서비스 실행

docker compose up -d

(3) 실행 중인 컨테이너 확인

docker compose ps

✅ nginx와 redis 컨테이너가 실행 중이어야 합니다.

(4) 접속 테스트

브라우저에서 http://localhost:8080 접속 → Nginx 기본 페이지 확인!

💡 5. 자주 묻는 질문 (FAQ)

❓ Q1. docker compose vs docker-compose 차이점?
👉 Docker Compose V2는 Go로 작성되었고, docker CLI에 통합되었습니다. 성능이 개선되었으며 향후 V1은 지원 중단될 예정입니다.

❓ Q2. Permission denied 오류가 발생해요.
👉 sudo를 사용하거나 사용자를 docker 그룹에 추가하세요.

❓ Q3. Docker Compose 파일 버전 호환성?
👉 대부분의 V1 compose 파일은 V2에서 호환됩니다.

🎉 마무리

이제 Ubuntu에서 Docker와 Docker Compose V2를 성공적으로 설치했습니다! 🎊 컨테이너 기반 개발을 시작해보세요.

📢 참고: 공식 문서에서 최신 정보 확인하기

• Docker 설치 가이드
• Docker Compose V2 문서

질문이 있다면 댓글로 남겨주세요! 😊