docker 설치 중 WSL 관련 에러 해결기

도커를 설치한 후 MySQL 컨테이너를 실행하려 했지만, WSL2 환경 설정에서 문제가 발생했다.
wsl --update, wsl --install 등 공식 문서에 있는 명령어를 실행해도 오류가 계속됐다.

심지어 노트북 용량 간당간당해서 심각한 속도 이슈때문에 속 터질 뻔 했다 ㅠ

 

wsl 인식이 안 된다는 메세지도 나오고 이것저것 계속 하다보니

다음과 같은 에러 메시지가 출력되었다.

WSL 2 installation is incomplete.
Please install the kernel update package manually.

해당 메시지를 따라 커널 업데이트를 진행하려 했지만, 명령어만으로는 해결되지 않았다.
결국 WSL2를 수동으로 설치하여 문제를 해결 !!

(거의 4시간 걸렸다...............................)

해결 방법

1. 아래 링크에서 WSL2 커널 업데이트 패키지를 수동으로 다운로드한다.
   https://aka.ms/wsl2kernel
2. 설치 후 PowerShell을 관리자 권한으로 열어 다음 명령어를 실행한다.

wsl --set-default-version 2

1. 도커 데스크톱을 재시작하면, WSL2 기반 컨테이너가 정상적으로 실행된다.

정리

도커를 처음 설치할 때, wsl --install이나 --update만으로는 해결되지 않는 경우가 있다.
이럴 경우에는 커널 업데이트를 수동으로 설치하는 것이 가장 빠르고 정확한 해결 방법이다.