Window 도커(Docker) 설치 및 환경 구축(feat. WSL)

 

1. WSL2 설치 및 설정

WSL은 Windows에서 리눅스를 실행할 수 있게 해주는 기능입니다. Docker Desktop은 WSL2를 백엔드로 사용하므로, 

Window 에서 Docker를 설치하기 전에 WSL2 환경 구축은 필수입니다.

 

WSL2 환경 구축 없이 진행할 경우 Verifiing package 에서 안넘어가고 멈춥니다.

 

 

 

1.1 CMD 또는 Powershell(권장) 을 관리자 모드로 실행시킵니다.

wsl --install

 

 

1.2 설치가 끝나면 컴퓨터를 재시작합니다.

 

 

1.3 기본 WSL 버전을 2로 설정합니다

wsl --set-default-version 2

 

 

1.4  wsl 버전을 확인합니다(2.4.X 로 뜨면 정상)

wsl --version

 

1.5 설치 가능한 배포판(OS) 를 확인 해줍니다.

저는 Ubuntu 24.04 LTS로 진행했습니다

wsl.exe --list --online

 

 

1.6 배포판을 설치합니다.

wsl --install -d [OS 명]

 

Ubuntu-24.04를 설치하고 싶으면

wsl --install -d Ubuntu-24.04

 

를 입력해주면 되겟죠?

 

설치가 완료된 화면입니다

 

 

Ubuntu 실행:
PowerShell에서 Ubuntu를 실행하려면 다음 명령어를 사용합니다.

wsl

 

처음 실행하면 최초 user를 만드라고 하네요. admin으로 만드려고 했더니 안되서 기본으로 잡혀있는 컴퓨터 유저 이름을 id 로 하고 비밀번호를 설정해줍니다.

 

 

또는 특정 배포판을 실행하려면 하단 코드로 진행하시면 됩니다

wsl -d <배포판 이름>

 

정상적으로 실행된 모습입니다.

 

root 비밀번호는 초기에 설정이 안되어있어서 설정해주고 가면 좋겠죠

 

sudo passwd root

 

 

 

2. Docker Desktop 설치

 

Docker Desktop은 GUI와 CLI를 제공하며, WSL2를 백엔드로 활용할 수 있습니다.

 

Docker Desktop 사이트에 접속합니다.

 

https://www.docker.com/products/docker-desktop/

Docker Desktop: The #1 Containerization Tool for Developers | Docker

 

Window 용 클릭하면 

 

 

이 화면이 뜨면 정상적인 상태이고 그냥 OK 누르셔도 되고 Windows Containers 필요하시면 체크 하면 됩니다.

 

 

 

설치가 완료되면 컴퓨터를 재시작해줍니다.

 

 

 

버전을 출력해서  정상적으로 설치되었는지 확인해 봅니다.

docker --version

 

 

이렇게 해서 docker 설치가 끝났습니다