這幾天花了點(diǎn)時間,將把django開發(fā)好的web項目部署到Apache上,參考了官方的一些文檔和互聯(lián)網(wǎng)上的文檔,還是花了比較多的時間,這里把配置的過程說一下。
方便有需要的朋友,可以參考,少走彎路!
1. django項目部署環(huán)境說明
操作系統(tǒng) : Red Hat Enterprise Linux Server release 5.3 (Tikanga) x86_64
apache版本 : httpd-2.2.3-22.el5
mod_wsgi版本 : mod_wsgi-3.2-1.el5 fedora epel可以下載
Django版本 : 1.2.3
python 版本 : 2.5
這里假定Django和Apache已經(jīng)安裝好,并且Django的項目已經(jīng)開發(fā)好。
以上軟件包都是通過yum包安裝,軟件包都是系統(tǒng)標(biāo)準(zhǔn)目錄結(jié)構(gòu)!
django開發(fā)好的項目目錄是 /var/www/html/server,項目目錄結(jié)構(gòu)如下(標(biāo)準(zhǔn)django項目目錄結(jié)構(gòu))
?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
#tree -d server/
server/
|-- __init__.py
|-- manage.py
|-- settings.py
|-- backend
|-- static
| |-- images
| |-- locale
| |-- plugins
| `-- themes
| |-- default
| | `-- images
| |-- gray
| | `-- images
| `-- icons
|-- template
`-- view
2. Apache和mod_wsgi配置
修改wsgi配置(/etc/httpd/conf.d/wsgi.conf)
?
1
2
3
4
5
6
7
8
#cat /etc/httpd/conf.d/wsgi.conf
LoadModule wsgi_module modules/mod_wsgi.so
WSGIScriptAlias / "/var/www/html/server/django.wsgi"
<Directory "/var/www/html/server">
Order Deny,Allow
Allow from all
</Directory>
項目目錄中的django.wsgi這個文件是需要新建的,后面會說到如何新建這個文件。
apache使用的標(biāo)準(zhǔn)配置,Apache的DocumentRoot 指向的是 /var/www/html 目錄
3. 新建django.wsgi文件
在項目目錄/var/www/html/server下新建一個django.wsgi,文件內(nèi)容如下:
?
1
2
3
4
5
6
7
8
9
10
#cat /var/www/html/server/django.wsgi
# -*- coding: utf-8 -*-
import os
import sys
os.environ['DJANGO_SETTINGS_MODULE'] = 'settings'
os.environ['PYTHON_EGG_CACHE'] = '/tmp/.python-eggs'
current_dir = os.path.dirname(__file__)
if current_dir not in sys.path: sys.path.append(current_dir)
import django.core.handlers.wsgi
application = django.core.handlers.wsgi.WSGIHandler()
第三行 os.environ['DJANGO_SETTINGS_MODULE'] = 'settings' ,這個settings就是指項目目錄下的setting.py文件.
第四行 os.environ['PYTHON_EGG_CACHE'] = '/tmp/.python-eggs' ,指定解壓egg文件的cache目錄,確保運(yùn)行apache的用戶,能夠?qū)Υ四夸浻凶x寫權(quán)限.
第五,六行 將當(dāng)前目錄自動加入到python的搜索路徑,如果項目中有自己寫的模塊,方便使用和發(fā)布
最后,這個django.wsgi文件名可以隨便取,例如test.wsgi、app.wsgi等等,但是一定要與/etc/httpd/conf.d/wsgi.conf配置文件中配置保持一致。
如果您這里新建的文件名不是django.wsgi而是test.wsgi,那么/etc/httpd/conf.d/wsgi.conf中的配置就應(yīng)該修改為
?
1
WSGIScriptAlias / "/var/www/html/server/test.wsgi"
4. 修改django項目中的setting.py文件
找到項目目錄下的setting.py,對于這里就是/var/www/html/server/setting.py。找到其中的TEMPLATE_DIRS,修改為:
?
1
TEMPLATE_DIRS = ("/var/www/html/server/template",)
注意: 模板目錄在這里一定要用絕對路勁,而不能用相對路徑,當(dāng)然也有方法動態(tài)設(shè)置模板路勁
PS:關(guān)于mod_wsgi
目前mod_wsgi有兩種工作模式:
第一種是嵌入模式,類似于mod_python,直接在apache進(jìn)程中運(yùn)行,這樣的好處是不需要另外增加進(jìn)程,但是壞處也很明顯,所有內(nèi)存都和apache共享,如果和mod_python一樣造成內(nèi)存漏洞的話,就會危害整個apache。而且如果apache是用worker mpm,mod_wsgi也就強(qiáng)制進(jìn)入了線程模式,這樣子對于非線程安全的程序來說就沒法用了。
這種模式下需要在apache的vhost中如下設(shè)置:
?
1
<span style="font-family: 'times new roman', times;">WSGIScriptAlias /path /path-to-wsgi</span>
即可生效,對于小型腳本的話,直接用這種模式即可。
第二種是后臺模式,類似于FastCGI的后臺,mod_wsgi會借apache的外殼,另外啟動一個或多個進(jìn)程,然后通過socket通信和apache的進(jìn)程聯(lián)系。
這種方式只要使用以下配置即可:
?
1
2
3
4
5
6
7
8
9
10
#啟動WSGI后臺,site1是后臺名字
WSGIDaemonProcess site1 processes=1 threads=15 display-name=%{GROUP}
#分配當(dāng)前上下文應(yīng)該使用哪個WSGI后臺,可以放在Location里面指定
WSGIProcessGroup site1
#根據(jù)當(dāng)前上下文的ProcessGroup分配到對應(yīng)的后臺
WSGIScriptAlias /path /path-to-wsgi
在這種模式下,我們可以通過調(diào)節(jié)processes和threads的值來設(shè)置三種MPM的模式:prefork', 'worker', 'winnt'。
winnt模式
?
1
2
3
WSGIDaemonProcess example threads=25
wsgi.multithread True
wsgi.multiprocess False
此時processes=1,但是multiprocess為false
如果顯式地指出processes為1那么:
?
1
2
3
WSGIDaemonProcess example processes=1 threads=25
wsgi.multithread True
wsgi.multiprocess True
worker模式
?
1
2
3
4
WSGIDaemonProcess example processes=2 threads=25
wsgi.multithread True
wsgi.multiprocess True
preforker模式
?
1
2
3
WSGIDaemonProcess example processes=5 threads=1
wsgi.multithread False
wsgi.multiprocess True