Docker 설치 방법 및 오류 해결

WSL2 설치를 위한 사전 준비

시작 버튼 → 제어판 → 프로그램 및 기능 → Windows 기능 켜기/끄기

• .NET Framework 3.5 (includes .NET 2.0 and 3.0) 끄기
• Windows Hypervisor Platform 켜기
• Windows Subsystem for Linux 켜기
• Virtual Machine Platform 켜기

재부팅

 

cmd 창에 가서 다음 명령어 입력하기

wsl --update

wsl --install

 

설치된 ubuntu 열기

 

여기서 만약

wslregisterdistribution failed with error: 0x80370102

 

오류 발생 시 BIOS에 들어가서 설정을 바꿔줘야 한다.

 

원래는 위의 Windows 기능 켜기/끄기에서 Hyper-v를 켜줘야 하는데, 자신의 운영체제가 Windows 10/11 Home edition 이라면 해당 기능은 사용할 수 없다. 

 

에디션은 win+e -> winver 를 입력해서 확인이 가능하다.

 

 

BIOS는 컴퓨터 부팅될 때 Windows 실행 전 검은 화면에서 F2 또는 delete를 누르면 들어갈 수 있다.

 

BIOS -> Advanced -> CPU Configuration -> Intel Virtualization Technology => Enabled

(ASUS 기준)

 

재부팅 후 다시 ubuntu를 실행시켜보면 오류가 해결된다.

 

 

Ubuntu 22.04 에 최신 버전의 docker 설치

ubuntu를 실행하면 다음과 같은 화면이 뜬다. 원하는 username과 비밀번호를 입력하자.

 

lsb_release -a 명령어를 통해 설치된 버전을 확인할 수 있다. 다음과 같이 뜨면 정상적으로 설치된 것이다.

 

이제 아래의 명령어를 한 줄씩 입력하여 최신 버전의 docker를 설치한다.

# docker engine gpg 키 등록
sudo apt-get update
sudo apt-get install ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

# apt source 에 docker 관련 추가
echo \
  "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

# docker engine 설치
sudo apt-get install -y docker-ce docker-ce-cli containerd.io \
docker-buildx-plugin docker-compose-plugin docker-compose

# docker 그룹에 현재 계정을 등록하여 sudo 없이 docker 명령을 사용하게 함
sudo usermod -aG docker user
sudo service docker restart

# 새로운 터미널을 열고 확인
docker version

 

Docker 및 Docker Compose 버전 확인

# docker version 확인
docker --version

# docker compose version 확인
docker-compose --version

 

 

Docker Desktop 설치

편리하게 Docker를 사용하기 위해 Docker Desktop을 설치한다. 아래의 링크에 들어가면 설치가 가능하다.

 

https://docs.docker.com/desktop/install/windows-install/

Windows

 

 

설치 후 회원가입/로그인을 하면 개발 환경 설정 끝!

 

 

 

 

[참고 자료]

https://velog.io/@jaylnne/WSL-Error-0x80370102-%ED%95%B4%EA%B2%B0

[WSL] Error: 0x80370102 해결

https://answers.microsoft.com/en-us/windows/forum/all/i-cant-find-hyper-v-in-turn-off-or-on-windows/bfddacde-76d6-4478-a918-e1aa18e69469

리디렉션 중