📌 Docker로 풀스택 환경 완전 구축하기 – 2편: Windows에서 Docker 사용 전 필수 설정

📅 날짜

2025-06-02

📝 학습 내용

✅ Windows에서 Docker 사용 전 필수 설정

Docker는 기본적으로 가상화 기술을 활용하기 때문에, Windows 환경에서는 몇 가지 설정이 필요합니다. 운영체제 버전에 따라 설정 방식이 다르므로 구분해서 살펴보겠습니다.

---

💻 Windows 10/11 Pro, Enterprise, Education (Hyper-V 지원)

🔹 Hyper-V 활성화

1. Windows 검색창에서 Windows 기능 켜기 또는 끄기 검색 → 실행
2. 목록에서 Hyper-V 체크
3. 하위 옵션도 자동 체크됨 (Hyper-V 플랫폼, Hyper-V 관리 도구 등)
4. 확인 후 재부팅

🔹 가상화 기술 BIOS에서 활성화 필요

• 일부 PC에서는 BIOS 설정에서 Intel VT-x 또는 AMD-V 활성화 필요

---

💻 Windows 10 Home (Hyper-V 미지원)

🔹 WSL2 설치 및 활성화

Windows 10 Home 에디션은 Hyper-V를 직접 사용할 수 없기 때문에, WSL2(Windows Subsystem for Linux v2) 를 사용해야 합니다.

🔹 설정 절차 요약

1. PowerShell(관리자 권한)에서 다음 명령 실행:

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

2. 재부팅 후 WSL2용 Linux 커널 업데이트 설치:

   • https://aka.ms/wsl2kernel

3. 기본 버전을 WSL2로 설정:

   wsl --set-default-version 2
   

4. Ubuntu 등의 배포판 설치 (Microsoft Store)

---

✅ Docker Desktop 설치

1. 공식 사이트에서 다운로드: https://www.docker.com/products/docker-desktop
2. 설치 시 다음 구성 요소 확인:
   • Use WSL 2 instead of Hyper-V (권장)
   • Add Docker to PATH
3. 설치 완료 후 Docker Desktop 실행
4. 설정 탭에서 사용할 backend (WSL2 or Hyper-V) 확인 가능

---

⚙️ Docker Desktop 설치 확인

docker --version
docker info

• 명령어로 정상 설치 여부 확인
• Docker 데몬이 실행 중인지 확인할 수 있음

---

🔥 정리

Windows에서는 Docker를 사용하기 위해 Hyper-V 또는 WSL2 기반 설정이 선행되어야 하며, Docker Desktop은 이를 자동 감지하여 적절한 환경으로 설치됩니다. 특히 Home 버전에서는 WSL2 설정이 필수이며, Docker Desktop이 실행 가능한 환경인지 확인하는 것이 중요합니다.

---

🔗 참고 자료

• Docker 공식 설치 가이드
• WSL2 공식 가이드

---