이 포스팅에서는 Windows에서 아래의 시스템 사양을 만족하는 경우에 적합한 Docker 설치 방법을 작성하였습니다.
- Windows 11: Home / Pro / Enterprise / Education 모든 에디션에서 21H2 이상의 버전
- Windows 10: Home / Pro 에디션의 경우 21H2 (build 19044) 이상의 버전, Enterprise / Education 에디션의 경우 21H2 (build 19044) 이상의 버전
나의 PC 사양은 작업 표시줄의 왼쪽 하단 검색 창에 설정을 검색한 뒤 설정 앱을 열고, 시스템 > 정보 > Windows 사양 부분에 있는 1) 에디션, 2) 버전, 3) OS 빌드 세 가지를 확인하면 알 수 있습니다.
1. CPU Virtualization(가상화) 활성화
1.1. 바이오스 진입
WSL을 사용하기 위해서는 반드시 메인보드에서 CPU 가상화를 활성화해야 합니다. PC의 CPU 가상화 기능을 활성화하기 위해서는 바이오스(Basic Input/Output System, BIOS)에 진입해야 합니다. 바이오스는 사용자가 PC를 켜면 시작되는 프로그램으로 컴퓨터의 입출력을 처리하는 펌웨어입니다.
윈도우에서 바이오스에 진입하는 방법은 간단합니다. 먼저, PC 사양을 확인할 때처럼 설정 앱을 연 다음, 업데이트 및 보안 > 복구 > 고급 시작 옵션 부분에서 지금 다시 시작 버튼을 눌러주면 됩니다. 그러면 PC가 종료되는 것처럼 보이다가 아래와 같이 옵션을 선택할 수 있는 파란 화면이 나옵니다. 여기서 문제 해결 > 고급 옵션 > UEFI 펌웨어 설정 > 다시 시작 을 누르면 바이오스에 진입할 수 있습니다.
1.2. SVM Mode Enabled 변경
바이오스 진입 후에 보이는 인터페이스는 제조사마다 조금씩 다르고, CPU가 Intel인지 AMD인지에 따라 작업해 줘야 할 내용도 달라지기 때문에 본 포스팅과 같은 상황이 아니라면 다양한 자료를 참고하여 진행할 것을 권장합니다. 필자는 기가바이트 바이오스를 사용하고 있으며, CPU는 AMD Ryzen을 사용하고 있습니다.
- Advanced mode(고급 모드)로 진입 후, 상단 6개 탭 중 Tweaker > Advanced CPU Settings를 더블 클릭합니다.
- SVM Mode의 Disabled를 Enabled로 변경합니다.
- Save & Exit Setup(저장 후 종료)을 더블 클릭합니다.
1.3. CPU 가상화 활성 여부 확인
이렇게 메인보드에서 CPU 가상화를 활성화해주고 나면 작업 관리자에서 가상화 여부가 사용 안 함에서 사용으로 변경되는 것을 확인할 수 있습니다.
2. PowerShell 실행
작업 표시줄에 있는 왼쪽 하단 검색 창에 PowerShell을 입력한 뒤, Windows PowerShell 앱을 실행합니다. 관리자 권한으로 실행하고 싶다면 해당 앱을 마우스 우클릭한 다음, “관리자 권한으로 실행”을 클릭합니다. 이제 WSL 실행에 필요한 항목들을 설치할 것이기 때문에, 관리자 모드로 PowerShell을 실행합니다.
3. WSL 설치
3.1. WSL 설치 명령
실행한 터미널에 다음 명령어를 입력한 다음 컴퓨터를 다시 시작합니다. 이 명령은 WSL을 실행하고 Linux의 Ubuntu 배포를 설치하는 데 필요한 기능을 사용하도록 설정합니다.
wsl --install필자는 설치 과정에 약 40분 정도 소요되었으며 설치가 종료되었을 때 시스템을 다시 시작하라는 안내가 있었습니다. 설치가 완전히 끝나면 컴퓨터를 재부팅합니다.
기본적으로 WSL 2로 설치가 진행되며 wsl --set-version 명령을 사용하면 WLS 2에서 WLS 1로 다운그레이드하거나 반대로 업데이트 할 수 있습니다. 도커 설치를 위해서는 WSL 버전이 1.1.3.0 이상이어야 하기 때문에 WSL 2 설치를 권장합니다.
wsl --set-version <distribution name> <versionNumber>
# 사용 예시 <distribution name>: Linux 배포판 이름, <versionNumber>: WSL 버전
wsl --set-version Ubuntu-20.04 23.2. 실행 중인 WSL 버전 확인
PowerShell 또는 Windows 명령 프롬프트에서 다음 명령어를 입력하여 설치된 Linux 배포판과 WSL 버전을 확인할 수 있습니다.
wsl -l -v
3.3. Linux 사용자 이름 및 암호 설정
WSL 설치가 완료되면 작업 표시줄의 검색 창을 통해 Ubuntu 앱을 엽니다. Linux 배포판의 사용자 이름과 암호를 만들라는 메시지가 표시되며, 정상적으로 Ubuntu 터미널에 접속이 가능함을 확인할 수 있습니다.
4. Docker Desktop 설치
Windows 용 Docker Desktop 설치 프로그램(Docker Desktop Installer.exe)을 공식 페이지에서 다운로드 받습니다. 다운로드 받은 프로그램을 더블 클릭하여 실행한 다음, Use WSL 2 instead of Hyper-V 에 체크한 뒤 Ok 버튼을 누르면 설치가 시작됩니다. 설치가 모두 끝난 뒤 Close and log out 버튼을 누르면 윈도우 계정이 로그아웃됩니다.
작업 표시줄의 검색 창에 Docker Desktop을 검색한 뒤, 앱을 실행하고 로그인하면 정상적으로 설치가 된 것을 확인할 수 있습니다.
