저는 최근에 베어메탈 우분투를 사용하지 않고 윈도우에 WSL을 설치해서 사용합니다. 예전과 다르게 많이 개선되어 WSL2에서는 거의 네이티브 리눅스에 근접한 성능을 보여주고 있습니다. GUI 앱도 지원하고, 파일 시스템 성능도 크게 향상되었죠. 특히 개발 환경 구축이 정말 편리해졌는데요, VS Code와의 완벽한 통합은 물론이고 도커 같은 컨테이너 도구도 원활하게 작동합니다.

이 포스팅에서는 Windows Subsystem for Linux(WSL)의 Ubuntu 환경에서 Docker를 설치하는 방법을 단계별로 알아보겠습니다. Docker를 사용하면 컨테이너화된 애플리케이션을 쉽게 실행하고 관리할 수 있습니다.

Windows WSL Ubuntu에서 Docker 설치하기

사전 준비물

Windows 10 혹은 Windows 11이 설치된 PC가 필요합니다. Windows 10의 경우 WSL2를 지원하는 최신 버전으로 업데이트되어 있어야 합니다. 그리고 Microsoft Store나 Windows Terminal을 통해 Ubuntu가 WSL2 방식으로 설치되어 있어야 하구요. 마지막으로 Ubuntu 터미널에서 관리자 권한으로 명령어를 실행할 수 있어야 합니다(sudo 명령어 사용 가능).

Windows 10 이상
WSL2가 설치된 Ubuntu
관리자 권한

설치 과정

1. 필수 패키지 설치

먼저 Docker 설치에 필요한 기본 패키지들을 설치합니다:

sudo apt-get -y install apt-transport-https ca-certificates curl gnupg lsb-release

2. Docker 공식 GPG 키 추가

Docker의 공식 GPG 키를 시스템에 추가합니다.

curl -fsSL [https://download.docker.com/linux/ubuntu/gpg](https://download.docker.com/linux/ubuntu/gpg) | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

3. Docker 레포지토리 설정

Docker 패키지 저장소를 시스템에 추가합니다.

echo "deb \[arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg\] [https://download.docker.com/linux/ubuntu](https://download.docker.com/linux/ubuntu) $(lsb\_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

4. 패키지 목록 업데이트

sudo apt-get update

5. Docker 설치

Docker 엔진과 관련 도구들을 설치합니다.

sudo apt-get install docker-ce docker-ce-cli containerd.io

6. 사용자 권한 설정

현재 사용자를 docker 그룹에 추가하여 sudo 없이도 Docker 명령어를 실행할 수 있게 합니다.

sudo usermod -aG docker ${USER}

7. 설치 확인

Docker 버전을 확인하여 설치가 정상적으로 완료되었는지 확인합니다.

docker --version

8. WSL 재시작

사용자 권한 변경사항을 시스템에 적용하기 위해서는 WSL Ubuntu를 완전히 재시작해야 합니다. 가장 확실한 방법은 Windows를 완전히 재시작하는 것입니다. 하지만 시간이 없다면 Windows PowerShell을 관리자 권한으로 실행한 후 'wsl --shutdown' 명령어를 입력하고 Ubuntu를 다시 실행하는 것으로도 충분합니다.

컴퓨터 재시작
또는 로그아웃 후 다시 로그인

또는 Ubuntu 터미널에서 'exit' 명령어로 로그아웃한 후 다시 로그인하는 것으로도 권한 변경사항이 적용됩니다. 재로그인 후에는 'docker ps' 명령어를 실행해보면서 sudo 없이도 Docker 명령어가 정상적으로 실행되는지 확인해보세요.

주의사항

Docker 설치 과정에서 문제가 발생할 수 있는 몇 가지 상황과 해결 방법을 알아보겠습니다.

먼저, 패키지 설치 중 오류가 발생한다면 Ubuntu 시스템을 최신 상태로 업데이트하는 것이 좋습니다. 다음 명령어를 순서대로 실행해보세요.

sudo apt-get update
sudo apt-get upgrade

특히 중요한 것은 WSL 버전입니다. 반드시 WSL2를 사용해야 합니다. WSL1에서는 Docker의 핵심 기능인 컨테이너 가상화가 제대로 동작하지 않아 여러 문제가 발생할 수 있습니다. 현재 사용 중인 WSL 버전은 PowerShell에서 다음 명령어로 확인할 수 있습니다.

wsl -l -v

만약 VERSION이 1로 표시된다면, 'wsl --set-version Ubuntu 2' 명령어로 WSL2로 업그레이드해주세요.

이제 Docker를 사용하여 컨테이너를 실행하고 관리할 수 있습니다. Docker Compose나 기타 Docker 관련 도구들도 필요에 따라 추가로 설치할 수 있습니다.

Embedded.AI

윈도우즈 WSL Docker 설치