0%

Windows下成功部署Django步骤

总结在前

经过了两天的google,才成功在windows7系统上部署成功Django,过程中遇到的问题和解决方法都一一记录了下来。总的体会是,确实麻烦而且困难,但是还是要感谢google

Django VS Flask

Django是基于python语言的web框架,其功能完备,内置了数据库,管理系统等,更重要的是其社区活跃文档丰富,其在stackoverflow的相关问题截至今天(2017-02-16)有136785个。

Flask是另一个基于ptyhon的web框架,更轻量级,更自由,只有基本的功能,其他通过手动扩展同样强大,国内的豆瓣就是基于这一框架搭建的。其相关问题在stackoverflow截至今天有15199个。

而我选择先用django的理由,主要的看重文档丰富和社区更活跃,在使用过程中遇到其他人遇到的问题更容易得到解答,加上初学python的时候接着就学习了django一段时间。

Django在Windows上的部署方案

根据Django官方推荐的方案:Apache + mod_wsgi来部署。但是在Windows平台部署会增加许多麻烦,而且mod_wsgi无法开启daemon mode

python是什么

这里需要明确一个概念,python是什么?
python是一门编程语言,并不设计实现,它只定义怎么写代码,按照什么语法写;具体怎么跑程序,怎么实现代码的功能,就要靠编译器,将python代码编译成能在机器上跑的字节码。可以见stackoverflow的解答。
涉及到具体实现,就有多种实现方式,Jpyhton可以将python代码编译成能在JVM里运行的字节码,IronPython可以编译成Microsoft CLR(即.NET环境)上运行的字节码,而CPython则将python代码编译成C环境的字节码。一般的在windows平台,都是使用CPython来编译python代码,而CPython就需要用到微软的C++编译环境。
微软的Visual C++编译器是和Visual Studio捆绑在一起的, VS2010对应的就是VC10环境,不同版本的python可能是用不同版本的Visual Studio编译。

部署步骤

  1. 确认VC版本和方案
  2. 安装Apache2.4-VC10-x64
  3. 将mod_wsgi添加进apache
  4. 在python中安装mod_wsgi包

1.确认VC版本和方案

mod_wsgi在Windows环境安装需要满足许多要求才能保证正常运行,具体可以看mod_wsgi的作者在github上的说明,具体来说就要满足4点:

  1. apache、mod_wsgi、python的版本必须同时是64位或者32位

  2. python版本是为所有用户安装的(这在安装python是一般是默认的)

  3. apache服务器的预编译二进制文件必须和安装的python版本使用相同的Microsoft Visual C++编译器版本编译(等同于VC10编译的python要对应安装VC10编译的apache)

  4. 使用经过相同版本VC编译器编译的mod_wsgi和python

python官方说明中,python和对应的VC版本是:

Visual C++ CPython
14.0 3.5, 3.6
10.0 3.3, 3.4
9.0 2.6, 2.7, 3.0, 3.1, 3.2

具体VC选择时,考虑到VC14的mod_wsgi需要手动编译,需要从github上下载了源码通过Visual Studio 2014编译,所以选择了编译好的VC10版本的mod_wsgi.so。确定了VC版本且windows系统是64位后,方案就确定了

python3.4 x64 + Apache2.4 VC10 x64 + mod-wsgi-py34-VC10

2.安装Apache2.4-VC10-x64

Apache Windows版本需要手动从源码编译,或者使用编译好的各种发行版,我选择了Apache Lounge distribution Apache 2.4 VC10下载。
安装Apache步骤:

  1. 解压httpd-2.4.23-win64.zip
  2. 参照ReadMe.txt操作
  3. 将文件夹Apache24移动到C盘根目录
  4. 环境变量PATH中添加C:\Apache24\bin
  5. 打开Apache配置文件C:\Apache24\conf\httpd.conf并添加: ServerName localhost:80(部署方案是在本机运行,如果是生产环境则需要改为特定IP地址)
  6. 打开命令行,输入httpd.exe -k install将apache添加进Service
  7. 可以打开windows的服务,找到Apache24来打开apache;或者通过apache自带的ApacheMonitor.exe来打开,位于C:\Apache24\bin

3. 将mod_wsgi添加进apache

下载mod_wsgi.so并解压

  1. 将解压得到的.so文件改名为mod_wsgo.so
  2. 复制文件到apache24目录下的modules文件夹内
  3. httpd.conf引入模块

LoadModule wsgi_module modules/mod_wsig.so

4.在python中安装mod_wsgi包

pip install mod_wsgi

安装mod_wsgi包,但是我安装时遇到错误:error: Microsoft Visual C++ 10.0 is required (Unable to find vcvarsall.bat).,可能是我电脑安装的是Visual Studio 2015的原因,默认不是用VC10编译环境。参照stackoverflow上的解答,成功安装,具体步骤是:

  1. 打开VS2015 命令提示行,输入set VS100COMNTOOLS=%VS140COMNTOOLS%
  2. 然后使用pip安装, pip instal mod_wsgi

成功安装后,按照github上提示在命令行使用mod_wsgi-express start-server打开apache服务器,但是在windows上,是没有start-server这条命令的,只限于在linux平台。
作者在Issues中给出了解答

On Windows mod_wsgi-express is only used to work out the configuration you need to add into your normal Apache instance. You then need to configure the normal Apache instance for your specific WSGI application and use normal method to start Apache. You can’t use mod_wsgi-express start-server on Windows.

因此在windows上还是使用常规方法启动apahce服务器。

5.创建Django项目来测试部署是否成功

按照Django官方教程创建一个简单的项目django-admin startproject mysite,然后创建一个简单的apppython manage.py startapp polls,在根据官方的教程在`httpd.conf中添加配置信息

1
2
3
4
5
6
7
8
9
10
11
WSGIScriptAlias / "C:/Apache24/djangoTest/mysite/mysite/wsgi.py"

WSGIPythonPath "C:/Apache24/djangoTest/mysite"

WSGIPythonHome "C:/Python34"

<Directory "C:/Apache24/djangoTest/mysite/mysite">
<Files wsgi.py>
Require all granted
</Files>
</Directory>

WSGIScriptAlias/为url的根地址,然后是使用双引号引用django项目的wsgi.py
WSGIPythonPath链接django的项目根目录
WSGIPythonHome链接对应python根目录

最后打开apache24服务,访问localhost是否成功,到此基本应该是成功的,出现打开失败,可以去Apache24/logs/error.log查看错误信息然后google解决

使用Virtualenv环境运行django app

django推荐使用virtualenv来创建web应用,好处就是不依赖外部python环境,减少其他模块对其的影响,而要配置在apache中沙箱模式又遇到了问题。
首先创建一个virtualenv,在project的父文件运行命令行

1
python -m venv myvenv

然后在激活venv(windows和linux的激活方式稍有不同)

1
myvenv\Scripts\activate

然后安装django。

httpd.conf中将WSGIPythonHome替换为

1
WSGIPythonHome "C:/Apache24/djangoTest/myvenv"

此时可能会启动失败,查看error.log

[Fri Feb 17 18:29:03.378723 2017] [wsgi:warn] [pid 6216:tid 160] mod_wsgi: Compiled for Python/3.4.2.
[Fri Feb 17 18:29:03.378723 2017] [wsgi:warn] [pid 6216:tid 160] mod_wsgi: Runtime using Python/3.4.3.
Fatal Python error: Py_Initialize: unable to load the file system codec
ImportError: No module named ‘encodings’
[Fri Feb 17 18:29:03.472323 2017] [mpm_winnt:crit] [pid 3480:tid 288] AH00419: master_main: create child process failed. Exiting.

参照简书上有人写的解决方案,在环境变量中新建一个变量PYTHONPATH,值设置为C:\Python34\DLLs;C:\Python34\Lib;C:\Python34\Lib\site-packages;,重新启动apache即可成功启动。

设置Apache访问静态文件

当访问localhost/admin页面时,发现只有纯文本的html,并没有django默认生成的js + css + fonts + img,查看页面确实也没有访问到这些静态文件。
Django官方给出的解决方案是不推荐开发模式下的静态文件访问方式使用在生产环境下。具体操作为:

  1. Project/Project/settings.py文件中添加STATIC_ROOT = 'static'(注意不要为/static, 否则会将静态文件夹移动到根目录,如C盘根目录)
  2. 在命令行中运行python manage.py collectstatic

这样就将静态文件移动到了Project目录下,如C:/Apache24/djangoTest/mysite/static,然后需要将次静态目录添加到Apache的配置文件中,在httpd.conf中添加

1
2
3
4
5
Alias /static "C:/Apache24/djangoTest/mysite/static"

<Directory "C:/Apache24/djangoTest/mysite/static">
Require all granted
</Directory>

值得注意的是Django官方给的配置是Alias /static/ "C:/Apache24/djangoTest/mysite/static",然而并没有起作用,要删除/后才成功访问。

总结在后

流水账的配置过程记完了,中间遇到了各种各样的问题,但通过强大的google和官方文档的支持,一步一步解决了,python web的部署果然还是有些麻烦。不得不感叹

PHP是最好的语言

------------ 本文已结束,感谢您的阅读,欢迎留言讨论 ------------