Windows10に構築したDocker+Laravel開発環境をWSLへ移行する

-

Windows10の環境でDocker+Laravelの環境で開発をしていて、Webレスポンスが非常に遅く開発に支障が出ているため、WSLに移行してかなり改善されたのでその際の手順をまとめます。

githubの設定

SSHの鍵ペアを作成

ファイル名はデフォルト、パスフレーズは無しで秘密鍵と公開鍵のペアを、ssh-keygenコマンドで生成します。

$ cd ~/.ssh

$ ssh-keygen

完了すると、以下の2ファイルが生成されます。

  1. ~/.ssh/id_rsa (秘密鍵)
  2. ~/.ssh/id_rsa.pub (公開鍵)

公開鍵をgithubへ設定

以下の手順で、id_rsa.pub (公開鍵)の内容をgithubへ設定します。

1. id_rsa.pub (公開鍵)の内容を出力

$ cat ~/.ssh/id_rsa.pub

2. githubへSign in

https://github.com/login

3. New SSH Key

Settings -> SSH and GPG keys -> New SSH Key をクリック

4. SSH Key 設定内容

以下のように設定して、Add SSH Keyをクリック

  • Title
    任意のタイトル
  • Key type
    Authentication Key
  • Key
    1で出力したid_rsa.pub (公開鍵) を貼りつける

以下のように一覧に追加されればOK

ソースコードをcloneする

ここまでの作業で、WSL内でgithubを利用する準備が整ったので、githubからソースコードをcloneします。

$ git clone git@github.com:s-watanabe-apps/laravel-project-test.git

なお、この時cloneするリポジトリのリンクは、githubで任意のリポジトリを開き、Code -> SSH の順にクリックして確認できます。

動作確認①

この時点でDocker Desktopが実行されていれば、コンテナを立ち上げることが出来ます。

$ docker-compose up -d
Starting laravel-project-test_mysql_1 ... done
Starting laravel-project-test_app_1   ... done
Starting laravel-project-test_web_1   ... done

$ docker-compose ps
            Name                          Command              State                 Ports
--------------------------------------------------------------------------------------------------------
laravel-project-test_app_1     docker-php-entrypoint php-fpm   Up      9000/tcp
laravel-project-test_mysql_1   docker-entrypoint.sh mysqld     Up      0.0.0.0:3306->3306/tcp, 33060/tcp
laravel-project-test_web_1     nginx -g daemon off;            Up      0.0.0.0:8000->80/tcp

しかし、ブラウザでトップページ（http://localhost:8000/）にアクセスすると、以下のようにエラーになります。

これは、Laravelのコンポーネントやその他ライブラリ群がインストールされていないためで、composer updateを実行して必要ライブラリをセットアップする必要があります。

PHPのセットアップ

composerを実行するためにはPHPが必要なので、まず初めにPHPをインストールします。

1. PHPバージョンを確認

versionを確認するとPHPをインストールするように言われるので、指示の通りaptによりインストールを行います。

$ php --version

Command 'php' not found, but can be installed with:

sudo apt install php7.4-cli

2. PHPのインストール

$ sudo apt install php7.4-cli

3. Fetchエラーが出る場合

インストール時に一部のリソースダウンロードで、以下のようにFetchエラーになる場合があります。

（省略）
Err:1 http://archive.ubuntu.com/ubuntu focal-updates/main amd64 php7.4-common amd64 7.4.3-4ubuntu2.13
  404  Not Found [IP: xxx.xxx.xxx.xxx]
Err:2 http://archive.ubuntu.com/ubuntu focal-updates/main amd64 php7.4-json amd64 7.4.3-4ubuntu2.13
  404  Not Found [IP: xxx.xxx.xxx.xxx]
Err:3 http://archive.ubuntu.com/ubuntu focal-updates/main amd64 php7.4-opcache amd64 7.4.3-4ubuntu2.13
  404  Not Found [IP: xxx.xxx.xxx.xxx]
Err:4 http://archive.ubuntu.com/ubuntu focal-updates/main amd64 php7.4-readline amd64 7.4.3-4ubuntu2.13
  404  Not Found [IP: xxx.xxx.xxx.xxx]
Err:5 http://archive.ubuntu.com/ubuntu focal-updates/main amd64 php7.4-cli amd64 7.4.3-4ubuntu2.13
  404  Not Found [IP: xxx.xxx.xxx.xxx]
Err:6 http://archive.ubuntu.com/ubuntu focal-updates/main amd64 libapache2-mod-php7.4 amd64 7.4.3-4ubuntu2.13
  404  Not Found [IP: xxx.xxx.xxx.xxx]
Err:7 http://archive.ubuntu.com/ubuntu focal-updates/main amd64 php7.4 all 7.4.3-4ubuntu2.13
  404  Not Found [IP: xxx.xxx.xxx.xxx]
E: Failed to fetch http://archive.ubuntu.com/ubuntu/pool/main/p/php7.4/php7.4-common_7.4.3-4ubuntu2.13_amd64.deb  404  Not Found [IP: xxx.xxx.xxx.xxx]
E: Failed to fetch http://archive.ubuntu.com/ubuntu/pool/main/p/php7.4/php7.4-json_7.4.3-4ubuntu2.13_amd64.deb  404  Not Found [IP: xxx.xxx.xxx.xxx]
E: Failed to fetch http://archive.ubuntu.com/ubuntu/pool/main/p/php7.4/php7.4-opcache_7.4.3-4ubuntu2.13_amd64.deb  404  Not Found [IP: xxx.xxx.xxx.xxx]
E: Failed to fetch http://archive.ubuntu.com/ubuntu/pool/main/p/php7.4/php7.4-readline_7.4.3-4ubuntu2.13_amd64.deb  404  Not Found [IP: xxx.xxx.xxx.xxx]
E: Failed to fetch http://archive.ubuntu.com/ubuntu/pool/main/p/php7.4/php7.4-cli_7.4.3-4ubuntu2.13_amd64.deb  404  Not Found [IP: xxx.xxx.xxx.xxx]
E: Failed to fetch http://archive.ubuntu.com/ubuntu/pool/main/p/php7.4/libapache2-mod-php7.4_7.4.3-4ubuntu2.13_amd64.deb  404  Not Found [IP: xxx.xxx.xxx.xxx]
E: Failed to fetch http://archive.ubuntu.com/ubuntu/pool/main/p/php7.4/php7.4_7.4.3-4ubuntu2.13_all.deb  404  Not Found [IP: xxx.xxx.xxx.xxx]
E: Unable to fetch some archives, maybe run apt-get update or try with --fix-missing?

この場合は、apt updateを実行することで、残りのリソースをダウンロードできます。

$ sudo apt update

4. 必要ライブラリのインストール

composerの実行に必要な以下のライブラリをインストールします。これらがインストールされていないと、composer実行時にエラーになりました。

$ sudo apt install php7.4-gd

$ sudo apt install php7.4-openssl

$ sudo apt install php-xml

5. 再度PHPバージョンを確認

$ php --version
PHP 7.4.3 (cli) (built: Nov  2 2022 09:53:44) ( NTS )

composerのセットアップ

インストールとアップデート

ここまでの作業でcomposerの実行準備が整いましたので、インストールとアップデートを行います。

$ composer install

$ composer update

動作確認②

再度ブラウザでトップページ（http://localhost:8000/）にアクセスすると、以下のようにトップページを開くことができ、レスポンス速度がかなり改善されていることが分かります。

Visual Studio Codeで開く

WSL上のコマンドラインから起動する

ひとまずWSLの開きたいプロジェクトへ移動し、「code .」でVSCodeを開くことが出来ます。

$ code .
Installing VS Code Server for x64 (97dec172d3256f8ca4bfb2143f3f76b503ca0534)
Downloading: 100%
Unpacking: 100%
Unpacked 2389 files and folders to ~/.vscode-server/bin/97dec172d3256f8ca4bfb2143f3f76b503ca0534.

ディレクトリ指定で開く

WSLのディレクトリはWindows上でマウントされていて、例えばホームディレクトリは以下のように指定すると開けます。

\\wsl.localhost\Ubuntu\home\{ユーザー名}\

コメント

コメントを投稿

このブログの人気の投稿

docker-compose up で proxyconnect tcp: dial tcp: lookup proxy.example.com: no such host

-
いつものように docker-compose コマンドでコンテナを起動し作業しようとしたところ、件名のエラーが発生するようになりました。 特に何も構成等を変更した覚えはないのですが、調査・復旧したので対応した内容をまとめておきます。 環境、バージョン等 $ cat /etc/issue Ubuntu 20.04.3 LTS \n \l $ docker --version Docker version 20.10.8, build 3967b7d $ docker-compose --version docker-compose version 1.26.0, build d4451659 発生事象 コンテナを起動する docker-compose up -d でコンテナを起動します。 $ docker-compose up -d Pulling mysql (mysql:5.7)... ERROR: Get "https://registry-1.docker.io/v2/": proxyconnect tcp: dial tcp: lookup proxy.example.com: no such host 「プロキシーサーバーが見つからない」と言われているようですが、全く見に覚えがありませんでした。 テスト用Dockerプロジェクトで試す 以前の記事 で紹介したテスト用プロジェクトでも一応試したましたが同様のエラーでした。 $ docker-compose up -d Pulling web (nginx:alpine)... ERROR: Get "https://registry-1.docker.io/v2/": proxyconnect tcp: dial tcp: lookup proxy.example.com: no such host Docker ログイン Dockerへのログインを試したところ、こちらも同様のエラーが出ました。 $ docker login Authenticating with existing credentials... Login did not succeed, error: Error response from daemon: G
Read more »

docker-compose で起動したweb、MySQLに接続できない事象

-
イメージ
概要 以前作成したPHP + MySQL + LaravelのDockerプロジェクトがコンテナを立ち上げても画面にアクセスできなくなってしまったときの解決方法です。 以前の記事は以下です。 【Laravel + MySQL】Dockerで開発環境を作る https://www.s-watanabe.work/2020/12/laravel-mysqldocker.html 発生事象 コンテナを起動 $ docker-compose up -d Starting laravel-project_mysql_1 ... done Starting laravel-project_app_1 ... done Starting laravel-project_web_1 ... done ブラウザでアクセス いつものようにブラウザでアクセスしますが接続できません。 http://localhost:8000 ※この時Docker側のログには何も出力されません。 MySQLへ接続 MySQLも確認してみましたが同じく接続できなくなりました。 $ mysql -h 127.0.0.1 -u user -ppassword -D test mysql: [Warning] Using a password on the command line interface can be insecure. ERROR 2013 (HY000): Lost connection to MySQL server at 'reading initial communication packet', system error: 2 調査・確認 まず以下の記事を参考に新規のDockerプロジェクトが起動・接続できるかを確認しました。 https://www.digitalocean.com/community/tutorials/how-to-install-and-use-docker-compose-on-ubuntu-20-04-ja # docker-compose はインストール済み $ docker-compose --version docker-compose version 1.26.0, build d
Read more »

【PHP】PHP_CodeSnifferを使う(コーディングルールのカスタマイズ)

-
phpcsを社内独自のコーディン規約などにあわせてカスタマイズする方法をまとめます。 インストールディレクトリ 以下のディレクトリにインストールされてます。 ~/.composer/vendor/squizlabs/php_codesniffer/ -rw-r--r-- 1 638 10 28 13:36 CONTRIBUTING.md -rw-r--r-- 1 187 11 26 12:08 CodeSniffer.conf.dist -rw-r--r-- 1 6399 10 28 13:36 README.md -rw-r--r-- 1 10085 10 28 13:36 autoload.php drwxr-xr-x 6 192 10 28 13:36 bin -rw-r--r-- 1 1083 10 28 13:36 composer.json -rw-r--r-- 1 1533 10 28 13:36 licence.txt -rw-r--r-- 1 6280 10 28 13:36 phpcs.xml.dist -rw-r--r-- 1 7054 10 28 13:36 phpcs.xsd -rw-r--r-- 1 340 10 28 13:36 phpstan.neon drwxr-xr-x 5 160 10 28 13:36 scripts drwxr-xr-x 16 512 10 28 13:36 src drwxr-xr-x 9 288 10 28 13:36 tests 設定ファイルを用意する CodeSniffer.conf.dist が雛形なのでこれをcpしてやればOKです。 cd ~/.composer/vendor/squizlabs/php_codesniffer/ cp CodeSniffer.conf.dist CodeSniffer.conf コーディングルールのカスタマイズ CodeSniffer.conf <?php $phpCodeSnifferConfig = array ( 'default_standard' => 'PSR2', 'repo
Read more »