Windows10 WSLのUbuntu18.04にDjango+Apacheの開発環境を作る手順をまとめます

手順

apache2がmod_wsgiを介してpythonにアクセス出来るようにします。また、WSLで使えるリモートIDEとしてVScodeを使えるようにしてやります。

anaconda3をインストール
djangoをインストール
djangoプロジェクトを作ってmigrate
apache2をインストール
mod_wsgiをインストール
apache2の設定ファイルに追記
vscodeを使えるようにする

WSLではsystemctlが使えないのでapacheの操作がちょっと変わる、anacondaを使う場合はmod_wsgiをpipでインストールしないと参照先設定を自分で変えなきゃいけなくなる、apache2.confの設定が分かりにくい、辺りが躓きやすいところだと思います。

1. WSLのインストール

WSLを有効にしてUbuntu18.04をインストールします
https://qiita.com/matarillo/items/61a9ead4bfe2868a0b86

更新します

terminal

sudo apt update
sudo apt upgrade

2. Apache2のインストール

apache2とapache2-devをインストールして始動します

terminal

sudo apt install apache2
sudo apt install apache2-dev
sudo /etc/init.d/apache2 start

これでapacheが http://localhost に待機する筈です。ブラウザで開けばドキュメントルートである /var/www/html/ にあるindex.htmlが開きます。

止めるときはstopです

terminal

sudo /etc/init.d/apache2 stop

設定変更を反映させる為に再起動するときはrestartします

terminal

sudo /etc/init.d/apache2 restart

3. Anacondaのインストール

pyenvをインストールします

terminal

git clone https://github.com/yyuu/pyenv.git ~/.pyenv

PATHを通します

terminal

echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc
echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(pyenv init -)"' >> ~/.bashrc
source ~/.bashrc

インストールできるanacondaのバージョンを確認します

terminal

pyenv install -l | grep anaconda

選んだバージョンのanacondaをインストールします。以下では2020.02版をインストールしています。

terminal

pyenv install anaconda3-2020.02
pyenv rehash
pyenv global anaconda3-2020.02

PATHを通します。

terminal

echo 'export PATH="$PYENV_ROOT/versions/anaconda3-2020.2/bin/:$PATH"' >> ~/.bashrc
conda init
source ~/.bashrc

conda環境を作ります。以下ではdjangoという名前のpython3.7環境を作っています。xxxxがユーザー名です。

terminal

conda create -n django python=3.7
echo 'export PYTHONHOME=/home/xxxx/.pyenv/versions/anaconda3-2020.02' >> ~/.bashrc
echo 'export PYTHONPATH=/home/xxxx/.pyenv/versions/anaconda3-2020.02/bin:/home/xxxx/.pyenv/versions/anaconda3-2020.02/lib/python3.7/site-packages' >> ~/.bashrc
conda create django

4. djangoのインストール

インストールしてバージョンを確認します

terminal

pip install django
django-admin --version

プロジェクトを作って動かしてみます。ディレクトリを作ってdjango-admin startproject hogeとすればhogeという名前のプロジェクトを作れます。

terminal

mkdir django
cd django
django-admin startproject proj1

作ったディレクトリ内に作られているmanage.pyをpythonから実行して簡易サーバーを動かして動作を確認します。

terminal

cd proj1
python manage.py migrate
python manage.py runserver

http://localhost:8000 をブラウザで開くとdjangoのサンプルページが表示される筈です。

5. mod_wsgiのインストール

mod_wsgiはaptからインストールする方法もありますが、aptでインストールしたmod_wsgiはanacondaではなくapt install pythonしたときのpythonを参照しにいく設定がデフォです。anacondaを使う場合はpipからインストールした方が簡単だと思います。

terminal

pip install mod_wsgi
pip install mod-wsgi-httpd

PATHを通します。
xxxxはユーザー名です。

terminal

echo 'export PATH=/home/xxxx/.pyenv/versions/anaconda3-2020.02/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

これでmod_wsgiが動くようになった筈です。簡易サーバーを動かして動作を確認してみましょう。以下のコマンドでhttp://localhost:8000 に簡易サーバーが待機しますのでブラウザで開きます。

terminal

mod_wsgi-express start-server

mod_wsgi-expressサーバーが正常に動作していれば上のようなサンプルページらしからぬ画像が表示されます。

最後にApache2の設定ファイルに書く為の情報を取得します。

terminal

mod_wsgi-express module-config

terminal

LoadModule wsgi_module "/home/xxxx/.pyenv/versions/anaconda3-2020.02/lib/python3.7/site-packages/mod_wsgi/server/mod_wsgi-py37.cpython-37m-x86_64-linux-gnu.so"
WSGIPythonHome "/home/xxxx/.pyenv/versions/anaconda3-2020.02"

上記をどこかにコピペしておきましょう。

6. apacheとmod_wsgiを紐づける

django公式の通りapache2.confを追記します。
https://docs.djangoproject.com/ja/2.0/howto/deployment/wsgi/modwsgi/

django projectを/home/xxxx/django/ に作成した場合は下のようになります。最初の2行がmod_wsgi-express module-configで表示される内容のコピペで、WSGIScriptAliasが作ったdjango projectのディレクトリ内に作られるwsgi.pyのPATH、WSGIPythonPathが作ったdjango projectのmanage.pyのあるディレクトリPATH、Direcotyが上記のwsgi.pyのディレクトリPATHとなります。

/etc/apache2/apache2.conf

LoadModule wsgi_module /home/xxxx/.pyenv/versions/anaconda3-2020.02/lib/python3.7/site-packages/mod_wsgi/server/mod_wsgi-py37.cpython-37m-x86_64-linux-gnu.so
WSGIPythonHome /home/xxxx/.pyenv/versions/anaconda3-2020.02

WSGIScriptAlias / /home/xxxx/django/proj1/proj1/wsgi.py
WSGIPythonPath /home/xxxx/django/proj1


<Directory /home/xxxx/django/proj1/proj1>
<Files wsgi.py>
Require all granted
</Files>
</Directory>

apacheの設定を変更しましたので再起動します。

terminal

sudo /etc/init.d/apache2 restart

http://localhost をブラウザで開いて確認します。

上のようになればOKです。

なお、apache2.confの内容が間違っていたり、インストール出来ていないパッケージがあったりすると以下のようにinternal server errorになります。

これだけだと原因が分からなくて辛いのでapacheのエラーログを見て判断しましょう。デフォルト設定のままなら以下で見られます。

terminal

tail -f /var/log/apache2/error.log

だいたい何か入れ忘れているか、PATHが違っているかのどちらかだと思います。

7. VScodeで開発出来るようにする

WSLはGUIがありませんが、VScodeのWSL extensionを使うとGUIで開発出来るようになります。Windows10にVScodeをインストールしたあとWSL extensionを有効にします。

以下のコマンドでWSLからVScodeを起動すると、WSL側からWindows側のVS codeを動かしに来てくれるようです。

terminal

cd test
code .

ちなみにpermissionの制限はUbuntuそのままですので code .を実行したときの権限での編集となります。例えばapahceの静的ファイルが置いてある /var/www/html/ はownerがrootなので、ユーザーアカウントから変更しようとすると下の画像のようなエラーが出ます。ownerを変更すれば変更可能になりますが、セキュリティ的にそれで良いのか僕は知らないので誰か教えてください。ちなみにsudo code .は実行できないようです。

terminal

Unable to write file 'vscode-remote://wsl+ubuntu-18.04/var/www/html/test.html' (NoPermissions (FileSystemError): Error: EACCES: permission denied, open '/var/www/html/test.html')

参考

https://docs.djangoproject.com/ja/2.0/howto/deployment/wsgi/modwsgi/
https://codelab.website/anaconda-django/
https://qiita.com/itisyuu/items/dafa535adc8197208af1
https://blog.capilano-fw.com/?p=369