WSL2 와 Docker를 이용한 Laravel 개발환경 구축하기

https://laravel.kr/docs/9.x/installation

라라벨 9.x - 설치하기

공식문서가 굉장히 잘되어있다 그럼에도 설치하는 구축하는 도중 몇가지 실수할 수 있는 점이 있어 작성한다.

 

왜 Docker와 Wsl2를 사용해야하는가? 물론 홈스테드를 사용해서 구축하는 방법도 있다. 그러나 공식 문서에 나온 내용이니 만큼 차근차근 짚어보자. 

 

우린 결국

이 화면을 띄워야한다.

 

 

1. Windows에 wsl2 를 설치해야한다. 

https://gaesae.com/161

윈도우10 WSL2 설치하기, WSL2 우분투 설치하기

 

이분이 쓴 글이 굉장히 상세해서 이분글로 대체한다.

 

이후 composer설치를 해야하는데 

 

1. WSL2 터미널을 엽니다.

2. PHP가 설치되어 있는지 확인합니다. 만약 설치되어 있지 않다면 sudo apt-get install php 명령어를 실행하여 설치합니다.

3. curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer 명령어를 실행하여 Composer를 설치합니다

4. composer -V 명령어를 실행하여 설치된 버전을 확인합니다.

 

간혹 설치중

이런 에러가 뜨는 경우가 있다.

You can also run `php --ini` in a terminal to see which files are used by PHP in CLI mode. Alternatively, you can run Composer with `--ignore-platform-req=ext-xml` to temporarily ignore these required extensions

 

이럴 경우 XML 확장 프로그램이 필요하다는 거니

sudo apt-get install php-xml  을 실행하여 설치해주자

 

또 

 

Problem 1 - spatie/laravel-ignition[2.0.0, ..., 2.1.0] require ext-curl * -> it is missing from your system. Install or enable PHP's curl extension. 

에러가 뜨는 경우

sudo apt-get install php-curl 

을 실행하여 설치해주자

 

이제 도커를 설치하면 되는데 과정은 다음과 같다

 

1. Docker Desktop 설치

먼저, Windows 10에서 Docker Desktop을 설치해야 합니다. Docker Desktop을 설치하면 WSL2용 Docker 엔진도 함께 설치됩니다. 다음 링크에서 Docker Desktop을 다운로드하고 설치합니다.

https://www.docker.com/products/docker-desktop

Windows 용 다운받으면 됩니다.

Download Docker Desktop | Docker

 

 

설치됐다면 해당 밑줄 부분에 체크되어있는지 확인해주세요.

 

이제 WSL2에 Docker 설정

Docker Desktop 설치 후, WSL2 용 Docker 엔진이 사용할 수 있도록 설정해야 합니다.

먼저, PowerShell을 열고 다음 명령어를 실행하여 WSL2에 대한 Docker Engine을 활성화합니다:

 

두가지 다 실행해야합니다.

1. WSL2에서 Docker 설정

Docker Desktop 설치 후, WSL2 용 Docker 엔진이 사용할 수 있도록 설정해야 합니다.

먼저, PowerShell을 열고 다음 명령어를 실행하여 WSL2에 대한 Docker Engine을 활성화합니다.

wsl --set-default-version 2

그리고 나서, WSL2에서 Docker CLI를 사용할 수 있도록 다음 명령어를 실행합니다:

sudo usermod -aG docker $USER

이제 WSL2에서 Docker를 사용할 수 있습니다.

위의 명령어가 안되는 경우

sudo groupadd docker

실행해주면 됩니다. 이후 logout 후 재실행

 

1. PowerShell에서 Docker 설정

 

window powershell 에서 다음과 같이 순서대로 명령어 실행

 

wsl --set-default-version 2

**공식문서중 wsl --set-default ubuntu 의 ubuntu에  Ubuntu-22.04 복붙

wsl --set-default Ubuntu-22.04 

 

우리가 WSL2 설치할 때 설치한 Ubuntu-22.04 복붙해주시면 됩니다. 체크도 해주시구요.

그리구 이 공식문서에 나온 명령어 사용하시면 

curl -s https://laravel.build/example-app | bash

성공적으로 생성된 걸 알 수 있습니다.

 

화면을 띄우는 방법은 다음과 같습니다. 

 

해당 폴더로 이동 후 sail up 명령어 실행 

 

127.0.0.1 로 접속 

 

성공적으로 접속한 걸 알 수 있습니다. 

감사합니다. 

 

 

git으로 버전관리 하는 방법은 해당 포스트에있습니다 ▼

https://normal-operating.tistory.com/42