🐳 Docker 설치 가이드

IT 썸네일 이미지

🐳 Docker 설치 가이드 (Ubuntu 22.04 LTS 기준)

1. 시스템 준비

1. 패키지 업데이트
   명령어: sudo apt update && sudo apt upgrade -y
2. 필수 도구 설치
   명령어: sudo apt install -y ca-certificates curl gnupg lsb-release

 

---

 

2. 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

 

리포지토리 추가

명령어:

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

 

---

 

3. Docker 설치

 

명령어:

sudo apt update

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

 

 

---

 

4. 설치 확인

 

 명령어:

docker --version

docker compose version

 

예상 출력:

Docker version 25.0.3, build ...

Docker Compose version v2.24.6

 

---

 

5. 권한 설정 (sudo 없이 사용하기)

 

 

sudo usermod -aG docker $USER

newgrp docker

 

테스트:

docker run hello-world  → 성공 메시지가 나오면 정상 설치.

 

---

 

6. 서비스 관리

Docker 자동 시작 활성화:

sudo systemctl enable docker

sudo systemctl start docker

 

상태 확인:

systemctl status docker

 

📦 도커 설치 후 바로 쓰는 팁

1. 컨테이너 실행 예시 → 명령어: docker run -d -p 8080:80 nginx → http://서버IP:8080 접속 시 Nginx 환영 페이지 확인 

 

2. docker-compose.yml 예시 

version: "3.9"
services:
  web:
    image: nginx
    ports:
      - "8080:80"

→  실행 명령어:  docker compose up -d

 

3. 컨테이너/이미지 관리

docker ps -a       # 실행중인 컨테이너
docker images      # 다운로드된 이미지
docker logs web    # 로그 확인
docker stop web    # 중지
docker rm web      # 컨테이너 삭제

 

 

 

 

---

🐳 Windows용 Docker 설치 가이드

1. 시스템 요구사항

• Windows 10 64bit (Pro, Enterprise, Education, Build 1903 이상)
  또는 Windows 11
• CPU 가상화(VT-x/AMD-V) BIOS에서 활성화 필요
• 메모리: 최소 4GB 이상 (권장 8GB+)

 

---

 

2. 필수 준비

WSL2 활성화

 

PowerShell(관리자 권한)에서 실행:

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

 

재부팅

 

WSL2 기본 버전 설정

wsl --set-default-version 2

 

 

리눅스 배포판 설치 (Ubuntu 권장)

• Microsoft Store → "Ubuntu 22.04 LTS" 설치

좀더 자세한 정보를 알고 싶다면 밑에 링크를 클릭!

wsl을 이용한 리눅스 설치 가이드: https://learn.microsoft.com/ko-kr/windows/wsl/install

WSL 설치

 

---

 

3. Docker Desktop 설치

1. 공식 다운로드 페이지 접속
2. Windows용 Docker Desktop 다운로드 후 설치
3. 설치 시 옵션:
   • Use WSL2 instead of Hyper-V 체크
   • Install required Windows components for WSL 2 체크
4. 설치 완료 후 재부팅

 

---

 

4. 실행 및 확인

• Windows 시작 메뉴 → Docker Desktop 실행
• 트레이에 고래 아이콘 🐳 표시되면 정상 동작
• PowerShell/터미널에서 확인: 

docker --version
docker compose version

 

---

 

5. 기본 테스트

1. Hello World 실행→ 환영 메시지가 나오면 정상 동작
   docker run hello-world
2. Nginx 실행 예시→ 브라우저에서 http://localhost:8080 접속 시 Nginx 페이지 확인
   docker run -d -p 8080:80 nginx

 

---

 

6. docker-compose 사용

Windows Docker Desktop에는 Compose v2가 포함되어 있음.

 

docker-compose.yml 작성 후 실행:

version: "3.9"
services:
  web:
    image: nginx
    ports:
      - "8080:80"

 

 

실행:

docker compose up -d

 

---

 

7. 관리/설정 팁

• 리소스 제한: Docker Desktop → Settings → Resources → CPU/Memory 슬라이더로 조절
• WSL 통합: Settings → Resources → WSL Integration → Ubuntu 22.04 체크
• 자동 시작 방지: Settings → General → “Start Docker Desktop when you log in” 체크 해제
• 로그 보기: docker logs <컨테이너이름>