Backend · Infra

WSL 설치부터 Docker CLI 설치까지 완벽 가이드 🐳

devhyen 2025. 2. 6. 14:44
📌 이 글은 Docker & 배포 자동화 시리즈 중 하나입니다.



기업 환경에서 Docker를 사용하려면
Docker Desktop이 유료라는 점을 고려해야 합니다. 개인이나 소규모 프로젝트에서는 무료로 사용할 수 있지만, 기업에서는 라이선스 비용이 발생합니다. 따라서, 비용 절감을 위해 WSL(Windows Subsystem for Linux)과 Docker CLI를 활용하는 방법이 추천됩니다. 이 글에서는 WSL 설치부터 Docker CLI 설치까지의 과정을 단계별로 설명하겠습니다.

 


1️⃣ WSL (Windows Subsystem for Linux) 설치하기

1. WSL 활성화

WSL을 사용하려면 먼저 기능을 활성화해야 합니다. 관리자 권한으로 PowerShell을 실행한 후 아래 명령어를 입력하세요.

wsl --install

이 명령어를 실행하면 기본적으로 최신 Ubuntu 버전이 설치됩니다.

설치 확인:

wsl --list --verbose

출력 예시:

NAME                   STATE           VERSION
* Ubuntu-22.04        Running         2

WSL 2로 설정: (WSL 1을 사용 중이라면 WSL 2로 변경)

wsl --set-version Ubuntu-22.04 2

2. 다른 배포판 설치하기

다른 리눅스 배포판을 설치하고 싶다면 아래 명령어로 확인 후 원하는 배포판을 선택하세요.

wsl --list --online

예시 출력:

NAME            FRIENDLY NAME
Ubuntu         Ubuntu
Debian         Debian GNU/Linux
kali-linux     Kali Linux Rolling

설치하려면:

wsl --install -d Debian

2️⃣ WSL에서 Docker 설치하기

WSL에 Docker를 설치하면 Windows 환경과 리눅스 환경에서 모두 활용할 수 있습니다.

1. 패키지 목록 업데이트

Ubuntu를 실행한 후, 최신 패키지 정보를 가져옵니다.

sudo apt update && sudo apt upgrade -y

2. Docker 리포지토리 추가

sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

3. Docker 패키지 설치

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

3️⃣ Docker 설치 확인하기

1. Docker 버전 확인

docker --version

예상 출력:

Docker version 24.0.7, build afdd53b

2. Docker 서비스 실행 상태 확인

sudo systemctl status docker

active (running) 상태인지 확인!

3. Hello World 실행 테스트

docker run hello-world

출력 예시:

Hello from Docker!
This message shows that your installation appears to be working correctly.

✅ 여기까지 정상적으로 실행되었다면 Docker 설치가 완료된 것입니다! 🎉


4️⃣ sudo 없이 Docker 명령어 실행하기

현재 Docker는 sudo 명령어 없이 실행할 수 없습니다. 이를 해결하려면 현재 사용자를 docker 그룹에 추가하면 됩니다.

sudo usermod -aG docker $USER
newgrp docker

이후 docker ps 명령어를 실행해 보세요.

docker ps

에러 없이 실행되면 권한 설정이 완료된 것입니다.


5️⃣ Docker Compose 설치 및 확인

Docker Compose는 여러 개의 컨테이너를 쉽게 관리할 수 있도록 도와주는 도구입니다.

docker compose version

예상 출력:

Docker Compose version v2.18.1

🚀 마무리: WSL + Docker 완벽 설치 완료!

이제 Windows 환경에서도 리눅스를 활용하고, Docker를 사용하여 컨테이너를 실행할 수 있습니다.