Home » , » 윈도우 도커 설치 및 WSL 2 연동: 나만의 서버 환경 구축 완벽 가이드 |가나투데이

윈도우 도커 설치 및 WSL 2 연동: 나만의 서버 환경 구축 완벽 가이드 |가나투데이

By 

윈도우 도커 설치 및 WSL 2 연동: 나만의 서버 환경 구축 완벽 가이드 |가나투데이

1. 인트로: 왜 윈도우에서 도커와 WSL 2를 써야 하는가?

과거에는 윈도우 환경에서 리눅스 기반 컨테이너를 실행하는 것이 복잡하고 성능 저하가 심했습니다. 하지만 WSL 2(Windows Subsystem for Linux)의 등장으로 윈도우에서도 리눅스 네이티브에 가까운 강력한 성능으로 도커를 사용할 수 있게 되었습니다.

도커를 설치한다는 것은 단순히 프로그램을 깔는 것이 아니라, 내 컴퓨터를 언제든 배포 가능한 개인 서버 환경으로 변신시키는 첫걸음입니다. 오늘 이 가이드를 통해 개발부터 배포까지 막힘없는 완벽한 워크플로우를 설계해 보세요.

2. 설치부터 개인 서버 최적화까지 3단계 전략

섹션 1: 윈도우 환경 준비와 Docker Desktop 설치

도커 설치의 핵심은 윈도우의 가상화 기능을 활성화하는 것입니다. 단순히 설치 파일을 실행하기 전, 다음의 시스템 설정이 선행되어야 오류를 방지할 수 있습니다.

  • 공식 설치 파일 다운로드: 가장 먼저 안전한 공식 경로를 통해 설치 파일을 준비해야 합니다.

도커 데스크탑 공식 다운로드 바로가기: Docker Desktop for Windows 공식 사이트

  • Windows 기능 활성화: 제어판의 기능 켜기/끄기에서 가상 머신 플랫폼과 Linux용 Windows 하위 시스템을 반드시 체크해야 합니다. 만약 설치 중 엔진 시작 오류가 발생한다면, 이 설정이 누락되었을 확률이 매우 높습니다.

  • 설치 최적화 옵션: Docker Desktop 설치 시 Use WSL 2 instead of Hyper-V 옵션을 체크하는 것이 성능 향상의 핵심입니다.

섹션 2: WSL 2 Ubuntu 연동 및 버전 최적화

도커 엔진만 설치해서는 반쪽짜리 환경입니다. 실제 개발이 이루어질 우분투(Ubuntu) 환경을 연동하고 버전을 관리하는 능력이 필요합니다.

  • 우분투 설치와 계정 생성: PowerShell에서 wsl --install -d Ubuntu를 입력하여 설치합니다. 이때 생성하는 UNIX 사용자 이름은 반드시 소문자와 숫자로만 구성해야 호환성 문제가 생기지 않습니다.

  • WSL 버전 강제 변환: 많은 사용자가 설치 후 놓치는 부분이 버전 확인입니다. wsl -l -v 명령어를 통해 현재 우분투가 버전 2인지 꼭 확인하세요. 만약 버전 1이라면 wsl --set-version Ubuntu 2 명령을 통해 반드시 업그레이드해야 도커와의 연동 성능이 보장됩니다.

  • 도커 연동 확인: Docker Desktop 설정 내 Resources > WSL Integration 메뉴에서 설치한 Ubuntu가 활성화되어 있는지 확인합니다.

섹션 3: 개인 서버 구축을 위한 첫 번째 워크플로우 설계

이제 설치된 도커를 활용해 내 PC를 서버처럼 활용할 수 있는 구체적인 워크플로우를 구축해 볼 차례입니다.

  • 컨테이너 자동 복구 설정: 개인 서버라면 컴퓨터가 켜질 때 서버도 자동으로 시작되어야 합니다.

    • docker run -d --restart always -p 80:80 --name my-web nginx: --restart always 옵션은 윈도우 재부팅 시에도 컨테이너를 자동으로 살려주는 필수 명령어입니다.

  • 데이터 보존을 위한 볼륨 바인딩: 컨테이너를 지워도 데이터가 남도록 윈도우 폴더와 연결합니다.

    • docker run -v C:\server_data:/data -d my-app: 내 윈도우의 특정 폴더를 서버 저장소로 직접 매핑하여 데이터 안전성을 확보합니다.

  • 상태 모니터링: docker stats 명령어를 통해 현재 내 윈도우 리소스를 도커가 얼마나 점유하고 있는지 실시간으로 모니터링하며 최적의 서버 사양을 조절해 나갑니다.

3. 클로징: 이제 당신의 윈도우는 완벽한 개발 서버입니다

지금까지 윈도우에서 도커와 WSL 2를 완벽하게 연동하는 방법을 살펴보았습니다. 이제 여러분의 PC는 단순한 사무용 컴퓨터를 넘어, 전 세계 어디서든 동일한 환경으로 앱을 구동할 수 있는 강력한 개인 서버의 기반을 갖추게 되었습니다.

반복되는 환경 설정의 굴레에서 벗어나, 도커가 제공하는 일관된 워크플로우를 통해 더 창의적인 개발에 집중해 보세요. 오늘 만든 이 환경이 여러분의 프로젝트 성장을 이끄는 든든한 기반이 될 것입니다.

4. 부록: 도커 설치 시 자주 발생하는 오류 Q&A

Q1. Docker Desktop 실행 시 "Docker Desktop - Unexpected Error"가 떠요.

A1. 대부분 WSL 2 커널 업데이트 패키지가 최신이 아닐 때 발생합니다. MS 공식 사이트에서 WSL2 Linux 커널 업데이트 패키지를 다운로드하여 설치하거나, 터미널에서 wsl --update 명령어를 실행해 보세요.

Q2. BIOS에서 가상화(Virtualization)를 켜야 한다는 메시지가 나옵니다. 

A2. 윈도우 설정뿐만 아니라 컴퓨터 하드웨어 자체에서 가상화 기능을 허용해야 합니다. PC 재부팅 시 F2나 Del 키를 눌러 BIOS에 진입한 뒤, Intel VT-x 또는 AMD-V 항목을 Enabled로 변경해 주세요.

Q3. 우분투 터미널에서 docker 명령어를 입력하면 "Permission Denied"가 뜹니다.

A3. 기본적으로 도커 명령어는 관리자 권한이 필요합니다. 매번 sudo를 붙이기 번거롭다면 sudo usermod -aG docker $USER 명령어를 입력해 현재 사용자를 도커 그룹에 추가하세요. 그 후 터미널을 껐다 켜면 권한 문제가 해결됩니다.

이 가이드가 도움이 되셨나요? 설치 과정에서 해결되지 않는 다른 오류가 있다면 댓글로 상황을 공유해 주세요. 함께 해결해 나가며 여러분의 완벽한 서버 구축을 돕겠습니다!

#가나 투데이 #ganatoday

그린아프로
Share:  Facebook Twitter Google+