WSL 환경에서 Docker Desktop 이슈 해결 및 Docker Engine 직접 설치 가이드

핵심 기술

본 콘텐츠는 Windows 환경에서 Docker Desktop의 불안정성 문제를 해결하기 위해 WSL(Windows Subsystem for Linux)에 Docker Engine을 직접 설치하고, 이를 Windows 터미널에서 사용할 수 있도록 환경을 설정하는 실용적인 가이드입니다. Docker 클라이언트와 데몬(서버)의 분리 및 작동 원리에 대한 이해를 바탕으로 진행됩니다.

기술적 세부사항

• Docker Desktop 이슈: Windows OS 또는 Docker 업데이트 시 Docker 데몬 프로세스 시작 실패로 인한 문제점을 지적합니다.
• 문제 해결 시도: 언인스톨/재설치, 최신 버전 다운로드, AppData 폴더 삭제 등의 일반적인 해결 방법이 효과가 없었음을 명시합니다.
• WSL 환경 Docker 설치: Ubuntu 기반 WSL 터미널에서 apt 패키지 관리자를 사용하여 Docker Engine, CLI, containerd 등을 설치하는 상세 명령어를 제공합니다.
  • 기존 Docker 관련 패키지 제거 (docker.io, docker-compose 등)
  • Docker 공식 GPG 키 및 저장소 설정
  • docker-ce, docker-ce-cli, containerd.io 등 핵심 패키지 설치
• 터미널 통합: Git Bash와 같은 쉘에서 alias docker="wsl docker" 설정을 통해 WSL에 설치된 Docker 명령을 Windows 터미널에서 호출할 수 있도록 합니다.
• GUI 환경 구축 (Portainer): Portainer CE 이미지를 사용하여 Docker 관리 GUI를 제공하는 컨테이너를 실행합니다.
  • portainer_data 볼륨 생성
  • docker run 명령을 통해 Portainer 컨테이너 실행 (포트 9090 또는 지정 가능)
  • Portainer 컨테이너 삭제 및 포트 변경 방법 안내
• 접근 방법: 브라우저에서 localhost:9090 (또는 지정된 포트)으로 접속하여 Portainer UI에 접근합니다.

개발 임팩트

• Docker Desktop의 의존성 없이 WSL의 네이티브 Linux 환경에서 Docker를 안정적으로 운영할 수 있습니다.
• 클라이언트-서버 구조를 직접 구성함으로써 Docker 작동 방식에 대한 깊이 있는 이해를 얻을 수 있습니다.
• GUI 관리 도구(Portainer)를 통해 컨테이너 관리가 용이해집니다.
• Windows 환경에서 Linux 기반 개발 워크플로우를 보다 원활하게 수행할 수 있습니다.

커뮤니티 반응

(원문에서 특정 커뮤니티 반응은 언급되지 않았습니다.)

톤앤매너

이 가이드는 실제 개발 환경에서 겪을 수 있는 문제 해결을 위한 구체적이고 실용적인 지침을 제공하며, 명확한 명령어와 설정 과정을 제시하여 기술적인 신뢰성을 높입니다.