🐳 Ubuntu에 Docker 설치하기: 초보자를 위한 완벽 가이드 🐳

🔍 Docker란?

컨테이너 기반 가상화 플랫폼으로, “한 번 만들면 어디서든 실행 가능” 한 환경을 제공합니다.
✅ 전통적 가상화(VM)보다 경량화되어 빠르게 실행
✅ 애플리케이션 배포 및 관리 간소화
✅ 개발/테스트/운영 환경 일관성 보장

⚙️ 설치 전 준비사항

1. Ubuntu 버전 확인 (20.04 LTS 이상 권장)

   lsb_release -a

   

2. 저장소 업데이트

   sudo apt update && sudo apt upgrade -y

🚀 Docker 설치 단계별 가이드

1️⃣ 이전 Docker 제거 (선택)

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

2️⃣ 필수 패키지 설치

sudo apt install -y ca-certificates curl gnupg lsb-release

3️⃣ Docker 공식 GPG 키 추가 🔑

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

4️⃣ 저장소 설정 📦

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

5️⃣ Docker 엔진 설치

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

6️⃣ 설치 확인 🎉

sudo docker run hello-world

✅ 성공 시 출력

Hello from Docker!  
This message shows your installation appears to be working correctly.

⚡ 사용자 권한 설정 (매번 sudo 방지)

sudo usermod -aG docker $USER  # 현재 사용자 docker 그룹 추가
newgrp docker                  # 그룹 설정 즉시 적용

✏️ 재부팅 없이 적용: newgrp docker 또는 터미널 재실행

🛠️ 유용한 추가 설정

🔄 Docker 자동 시작 활성화

sudo systemctl enable docker.service
sudo systemctl enable containerd.service

🔄 Docker 서비스 제어

sudo systemctl start docker    # 시작
sudo systemctl stop docker     # 정지
sudo systemctl restart docker  # 재시작

ℹ️ 버전 확인

docker --version        # Docker 버전
docker compose version  # Compose 플러그인 버전

🧪 설치 테스트: Nginx 컨테이너 실행

docker run -d -p 8080:80 --name my-nginx nginx

1. 브라우저에서 http://localhost:8080 접속
2. “Welcome to nginx!” 확인
3. 컨테이너 정지 및 삭제:

   docker stop my-nginx && docker rm my-nginx

❌ 문제 해결 팁

• “Permission denied” 오류:

  sudo chmod 666 /var/run/docker.sock  # 임시 해결 (보안 주의!)

  → 영구적 해결: 사용자 재로그인 또는 newgrp docker 실행

• GPG 키 오류: 저장소 추가 후 sudo apt update 재실행

✅ 마무리 체크리스트

• [ ] hello-world 컨테이너 실행 성공
• [ ] 사용자 권한 그룹 추가 완료
• [ ] Nginx 테스트 컨테이너 정상 작동
• [ ] Docker 서비스 자동 시작 활성화

> 📢 Docker의 힘을 느껴보세요!
> 개발 환경 설정 5분 ➜ 프로덕션 배포 1초 😎
> bash > # 예시: MySQL 컨테이너 실행 > docker run -d -p 3306:3306 -e MYSQL_ROOT_PASSWORD=my-secret-pw --name my-db mysql:8.0 >

컨테이너 여정이 시작되었습니다 🚢
Ubuntu + Docker 조합으로 효율적인 개발 환경을 구축해 보세요!