Docker 에러, Virtual Machine Platform not enabled 해결 방법

Docker 에러, Virtual Machine Platform not enabled 해결 방법

 

필자는 Oracle Database를 Docker 기반으로 실행하고 있습니다. Spring 웹 애플리케이션을 구동하기 위해 Docker를 실행하여 Oracle 23c Container를 구동하려고 했는데, Docker를 실행하자마자 'Virtual Machine Platform not enabled' 에러가 발생하면서 Docker 구동이 되지 않았습니다. IT 지식이 많지 않거나 에러의 원인을 유추할 수 있을 상황이나 경험이 없다면 당황하게 될 일입니다. 필자는 리눅스 입문 글 작성 시, 사용했던 'Rocky Linux' 구동 설정 때 Rocky Linux 설치 화면이 구동되지 않아 몇몇 가상화 설정을 'Off'로 비활성화했던 부분이 문제가 되어 Docker 실행에 문제가 있었습니다. 가상화 설정에 대한 부분을 건드렸기 때문에 유추할 수 있지만, 아무것도 건드리지 않고 정상적으로 구동되던 Docker가 갑자기 구동되지 않다면 상황을 유추하기가 참 애매해 더 당황할 것입니다. 그래서, Docker 구동 시, 'Virtual Machine Platform not enabled' 에러가 발생했을 때 당황하지 않고 차례차례 해결해 나갈 수 있도록 해결 방법에 대해서 알아보고자 합니다.

 

 

 

 

 

Virtual Machine Platform not enabled 에러 발생 원인

 

Docker Desktop은 윈도우 환경에서 리눅스를 돌리기 위해 'WSL 2(Windows Subsystem for Linux)'라는 기술을 사용하는데, 이 기술이 작동하기 위한 하드웨어적, 소프트웨어적 준비가 안되어 있을 때 발생합니다. 

 

Windows 기능 설정 누락 (소프트웨어적 원인)

윈도우 내부 설정에서 가상 머신을 구동할 수 있는 기능(Virtual Machine Platform, Windows Subsystem for Linux)이 꺼져 있는 경우입니다.

• Virtual Machine Platform (가상 머신 플랫폼)
  WSL 2를 실행하기 위한 핵심 기능입니다.
• Windows Subsystem for Linux (Linux용 Windows 하위 시스템)
  윈도우에서 리눅스 커널을 돌리기 위한 기능입니다.

 

 

BIOS/UEFI 가상화 비활성화 (하드웨어적 원인)

윈도우 설정이 제대로 되어 있어도, 메인보드(BIOS) 수준에서 CPU의 가상화 기술(Intell CPU, AMD CPU)이 꺼져 있으면 윈도우가 이 기능을 사용할 수 없습니다.

• Intel CPU : Intel Virtualization Technology (VT-x)
• AMD CPU : SVM Mode
• 확인 방법
  작업 관리자 (Crtl + Shift + Esc) > 성능 탭 > CPU 항목에서 '가상화: 사용' 확인

 

 

하이퍼바이저 부팅 설정 문제

간혹 시스템 부팅 시 하이퍼바이저(가상화 문제)가 자동으로 로드되도록 설정되지 않은 경우입니다. 이 경우 윈도우 기능이 켜져 있어도 Docker는 가상화 엔진을 찾지 못해 에러를 발생시킬 수 있습니다.

 

 

 

 

 

에러 조치 방법

 

WSL 커널 업데이트

 

1.  'Windows PowerShell'을 관리자 권한으로 실행합니다. 실행 후, 'wsl --update' 명령어를 입력하여 wsl 업데이트를 진행합니다.

 

wsl --update

 

최신버전이 아닌 경우, 업데이트가 진행되며 최신 버전인 경우라면 'Linux용 Windows 하위 시스템 최신 버전이 이미 설치되어 있습니다.' 라는 메세지가 나타납니다.

 

 

 

 

 

Windows 기능 켜기 (설정 변경)

 

가장 먼저 윈도우 설정에서 가상화 플랫폼 기능을 활성화해야 합니다.

 

1.  윈도우 찾기에서 'Windiws 가능 켜기/끄기'를 검색 후 들어갑니다. 기능 켜기/끄기에서 'Linux용 Windows 하위 시스템'과 '가상 머신 플랫폼' 항목을 체크하고 확인 버튼을 클릭합니다. 그리고 이후 재부팅합니다.

 

 

 

 

 

 

---

해결 후 화면

 

위 두 가지 설정으로 가상 머신 에러로 인해 구동되지 않았던 Docker가 정상적으로 구동되는 걸 확인할 수 있습니다.

 

 

 

 

 

@Junesker

---