Windows WSL2 환경에서 Docker 사용하기

WSL2 설치 및 설정

WSL2 활성화

cmd 혹은 PowerShell을 관리자 권한으로 열고 다음 명령을 실행하여 WSL과 가상화를 활성화합니다.

# WSL 활성화
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# WSL2 활성화
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

완료 후 컴퓨터를 재부팅합니다.

WSL2 기본 버전 설정

기본 WSL 버전을 WSL2로 설정하려면 다음 명령을 실행하세요

wsl --set-default-version 2

Linux 배포판 설치

참조

# wsl --list --online
# wsl --install --distribution Ubuntu
wsl --install
exit
wsl --set-default-version 2

wsl -l -v
---------------------
  NAME                   STATE           VERSION
* docker-desktop         Running         2
  docker-desktop-data    Running         2
  Ubuntu                 Stopped         2

Docker Desktop 설치

• Docker Desktop 공식 홈페이지 에서 Docker Desktop for Windows를 다운로드하여 설치합니다.

• 설치 완료 후, Docker Desktop을 실행합니다.

Docker와 WSL 통합 활성화

Docker Desktop에서 WSL2 Linux 배포판과 통합되도록 설정합니다:

• Docker Desktop 실행 후, 오른쪽 상단의 톱니바퀴 아이콘(설정)을 클릭합니다.
• "Resources" -> "WSL Integration" 메뉴로 이동합니다.
• Docker와 통합할 WSL2 배포판(Ubuntu 등)을 선택하고 "Apply & Restart"를 클릭합니다.

WSL2에서 Docker 사용 확인

• WSL2 터미널(Ubuntu 등)을 열고 아래 명령어로 Docker가 정상적으로 동작하는지 확인합니다.

docker --version

• Docker의 hello-world 이미지를 실행하여 제대로 설정되었는지 테스트합니다.

docker run hello-world