⛵ Laravel Sail - Windows 10 설치

Laravel Sail은 Laravel의 기본 Docker 개발 환경과 상호 작용하기 위한 경량 명령줄 인터페이스입니다. Sail은 사전 Docker 경험 없이도 PHP, MySQL 및 Redis를 사용하여 Laravel 애플리케이션을 구축할 수 있는 훌륭한 출발점을 제공합니다.

기본적으로 Sail은 프로젝트의 루트에 저장된 docker-compose.yml 파일 및 sail 스크립트입니다. sail 스크립트는 docker-compose.yml 파일에서 정의한 Docker 컨테이너와 상호 작용하기 위한 편리한 방법을 CLI에 제공합니다.

Laravel Sail은 WSL2을 통해 macOS, Linux 및 Windows에서 지원됩니다.

도커 데스크톱 설치

https://docs.docker.com/desktop/install/windows-install/

설치가 완료되면 Windows 사용자 디렉터리(C:\Users\YOURUSER)로 이동하여 다음 콘텐츠가 포함된 파일.wslconfig을 만듭니다.

[wsl2]
memory=2GB # Limits VM memory in WSL 2 
processors=4 # Makes the WSL 2 VM use 4 virtual processors
localhostForwarding=true # Boolean specifying if ports bound to wildcard or localhost in the WSL 2 VM should be connectable from the host via localhost:port.
swap=8GB

이 단계 후에 컴퓨터를 다시 시작해야 합니다.

WSL2 구성

Ubuntu 배포를 설치하고 Windows PowerShell을 사용하여 기본값으로 설정합니다.

# Check list of available distributions
wsl --list --verbose

wsl --set-default-version 2

# Install Ubuntu-20.04 distribution
# Don't forget to add a user with password on this step
wsl --install -d "Ubuntu-20.04"

# Set distribution as default
wsl -s Ubuntu-20.04

# Start distribution
wsl -d Ubuntu-20.04

그런 다음 끝에 wsl --list --verbose를 실행하면 Ubuntu 배포가 다음과 같아야 합니다.



이제 Docker Desktop 설정이 다음과 같은지 확인하십시오.

Ubuntu 20.04 배포판에 PHP를 설치합니다.

Windows Power Shell에서 명령wsl을 실행하여 새 Ubuntu 세션을 시작합니다. Ubuntu 터미널 내부에서 다음을 실행합니다.

sudo apt update
sudo add-apt-repository -y ppa:ondrej/php
sudo apt install -y php8.1-common php8.1-cli
sudo apt install -y php8.1-curl php8.1-gd php8.1-mbstring php8.1-xml php8.1-zip
php --version

Composer 2도 설치해야 합니다. composer -V를 실행하여 버전을 확인하십시오. 설치되지 않은 경우 다음 설치 안내서를 따르십시오. https://www.digitalocean.com/community/tutorials/how-to-install-composer-on-ubuntu-20-04-quickstart

결론

이제 돛으로 laravel 프로젝트를 실행할 수 있어야 합니다.

프로젝트에 항해 추가

프로젝트 루트 디렉터리로 이동하고 다음을 실행합니다.

composer require laravel/sail --dev
php artisan sail:install

# Start docker container
./vendor/bin/sail up

Sail이 이미 초기화된 프로젝트에서 컨테이너 실행(기존 docker-compose.yml):

# Start docker container
./vendor/bin/sail up

경우에 따라 컨테이너 시작이 실패하고 권한 문제와 관련될 수 있으므로 프로젝트 파일을 배치할 위치를 염두에 두고 적절한 권한을 부여해야 합니다. (또는 sudo 접두사로 실행)

📋 관련 기사

Laravel Sail 설치 가이드

https://laravel.com/docs/9.x/installation#getting-started-on-windows

Laravel Sail 사용 가이드

https://laravel.com/docs/9.x/sail#introduction