WSL2 환경설정

[WSL 공식문서], [WSL 개발 환경 설정]

Step1. 윈도우에서 WSL 활성화

1. Window + S 단축키를 누르면, 검색 기능이 활성화 됩니다.서
2. 검색어로 < 윈도우 기능 > 키워드 입력하면 
3. 검색된 < Windows 기능 켜기 끄기 > 를 실행합니다.
4. < 가상 머신 플랫폼 >, 체크 ✔ 하여 활성화합니다.
5.  < Linux용 Windows 하위 시스템 >  체크 ✔ 하여 활성화합니다.
6. OK 를 누릅니다.
7. 자동으로 WSL에 필요한 윈도우 기능이 설치됩니다.
8. 윈도우를 재부팅합니다. 

 

Step 2. 최신 WSL2 설정 

2.1 아래 링크로 이동하여 최신 WSL2 Linux Kernel Update 설치합니다.

 

이전 버전 WSL의 수동 설치 단계 | Microsoft Learn

이전 버전 WSL의 수동 설치 단계

 

 

 

 

2.2 powershell 을 <관리자 모드>로 실행합니다.

 

 

 

 

2.3 powershell 에 < WSL 버전 2 설정 > 명령어 입력합니다.

 

wsl --set-default-version 2

 

 

Step 3. WSL2 기본 리눅스 배포판 설치

3.1 powershell 에서 wsl 설치 명령어 입력합니다.

 

wsl --install

 

 

 

 

3.2 WSL의 기본 리눅스 배포판인 Ubuntu 설치가 완료되면, 사용할 계정의 ID와 PW를 입력합니다.

 

 

Step 4. (선택) 특정 리눅스 배포판 설치

4.1 파워쉘에서 설치 가능한 <리눅스 배포판> 확인합니다.

 

wsl --list --online

 

 

 

 

 

4.2  <Ubuntu 배포판> 설치 명령어 입력합니다.

 

wsl --install -d Ubuntu

 

-d 옵션은 default 로 기본으로 실행될 배포판을 설정하는 옵션 명령어입니다.
-d 옵션을 제외하면 기존에 설치된 배포판이 기본으로 유지됩니다.

 

 

 

 

 

4.3 설치된  <리눅스 배포판, WSL 버전> 확인

wsl -l -v

 

 

 

 

 

4.4 설치된  <Ubuntu 배포판 > 실행

 

▶ 정상적으로 설치 되면, 설치된 Ubuntu 배포판의 터미널이 자동 실행됩니다.

▶ Ubuntu 에서 사용 할 ID, PW 입력

▶ WSL - Ubuntu  배포판이 정상 실행됩니다.

 

 

▶ 설치한 Ubuntu가 자동 실행되지 않는다면, 이전 단계에서 설치한 Ubuntu 배포판을 찾아서 실행합니다. 

 

 

▶ 배포판을 삭제하는 방법

 

파워쉘 관리자 모드에서 명령어를 입력합니다.

wsl --unregister <설치된 배포판 이름>

 

 

Step 5. Windows Terminal 에서 WSL 실행

Windows Terminal은 2023년 5월 23일 업데이트 KB5026435 이후
Windows 11 및 Windows 10 22H2 이상에서 설치 가능합니다.

 

1. window 키 눌러서, 검색 활성화 
2.  "store" 키워드 입력 후, 
3. "Microsoft Store" 실행
4. store 에서 "windows terminal " 키워드 입력 후,
5. "windows terminal" 설치 후 실행
6. 새 터미널 열기 🔽
7. 설치한 Ubuntu 선택
8. WSL 이 실행 됩니다.

 

 

 

Step 6. Windows Terminal 에서 Ubuntu 를 기본 프로필로 설정

윈도우즈 터미널을 실행하면, 선택한 WSL 배포판이 기본으로 실행되도록 설정합니다.

 

 

 

 

 

 

요약

>> PowerShell 관리자 권한으로 실행

>> 아래 명령어 실행

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

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

 wsl --install

 

>> 윈도우 재부팅

>> 윈도우 실행되면 우분투 자동 설치 진행도

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux

wsl --set-default-version 2

 

>> ubuntu 앱 실행

sudo apt update && sudo apt-mark hold acpid acpi-support && sudo apt upgrade -y

sudo apt install -y build-essential ca-certificates

< Error > "WSL 2에 커널 구성 요소 업데이트가 필요합니다." 해결 방법

아래와 같은 문제가 발생하면,  WSL2 Linux Kernel Update 를 설치하여 해결한다.

< Error > failed with error: 0x800701bc 해결 방법

아래 에러 코드와 동일한 문제가 발생하면,

 

 

 

아래 링크를 통해 WSL2 Linux Kernel Update 를 설치 후 리눅스 배포판을 설치한다.

 

이전 버전 WSL의 수동 설치 단계 | Microsoft Learn

이전 버전 WSL의 수동 설치 단계