📌 이 글은 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를 사용하여 컨테이너를 실행할 수 있습니다.
'Backend · Infra' 카테고리의 다른 글
OIDC란? Ory를 활용한 인증 알아보기 (0) | 2025.02.11 |
---|---|
Docker 인증서 오류(x509) 해결기: SSL 인증서와의 전쟁 (0) | 2025.02.07 |
ajax로 다운로드가 안될 때 : Uncaught InvalidStateError: Failed to read the 'responseText' property from 'XMLHttpRequest': The value is only accessible if the object's 'responseType' is '' or 'text' (was 'blob'). (1) | 2024.10.22 |
rocky 9 linux 초기 셋팅 (1) | 2024.10.17 |
[Windows] 특정 포트 사용 프로세스 종료하기 (2) | 2024.08.08 |