django是一款基于python语言的WEB开源框架,本文给出了如何将基于django写的python网站部署到window的IIS上。
笔者的运行环境:
- Window xp sp3
- IIS 5.1
- Python 2.7.2 (http://www.python.org/)
- pywin32-217.win32-py2.7 (python的win32扩展)
- Django-1.3.1 (https://www.djangoproject.com/)
- isapi_wsgi-0.4.2-py2.5 (http://code.google.com/p/isapi-wsgi/ ,基于IIS的ISAPI扩展的WSGI实现).
- setuptools-0.6c11.win32-py2.7
原理解释:
IIS通过ISAPI可以扩展支持其他语言实现的WEB应用,isapi_wsgi-0.4.2-py2.5这个程序作为ISAPI实现了WSGI规范,
WSGI规范是作为python web应用与web服务容器之间的接口规范,通过这个程序,对IIS的某个虚拟站点的请求就可以定向
到这个ISAPI去处理,而无需为了去部署到某个特定容器里而去改动python web的任何代码。
步骤
- 先安装好IIS, Python, Django, setuptools, pywin32, 这些很简单。(将环境变量PATH里加入python的安装主目录)
- 下载isapi_wsgi-0.4.2-py2.5.egg文件 (这是python里的一种安装包,类似于Red Hat的RPM,当然你也可以下载exe或zip下载安装)
- 下载后,在命令行窗口输入:easy_install isapi_wsgi-0.4.2-py2.5.egg (这里它会提示你安装成功,注意:必须安装setuptools才能运行该命令)
- 写一个部署脚本,名字假定为wsgi_deploy.py (假定你的web project 目录为 C:\Web, 在Web目录下有一个App为mysite) ,目录一定不要弄错,否则容易出现HTTP 500错误。
import os, sys sys.path.append(‘C:\\Web‘) os.environ[‘DJANGO_SETTINGS_MODULE‘] = ‘mysite.settings‘
import django.core.handlers.wsgi application = django.core.handlers.wsgi.WSGIHandler()
import isapi_wsgi # The entry points for the ISAPI extension. def __ExtensionFactory__(): return isapi_wsgi.ISAPISimpleHandler(application)
if __name__==‘__main__‘: # If run from the command-line, install ourselves. from isapi.install import * params = ISAPIParameters() # Setup the virtual directories - this is a list of directories our # extension uses - in this case only 1. # Each extension has a "script map" - this is the mapping of ISAPI # extensions. sm = [ ScriptMapParams(Extension="*", Flags=0) ] vd = VirtualDirParameters(Name="mysite", Description = "ISAPI-WSGI ISAPISimpleHandler Django mysite", ScriptMaps = sm, ScriptMapUpdate = "replace" ) params.VirtualDirs = [vd] HandleCommandLine(params)
5. 在命令行输入: wsgi_deploy.py install ,运行之后会在IIS上创建上面脚本定义的虚拟路径"mysite", 同时你会发现一个‘_wsgi_deploy.dll‘文件会创建出来,这个就是ISAPI。
细心的读者不妨在IIS的"mysite“的设置里去查看下就明白了。
6.部署后,既可以通过浏览器访问你的Web App了
注:如果出现错误,如何处理?
可以在命令行输入: python -m win32traceutil 便可以输出isapi_wsgi模块输出的错误堆栈信息
通常错误都是出现在路径方面。如类似于
ImportError: Could not import settings ‘mysite.settings‘ (Is it on sys.path?): N o module named mysite.settings 这样的问题。
这样的情况,需要去找到上述的部署脚本wsgi_deploy.py,去修改为正确的配置,然后记住需要先运行
wsgi_deploy.py remove后再运行wsgi_deploy.py install。
参考:http://code.google.com/p/isapi-wsgi/