windows, WSL2 + docker 개발환경 구성

개요

windows os에서 WSL2 + docker를 이용한 개발환경 구성

내용

---

1. WSL2 설정

 

a. Mircrosoft Store에서 "ubuntu20.04.4 LTS" 설치

 

b. C:\Users\사용자명 경로에 '.wslconfig' 파일을 생성하고 아래 내용 작성

※ 해당 파일을 추가하는 이유는 윈도우에서 WSL2를 사용한 docker를 사용할 경우 컴퓨터의 메모리를 한도없이 가져다 사용하기 때문에 아래 파일을 추가하여 사용량 제한

 

- C:\Users\사용자명\.wslconfig 파일 내용

[wsl2]
memory=4GB
swap=2GB

 

---

2. Windows Terminal 설치

 

- 윈도우 기본설치되어있는 PowerShell로도 wsl을 사용할 수 있지만, 편의성을 위해 Windows Terminal을 사용

a. Mircrosoft Store에서 "Windows Terminal" 설치

 

 

b. Windows Terminal 실행 및 설정

- ubuntu 기본 계정 설정

// wsl 실행시 로그인 계정을 root로 변경
ubuntu2004 config --default-user root

 

 

-  wsl실행시 로그인 계정을 root로 변경

 

 

- Terminal에서 Ubuntu 실행 방법

 

c. Ubuntu 패키지 업데이트 및 부가 설정 (선택)
해당 작업은 안해도 크게 상관없지만 가독성 및 편의성을 위하여 진행하였습니다.
아래 웹페이지 순서대로 진행하시면 됩니다.

Ubuntu 설치 후에 처음 할 일 - WSL 시작하기 (wslhub.com)

 

d. ubuntu20.04 wsl 버전 확인

- 윈도우의 WSL 설정 기본값이 버전 1로 설정되어있으면 네트워크 관련 문제가 docker가 실행되지 않습니다.

wsl -l -v

* Ubuntu-20.04 wsl version이 1인 경우, 2로 변경

a. wsl2 활성화(터미널 관리자 권한으로 실행)

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

 

b. Ubuntu-20.04 wsl2로 설정 변경

//wsl 기본 버전 wsl2로 변경
wsl --set-default-version 2
//이미 우분투를 추가한 경우 wsl2로 변경 (위 이미지의 NAME이 다른 경우 맞춰 변경)
wsl --set-version Ubuntu-20.04 2

---

3. WSL2(ubuntu)내 docker 설치

 

- ubuntu20.04 실행하여 아래 명령어 수행

//필요 패키지 설치
sudo apt-get install apt-transport-https ca-certificates curl gnupg lsb-release
sudo apt-get update
 
//docker 공식 GPG 키
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add
 
//docker stable repo 사용
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
 
//docker 설치
sudo apt install docker-ce docker-ce-cli containerd.io
sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

 

 

- wsl2(ubuntu)내 도커 정상 설치 확인

docker -v

---