WSL 우분투 도커 설치하기 (윈도우 11)

윤정한 | 최근 수정일 : 24년 02월 28일

WSL 우분투에 도커 설치하려면

윈도우 환경에서 WSL 우분투를 활용하면 리눅스 환경을 모방하여 사용할 수 있습니다.
예전엔 가상 환경을 따로 구축했어야 했는데 2020년도 즈음에 WSL 을 업데이트하여 사용할 수 있게 되었죠.

설치할 수 있는 리스트 확인하기

wsl --list --online

WSL 설치하기

wsl --install Ubuntu-22.04

먼저 PowerShell(파워셀) 을 실행하여 위의 명령어를 입력합니다.
그러면 간단하게 Ubuntu 까지 일사천리로 설치해줍니다.

계정 정보를 입력합니다. 저는 까먹지 않기위해 통일시켜서 적어놨습니다.
그러나 개발환경이 아닌 경우에는 비밀번호와 키를 같이 사용하여 보안을 높여야겠죠

wsl -l -v

현재 wsl 에 어떤 리눅스 가상머신이 실행중인지 확인할 수 있습니다.
만약 버전이 1이라면 업데이트 하여 2로 맞추어야합니다.

wsl 변경

wsl -s Ubuntu-22.04

wsl 을 변경하기 위해서는 위의 명령어를 활용해보세요

WSL 접근하기

VS Code 활용

sail 명령어 처리

alias sail='[ -f sail ] && sh sail || sh vendor/bin/sail'

~/.zshrc 혹은 ~/.bashrc 와 같은 홈 디렉토리 내의 쉘 구성 파일에 이걸 추가하고 쉘을 재시작 해주세요.

shell alias 가 구성되면 다음과 같이 사용할 수 있게 됩니다.

Install PHP Composer and Laravel on WSL in 10 minutes | by tanut aran | Medium

도커 설치하기

설치하기 : Install Docker Engine on Ubuntu | Docker Docs

도커 메뉴얼 사이트에 들어간 뒤 설치 명령어를 따라갑니다.

for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do sudo apt-get remove $pkg; done

먼저 기존 도커를 삭제합니다. 아마 없을 것입니다만, 혹시 모르니 안전하게 한번 돌리고 진행합니다.

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

# Add the repository to Apt sources:
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

위의 명령어를 하나하나 입력합니다.

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

이제 도커와 확장 프로그램을 설치합니다.

sudo docker run hello-world

마지막입니다. 이제 도커를 실행해봅니다. 반드시 sudo를 붙여야 합니다.

실은 훼이크였습니다. 도커를 실행해야 합니다.

sudo service docker start
sudo docker run hello-world

위와 같이 명령어를 입력하게 되면
도커가 정상적으로 실행되는 것을 확인할 수 있습니다.

WSL 우분투 PHP 삭제

sudo apt-get purge php8.*

php 8.3 설치하기

그냥 php install 하면 8.1 이 설치됩니다.
라라벨 최신버전은 8.3을 설치해야하기 때문에 이를 강제로 맞춰야 합니다.

sudo add-apt-repository ppa:ondrej/php
sudo apt-get update

sudo apt-get install php8.3