WSL2 Docker Engine 설치 가이드

# 가상화 지원 확인
systeminfo | findstr /i "Hyper-V"

# WSL 버전 확인
wsl --version

# WSL 및 가상 머신 플랫폼 활성화
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

# 재부팅 필요
Restart-Computer

# WSL 업데이트
wsl --update

# WSL2를 기본 버전으로 설정
wsl --set-default-version 2

# 사용 가능한 배포판 목록
wsl --list --online

# Ubuntu 24.04 설치
wsl --install -d Ubuntu-24.04

# 설치 확인
wsl -l -v

# 현재 버전 확인
wsl -l -v

# WSL2로 변환 (시간 소요)
wsl --set-version Ubuntu-24.04 2

# 변환 완료 확인
wsl -l -v

# PowerShell에서 실행
notepad "$env:USERPROFILE\.wslconfig"

[wsl2]
memory=4GB
swap=2GB
processors=2
localhostForwarding=true

[experimental]
autoMemoryReclaim=gradual
sparseVhd=true

wsl --shutdown
wsl -d Ubuntu-24.04

# 기존 Docker 관련 패키지 제거
sudo apt remove -y docker docker-engine docker.io containerd runc 2>/dev/null || true

# 잔여 파일 정리
sudo rm -rf /var/lib/docker
sudo rm -rf /var/lib/containerd

# 패키지 업데이트
sudo apt update

# 필수 패키지 설치
sudo apt install -y \
    ca-certificates \
    curl \
    gnupg \
    lsb-release

# GPG 키 디렉토리 생성
sudo install -m 0755 -d /etc/apt/keyrings

# Docker 공식 GPG 키 추가
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
    sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /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

# 패키지 인덱스 업데이트
sudo apt update

# Docker 패키지 설치
sudo apt install -y \
    docker-ce \
    docker-ce-cli \
    containerd.io \
    docker-buildx-plugin \
    docker-compose-plugin

# 버전 확인
docker --version
docker compose version

# /etc/wsl.conf 설정
sudo tee /etc/wsl.conf <<EOF
[boot]
systemd=true

[interop]
enabled=true
appendWindowsPath=true

[automount]
enabled=true
options="metadata,umask=22,fmask=11"
EOF

wsl --shutdown
wsl -d Ubuntu-24.04

# 현재 폴더를 Windows 탐색기로 열기
explorer.exe .

# VS Code로 현재 프로젝트 열기
code .

# 텍스트를 Windows 클립보드에 복사
echo "복사할 내용" | clip.exe
cat ~/.ssh/id_rsa.pub | clip.exe   # SSH 공개키 복사

# Windows 기본 브라우저로 URL 열기
cmd.exe /c start http://localhost:8080

# Windows 메모장으로 파일 편집
notepad.exe config.txt

# Docker 서비스 활성화 및 시작
sudo systemctl enable docker
sudo systemctl start docker

# 상태 확인
sudo systemctl status docker

# docker 그룹에 현재 사용자 추가
sudo usermod -aG docker $USER

# 변경사항 적용 (재로그인 또는)
newgrp docker

# 권한 확인
docker ps

# /etc/docker/daemon.json 생성
sudo tee /etc/docker/daemon.json <<EOF
{
    "log-driver": "json-file",
    "log-opts": {
        "max-size": "10m",
        "max-file": "3"
    },
    "storage-driver": "overlay2",
    "dns": ["8.8.8.8", "8.8.4.4"]
}
EOF

# Docker 재시작
sudo systemctl restart docker

# 이미지 목록 저장
docker images --format "{{.Repository}}:{{.Tag}}" | grep -v "<none>" > image_list.txt

# 개별 이미지 저장
docker save -o image_backup.tar <image_name>:<tag>

# 모든 이미지 한번에 저장 (시간 소요)
docker images --format "{{.Repository}}:{{.Tag}}" | grep -v "<none>" | \
    xargs docker save -o all_images.tar

# 볼륨 목록 확인
docker volume ls

# 볼륨 데이터 백업 (각 볼륨별)
docker run --rm \
    -v <volume_name>:/source:ro \
    -v /mnt/c/docker_backup:/backup \
    alpine tar cvf /backup/<volume_name>.tar -C /source .

# 이미지 로드
docker load -i /mnt/c/docker_backup/image_backup.tar

# 또는 모든 이미지
docker load -i /mnt/c/docker_backup/all_images.tar

# 이미지 확인
docker images

# 볼륨 생성
docker volume create <volume_name>

# 데이터 복원
docker run --rm \
    -v <volume_name>:/target \
    -v /mnt/c/docker_backup:/backup:ro \
    alpine sh -c "cd /target && tar xvf /backup/<volume_name>.tar"

# 확인
docker volume inspect <volume_name>

# Windows 설정 -> 앱 -> Docker Desktop 제거
# 또는
winget uninstall Docker.DockerDesktop

# 잔여 파일 정리 (선택)
Remove-Item -Recurse -Force "$env:APPDATA\Docker"
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\Docker"

# Docker 정보 확인
docker info

# 테스트 컨테이너 실행
docker run --rm hello-world

# 인터랙티브 테스트
docker run -it --rm alpine sh -c "echo 'Docker is working!'"

# 포트 바인딩 테스트
docker run -d --name nginx-test -p 8080:80 nginx

# Windows 브라우저에서 http://localhost:8080 접속 확인

# 정리
docker rm -f nginx-test

# Windows 경로 마운트 테스트
docker run --rm -v /mnt/c/Users:/host alpine ls /host

# Linux 경로 마운트 테스트
docker run --rm -v /tmp/test:/data alpine sh -c "echo 'test' > /data/test.txt && cat /data/test.txt"

# 테스트용 compose 파일 생성
cat > /tmp/docker-compose-test.yml <<EOF
services:
  web:
    image: nginx:alpine
    ports:
      - "8080:80"
  db:
    image: alpine
    command: sleep infinity
EOF

# 실행
docker compose -f /tmp/docker-compose-test.yml up -d

# 확인
docker compose -f /tmp/docker-compose-test.yml ps

# 정리
docker compose -f /tmp/docker-compose-test.yml down

# 로그 확인
sudo journalctl -u docker.service -n 50

# containerd 상태 확인
sudo systemctl status containerd

# 수동 시작 시도
sudo dockerd --debug

# docker 그룹 확인
groups $USER

# 그룹에 없으면 추가
sudo usermod -aG docker $USER

# 소켓 권한 확인
ls -la /var/run/docker.sock

# 임시 해결 (권장하지 않음)
sudo chmod 666 /var/run/docker.sock

# DNS 문제 시 daemon.json에 DNS 추가
sudo tee /etc/docker/daemon.json <<EOF
{
    "dns": ["8.8.8.8", "8.8.4.4"]
}
EOF
sudo systemctl restart docker

# 현재 메모리 사용량 확인
wsl -- free -h

# .wslconfig 수정 후
wsl --shutdown

# systemd가 PID 1인지 확인
ps -p 1 -o comm=

# 출력이 'init'이면 systemd가 아님
# /etc/wsl.conf 재설정 후 WSL 재시작

# 컨테이너 관리
docker ps -a                    # 모든 컨테이너 목록
docker logs -f <container>      # 로그 실시간 확인
docker exec -it <container> sh  # 컨테이너 접속
docker stats                    # 리소스 사용량 모니터링

# 이미지 관리
docker images                   # 이미지 목록
docker image prune -a           # 미사용 이미지 삭제
docker system df                # 디스크 사용량 확인

# 정리
docker system prune -a          # 미사용 리소스 전체 정리

wsl -l -v                       # 배포판 목록 및 버전
wsl --shutdown                  # WSL 종료
wsl -d Ubuntu-24.04             # 특정 배포판 시작
wsl --export Ubuntu-24.04 backup.tar  # 백업
wsl --import Ubuntu-restore C:\WSL backup.tar  # 복원

# ~/.bashrc에 추가
cat >> ~/.bashrc <<'EOF'

# Docker aliases
alias d='docker'
alias dc='docker compose'
alias dps='docker ps'
alias dpsa='docker ps -a'
alias di='docker images'
alias dex='docker exec -it'
alias dlog='docker logs -f'
alias dprune='docker system prune -af'
EOF

source ~/.bashrc

#!/bin/bash
# install_docker_wsl2.sh

set -e

echo "=== Docker Engine 설치 시작 ==="

# 기존 패키지 제거
sudo apt remove -y docker docker-engine docker.io containerd runc 2>/dev/null || true

# 필수 패키지 설치
sudo apt update
sudo apt install -y ca-certificates curl gnupg lsb-release

# Docker GPG 키 추가
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
    sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /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

# Docker 설치
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io \
    docker-buildx-plugin docker-compose-plugin

# 사용자 권한 설정
sudo usermod -aG docker $USER

# systemd 설정
sudo tee /etc/wsl.conf <<EOF
[boot]
systemd=true
EOF

echo "=== 설치 완료 ==="
echo "WSL을 재시작하세요: wsl --shutdown (PowerShell에서)"
echo "재시작 후: sudo systemctl enable --now docker"