Windows 11에서 WSL 설치 및 Docker 연결하기

Windows 11에서 WSL 설치 및 Docker 연결하기

Windows 11에서 WSL 설치 및 Docker 연결하기

Windows 11에서 WSL 설치 및 Docker 연결하는 방법

Windows 11에서 WSL(Windows Subsystem for Linux)을 사용하여 Linux 환경을 설정하고 Docker를 연결하는 과정은 매우 간단합니다. 이를 통해 Windows 환경에서도 Linux의 장점과 Docker의 효율성을 동시에 활용할 수 있습니다. 이 글에서는 WSL 설치부터 Docker 설정까지 자세히 안내드리겠습니다.

1. WSL(Windows Subsystem for Linux) 설치

1.1. WSL 기능 활성화

Windows 11에서는 WSL을 매우 쉽게 설치할 수 있습니다. 먼저, PowerShell을 관리자 권한으로 실행하여 WSL 기능을 활성화합니다.

1. PowerShell 실행:

   • 시작 메뉴에서 PowerShell을 검색합니다.
   • PowerShell을 마우스 오른쪽 버튼으로 클릭한 후 관리자 권한으로 실행을 선택합니다.

2. WSL 설치 명령어 입력: PowerShell에서 아래 명령어를 입력하여 WSL과 관련된 모든 기능을 활성화합니다.

   wsl --install

   이 명령어는 WSL 2와 관련된 필수 구성 요소를 자동으로 설치합니다. 시스템에 따라 몇 분 정도 시간이 소요될 수 있습니다.

1.2. 시스템 재부팅

설치가 완료되면 시스템을 재부팅하여 변경 사항을 적용합니다.

1.3. 배포판 선택

기본적으로 최신 Linux 배포판이 설치됩니다. 다른 우분투 버전을 원한다면 Microsoft Store에서 원하는 배포판을 설치할 수 있습니다. 예를 들어, Ubuntu 20.04를 선택하는 경우:

1. Microsoft Store 열기:
   • 시작 메뉴에서 Microsoft Store를 검색하여 실행합니다.
2. 배포판 검색 및 설치:
   • Store에서 Ubuntu를 검색하여 원하는 버전(예: Ubuntu 20.04)을 선택하고 설치합니다.

1.4. WSL 초기 설정

배포판을 설치한 후, 처음 실행 시 몇 가지 초기 설정을 진행해야 합니다. 사용자 이름과 비밀번호를 설정하면 WSL 환경이 준비됩니다.

2. Docker 설치

WSL을 설치한 후, Docker를 설치하고 Docker Desktop을 WSL에 연결하는 방법을 설명합니다.

2.1. Docker Desktop 설치

1. Docker Desktop 다운로드:
   • Docker 공식 사이트에서 Windows용 Docker Desktop을 다운로드합니다.
2. 설치:
   • 다운로드한 설치 파일을 실행하여 Docker Desktop을 설치합니다.
   • 설치 도중, WSL 2와 Hyper-V 관련 옵션을 활성화하는 화면이 나타날 수 있습니다. 이때 WSL 2를 선택하고 설치를 진행합니다.
3. Docker Desktop 실행:
   • 설치가 완료되면 Docker Desktop을 실행합니다.

2.2. Docker Desktop 설정

Docker Desktop을 실행한 후, WSL과 Docker를 연결하려면 몇 가지 추가 설정을 해야 합니다.

1. Docker Desktop 설정:
   • Docker Desktop을 열고, 좌측 상단의 Settings 아이콘을 클릭합니다.
2. WSL Integration 활성화:
   • Settings 메뉴에서 Resources -> WSL Integration 항목을 선택합니다.
   • Enable the WSL 2 based engine 옵션을 활성화합니다.
   • 원하는 Linux 배포판(예: Ubuntu)을 선택하여 WSL 환경과 Docker가 연동될 수 있도록 합니다.
3. 변경 사항 적용:
   • 설정을 완료한 후, Docker를 다시 시작하여 변경 사항을 적용합니다.

2.3. Docker 정상 작동 확인

Docker가 WSL과 제대로 연결되었는지 확인하려면, PowerShell에서 아래 명령어를 실행하여 Docker가 잘 작동하는지 확인합니다.

docker --version

또한, Docker의 상태를 확인하려면 아래 명령어를 사용하여 Docker 컨테이너가 정상적으로 실행되는지 테스트할 수 있습니다.

docker run hello-world

정상적으로 Docker가 실행되면 “Hello from Docker!” 메시지가 표시됩니다.

3. WSL에서 Docker 사용하기

WSL 환경에서 Docker를 사용하려면 Docker Desktop과 WSL 환경이 통합되어 있어야 합니다. Docker Desktop이 정상적으로 설치되고 설정되면, WSL 터미널에서 직접 Docker 명령어를 실행할 수 있습니다.

3.1. WSL 터미널에서 Docker 명령어 실행

1. WSL 터미널을 열고 (예: Ubuntu 배포판), 아래 명령어로 Docker를 실행해 봅니다.

docker --version

2. Docker 컨테이너 실행 예시:

docker run -it ubuntu bash

위 명령어는 Ubuntu 이미지를 기반으로 컨테이너를 실행하여 bash 셸을 제공합니다.

3.2. Docker Compose 사용

Docker Compose는 멀티 컨테이너 Docker 애플리케이션을 정의하고 실행하는 도구입니다. Docker Desktop에 Docker Compose도 기본으로 포함되어 있습니다. WSL에서 Docker Compose를 사용하려면, 아래와 같은 명령어로 간단한 테스트를 해 볼 수 있습니다.

docker-compose --version

정상적으로 Docker Compose가 작동하면 버전 정보가 출력됩니다.

4. 결론

Windows 11에서 WSL을 설치하고 Docker를 연결하는 과정은 비교적 간단하고 직관적입니다. Docker와 WSL의 통합을 통해, Windows 환경에서도 Linux의 강력한 개발 도구와 Docker의 편리한 컨테이너화 기술을 손쉽게 사용할 수 있습니다. 이를 통해 개발 환경을 더욱 효율적으로 관리하고, 다양한 플랫폼에서 실행되는 애플리케이션을 손쉽게 테스트할 수 있습니다.

---

위 과정들을 통해 Windows 11에서 WSL과 Docker를 연결하고 활용할 수 있습니다. Docker는 Linux 기반의 다양한 개발 환경을 Windows에서도 동일하게 구현할 수 있는 훌륭한 도구입니다.

카테고리 다른 글