Windows 인스턴스에 WSL2 설치 시 문제

본 문서는 카카오클라우드 Windows 인스턴스에서 WSL2 버전을 설치 시 발생하는 문제의 원인과 해결 방법을 안내합니다.

WSL2 설치 시 오류 발생

Windows 인스턴스에서 WSL(Windows Subsystem for Linux) --install 명령어를 통해 WSL 설치 시, 기본적으로 WSL 2 버전이 설치됩니다.

WSL 2 버전은 중첩 가상화(Nested Virtualization)를 필요로 하며, 중첩된 가상화는 하드웨어에 직접 액세스할 수 있어야 합니다. 현재 카카오클라우드의 Virtual Machine 환경에서는 이러한 하드웨어 직접 액세스가 지원되지 않으므로, WSL 2를 지원하지 않습니다.

안내

본 가이드에서 안내하는 OS 배포판 설치는 Ubuntu 22.04를 예시로 합니다. 다른 OS 배포판 설치 시에도 동일한 문제가 발생할 수 있으며, 해결 방법은 동일합니다.

오류 메시지

WSL 2 환경에서 Ubuntu 배포판을 포함해 다른 OS 배포판 설치 시, 아래와 같은 오류 메시지가 발생하며 설치가 중단됩니다.
이 오류는 WSL 2 버전이 설치되어 발생합니다.

Ubuntu 22.04 배포판 설치 실패
설치 중: Ubuntu 22.04
Installing, this may take a few minutes...
WslRegisterDistribution failed with error: 0x80370102
Please enable the Virtual Machine Platform Windows feature and ensure virtualization is enabled in the BIOS.
For information please visit https://aka.ms/enablevirtualization
Press any key to continue...
배포 'Ubuntu-22.04'에 대한 설치 프로세스가 종료 코드와 함께 실패했습니다. 1.
오류 코드: Wsl/InstallDistro/WSL_E_INSTALL_PROCESS_FAILED

해결 방법

설치된 WSL 버전을 WSL 1 버전으로 변경하고 Ubuntu 배포판을 재설치하면 문제를 해결할 수 있습니다.

다음 명령어를 사용하여 WSL이 현재 어떤 버전인지 확인합니다. 기본 버전이 2로 표시된다면 WSL 2가 활성화된 상태입니다.
WSL 버전 확인 방법
```
wsl --status
```
출력 결과
```
기본 버전: 2 
```
WSL 버전을 WSL 2에서 WSL 1로 변경합니다.
WSL 버전 변경
```
wsl --set-default-version 1
```
출력 결과
```
작업을 완료했습니다.
```

변경된 버전으로 오류가 발생했던 Ubuntu 22.04 배포판을 재설치합니다.

Ubuntu 22.04 배포판 설치
wsl --install -d Ubuntu-22.04

출력 결과(성공)
Ubuntu 22.04 LTS을(를) 시작하는 중...
Installing, this may take a few minutes...
Please create a default UNIX user account. The username does not need to match your Windows username.
For more information visit: https://aka.ms/wslusers
Enter new UNIX username: {user_name}
New password:
Retype new password:
passwd: password updated successfully

작업을 완료했습니다.
Installation successful!
To run a command as administrator (user "root"), use "sudo <command>".
See "man sudo_root" for details.

Welcome to Ubuntu 22.04.6 LTS (GNU/Linux 4.4.0-20348-Microsoft x86_64)
...<중략>

WSL2 설치 시 오류 발생​

오류 메시지​

해결 방법​

WSL2 설치 시 오류 발생

오류 메시지

해결 방법