建置 Laravel 開發環境 — 在 Windows 10 Home Version上設定 Laradock

之前為了在 Windows 10 Home Version 上運行 Docker 花了不少時間研究,最後採用 Docker ToolBox 進行開發,原本以為將一生平安,沒想到最近在設定 Laradock 時一直撞牆,希望這篇文章能幫助只有 Windows 10 Home Version 可以使用的人

建置流程

啟用 WSL2 服務

前面提到我原本是使用 Docker ToolBox 來取代 Docker Desktop ,然而這樣做的下場是 Laradock 的 Volume 將無法正常運作,在搜尋過許多網上解法並嘗試之後,仍無法解開,最後發現問題就出在 Docker ToolBox 上,所以首先要讓 Windows 10 Home Version 可以順利裝上 Docker Desktop

1/ 檢查 Windows 10 是否為2004版且組建為19041或更高版本
(可透過 [Windows 標誌鍵 + R] 並輸入 winver 來檢視)

若不是的話,請先更新至此版本,建議可以在睡覺前讓電腦跑至最後安裝步驟,這個版本 Windows 需要大量時間進行更新

2/ 啟用「虛擬機器平台」選用功能,以完成 WSL 安裝並更新至 WSL2

以系統管理員身分開啟 power shell 並執行以下指令(執行完記得重新開機)

# dism.exe/online/enable-feature/featurename:VirtualMachinePlatform/ all/norestart

3/ 將 WSL2 設定為預設版本

在 power shell 中執行以下指令

# wsl — set-default-version 2

4/ 設置 .wslconfig

C:\Users\{PC_USER_NAME} 中建立 .wslconfig 檔,並在其中寫入以下內容
(不做此設定的話,記憶體會被 WSL 無上限使用)

memory={欲配置之最大記憶體容量}
swap=0
localhostForwarding=true

安裝 Docker Desktop

安裝的環節基本上就遵照安裝檔的提示即可,要注意的地方只有兩個

1/ 確認以下事項已完成

  • WSL2已正確運行

  • CPU為64位元

  • 有4G以上的RAM

  • BIOS的虛擬化技術已啟用

2/ 執行安裝檔的第一個頁面請將 Enable WSL 2 Features 的選項打勾

設定 Laradock

終於來到最重要的部分,到這裡最大的難題基本上已經解決,剩下和正常設定流程不同的地方只有資料儲存路徑的修改

1/ git clone Laradock

# git clone https://github.com/laradock/laradock.git Laradock

2/ 複製並調整設定檔模板

  • 複製一份env-example並改名為.env

  • DATA_PATH_HOST=~/.laradock/data 修改為 DATA_PATH_HOST=./data
    (沒調整的話 mysql or mariadb 的 container 可能會無法啟動)

  • 調整其它參數以符合自己需求

3/ docker-compose up

成功啟動所有 Container 之後,理論上 Laradock 就可以正常運行啦!

# docker-compose up -d nginx mariadb workspace

參考連結