参考記事
-
WindowsでWSL2を使って「完全なLinux」環境を作ろう！
https://www.kagoya.jp/howto/it-glossary/develop/wsl2_linux/ -
windowsにLinuxを入れてDocker環境を構築する
https://zenn.dev/giana12th/articles/6cc6540e0dd306 -
WSL2のインストールを分かりやすく解説【Windows10/11】
https://chigusa-web.com/blog/wsl2-win11/ -
Ubuntu on WSL2でのDocker Engineの最短インストール手順
https://qiita.com/nujust/items/d7cd395baa0c5dc94fc5 -
WSL2（Ubuntu）へGitを導入
https://continue-cloud.net/wsl2-03/ -
（おまけ）【Docker Desktop】Windowsにインストール
https://chigusa-web.com/blog/windowsにdockerをインストールしてpython環境を構築/
実現したこと
Docker Desktopを使用せずに、windowsでwsl2をインストールしてlinux環境へdockerをインストール
やったこと
windowsへwsl2のインストール
windows 11 ならコマンドプロンプトかpowershellで以下を実行
$ wsl --install
Linuxの更新
$ sudo apt update && sudo apt upgrade
Docker Engineのインストール
$ curl -fsSL https://get.docker.com -o get-docker.sh
$ sudo sh get-docker.sh
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
ルート以外のユーザーでdockerコマンドを利用する設定を加える
$ sudo usermod -aG docker $USER
systemdの有効化
$ sudo vi /etc/wsl.conf
wsl.conf 内に以下を記述する
[boot]
systemd=true
（自分の場合はすでに書き込まれていた）
WSLの再起動
ここまでの設定を反映させるため、WSLを再起動する。
WSLを閉じ、PowerShellで以下のコマンドを実行。
$ wsl --shutdown
Dockerの実行確認
再度wslを起動して以下のコマンドを実行
$ docker run hello-world
以下のようなメッセージが表示されればインストール完了
Hello from Docker!
This message shows that your installation appears to be working correctly.
↑ここまでがwsl2 + Dockerのインストール
↓ここからはLaravelプロジェクトの配置
※自分の環境ではwsl2をインストール時にデフォルトでubuntuがインストールされたため以下wsl2での操作をubuntuと表記
※今回はgithubにあるLaravelプロジェクトをcloneして配置
ubuntuの起動
windowsの「すべてのアプリ」などからubuntuを起動するか、win + Rでcmdを起動したあとタブからubuntuを選択して起動する
ubuntuへgitのインストール
- ubuntuのcliで以下を実行
$ sudo apt-get install git
- ユーザ情報の設定
$ git config --global user.name ＜GitHubユーザ＞
$ git config --global user.email ＜GitHubへ登録したメールアドレス＞
- デフォルトのエディタをVSCodeに設定
$ git config --global core.editor "code --wait"
リポジトリをclone
- ubuntuの/home/(ユーザー名)/以下でプロジェクト用のフォルダを作成 + カレントディレクトリを移動
- URL経由でリポジトリをclone（※sshの設定が面倒だったのでURLを使用しているだけなのでURL経由が必須ではないです）
- リポジトリ内の
docker-compose.ymlファイルを使ってDockerコンテナを作成・起動
※この時点ではubuntuに docker-compose がインストールされていないと思うので以下を実行する
$ sudo apt update
$ sudo apt install docker-compose
その後、以下を実行する
$ docker-compose up -d
あとはlaravelで composer install を行うことになると思うが、それらのコマンドはコンテナ内で実行する
コンテナ内に入る方法は他の記事を参照してください
vscodeの設定
ここまででwsl2 + Docker環境にLaravelプロジェクトを配置することができたが、vscodeでubuntu内のファイルにアクセスするには以下の拡張機能の追加が必要だった
Remote Development
Laravelのログファイルへアクセス権限付与
これでようやく作業が開始できるかと思ったが、ブラウザでlocalhostへアクセスしてみると
The stream or file "/var/www/laravel-v10-starter/storage/logs/laravel.log" could not be opened in append mode: Failed to open stream: Permission denied The exception occurred while attempting to log:
というエラーが発生してた。
chatGPTに投げてみると
- このエラーメッセージは、Laravelのログファイル**
laravel.log**に書き込みを試みた際に、パーミッション（権限）が不足しているために発生しています。Laravelでは、アプリケーションの実行中に様々な情報をログファイルに記録しますが、このファイルやディレクトリに適切な書き込み権限がないと、上記のようなエラーが出ます。
ということだった。
そこでエラーの解決方法として以下を実行した
ステップ 1: 所有者の変更
$ sudo chown -R www-data:www-data storage bootstrap/cache
ステップ 2: 書き込み権限の設定
$ sudo chmod -R 775 storage bootstrap/cache
これでエラーが解消され、ようやく開発が開始できた。