Docker(5) 윈도우에 WSL2 설치하기

Updated 06/03/24

 

 

 

맥북과 같은 도커기반 개발환경을 구축하기 위해서 리눅스로 개발환경 세팅 중이다.

 

지난 시간에는 윈도우에 터미널을 깔고 리눅스(Ubuntu)를 설치하였으니,

이번에는 도커를 실행할 수 있도록 WSL2 설치를 해보자. ( 지난포스팅 보기 ↓↓↓ )

Docker - 윈도우에서 리눅스 환경 세팅하기

 

WSL2 란

Windows Subsystem for Linux 2의 줄임말이다.

윈도우의 가상화 기능을 활용해서 윈도우 위에서 리눅스를 사용할 수 있게 해준다.

기존 Windows 10 Home 에디션에서는 가상화 기능들을 지원하지 않아 Docker Desktop 을 사용할 수 없었는데,

WSL2가 릴리스되면서 Windows 10 Home 에디션 / 11 에서도 Docker Desktop을 사용할 수 있다.

 

---

Docker - 윈도우에  WSL2 설치하기

 

 

 

1. 윈도우 OS 버전을 확인한다. 윈도우 10에서는 버전이 20H1, 20H2, 21H1 보다 높아야 한다.

 

2. 터미널을 관리자 권한으로 실행해준다.

 

3. DISM으로 WSL 관련 기능 활성화를 위해 다음 명령어를 실행해준다.

 

- Microsoft-Windows-Subsystem-Linux 기능을 활성화 시키자.

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

 

- VirtualMachinePlatform 기능을 활성화 시키자.

$ dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

 

4. ubuntu  설치를 해야된다. 나는 microsoft store  에서 LTS 로  다운받아 설치해주었다.

요기서 최신버전을 받았다

 

참고로 파일을 실행하면  username  과  passoword  를 입력해줘야한다

그리고 username / password 설정해주자

 

5. 다음으로 WSL2 Linux 커널 업데이트를 진행하자. 마이크로소프트에서 패키지 다운로드를 해준다.

https://docs.microsoft.com/ko-kr/windows/wsl/install-manual

 

 

6. 버전 확인하는 명령어로 리눅스 설치가 잘 되었는 지 살펴보자.

$ wsl -l -v

 

- 터미널을 확인해보니 version이 1이다. 최근 업데이트 된 버전은 2이므로 버전을 2로 변경해주자.

 

 

**  만약 이때 에러가 난다면? 아래 포스팅을 참고해보자

WSL2 실행에러 - this update only applies to machines with the windows subsystem for linux

 

 

6. 명령어에는 본인에게 맞는 Ubuntu버전까지 붙이고, 끝에는 2를 붙여준다.

 $ wsl --set-version Ubuntu-18.04 2

 

- 그럼 변환이 완료 되었다는 메시지가 나올 것이다. 이렇게 성공적으로 설치 되었다!

 

 

 

 

** 만약 아래 메시지와 함께 변환이 안된다면, 재부팅시 bios 에 진입해서 가상화 기능을 켜줘야 한다. 

(나의 경우, asus 사이트를 참고하여 실행하였다.)

가상 머신 플랫폼 Windows 기능을 사용하도록 설정하고 BIOS에서 가상화를 사용하도록 설정되어 있는지 확인하세요.

[Motherboard] How to enable AMD virtualization in the BIOS | Official Support | ASUS Global

 

 

 

 

ref: https://engpro.tistory.com/9

ref: https://docs.microsoft.com/ko-kr/windows/wsl/install-manual