windows wsl ubuntu 에서 docker를 설치하는 방법

Windows에서 WSL(Windows Subsystem for Linux)을 통해 Ubuntu에 Docker를 설치하려면 아래 단계를 따라 진행하면 됩니다. 

1. WSL 및 Ubuntu 확인

먼저 WSL이 설치되어 있고 Ubuntu가 제대로 실행되는지 확인하세요.

Windows PowerShell 또는 명령 프롬프트에서 다음 명령어를 실행해 WSL이 설치되어 있는지 확인:

 

wsl --list

결과에 Ubuntu(예: Ubuntu-20.04)가 보이면 됩니다. 없으면 Microsoft Store에서 Ubuntu를 설치하세요.

Ubuntu를 실행:

 

wsl -d Ubuntu

또는 시작 메뉴에서 "Ubuntu"를 검색해 실행합니다.

2. Ubuntu 업데이트

Ubuntu 터미널에서 시스템 패키지를 최신 상태로 업데이트합니다:

 

sudo apt update && sudo apt upgrade -y

3. Docker 설치에 필요한 패키지 설치

Docker 설치를 위해 몇 가지 필수 패키지를 설치합니다:

 

sudo apt install -y apt-transport-https ca-certificates curl software-properties-common

4. Docker 공식 GPG 키 추가

Docker의 공식 저장소를 추가하려면 GPG 키를 설정해야 합니다:

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

키가 추가되면 아래와 같이 'OK' 를 확인할 수 있습니다. 

 

5. Docker 저장소 추가

Ubuntu에 Docker의 공식 저장소를 추가합니다:

sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu$(lsb_release -cs) stable"

 

6. Docker 설치

이제 Docker를 설치합니다:

sudo apt update && sudo apt install -y docker-ce docker-ce-cli containerd.io

7. Docker 서비스 시작 및 확인

Docker가 제대로 설치되었는지 확인하고 서비스를 시작합니다:

Docker 서비스 시작:

 

sudo service docker start

Docker 버전 확인:

 

docker --version

예: Docker version 20.10.24 같은 출력이 나오면 성공입니다.

8. sudo 없이 Docker 사용 (선택)

Docker 명령어를 sudo 없이 실행하려면 현재 사용자를 Docker 그룹에 추가합니다:

 

sudo usermod -aG docker $USER

이후 WSL(Ubuntu) 터미널을 재시작하거나 로그아웃 후 다시 로그인하세요.

9. 테스트

Docker가 잘 작동하는지 확인하려면 다음 명령어를 실행:

docker run hello-world

"Hello from Docker!" 메시지가 출력되면 설치가 완료된 것입니다.

추가 참고

• WSL에서는 Docker Desktop을 설치할 필요가 없습니다. 위 방법은 Ubuntu 내에서 네이티브 Docker를 설치하는 방식입니다.
• 만약 WSL과 Docker Desktop을 함께 사용하고 싶다면, Windows에 Docker Desktop을 설치하고 WSL 통합 옵션을 활성화하는 방법도 있습니다. 이 경우 Docker Desktop 설정에서 "Use WSL 2 based engine"과 Ubuntu 통합을 체크하세요.