這幾天花了點時間,將把django開發好的web項目部署到Apache上,參考了官方的一些文檔和互聯網上的文檔,還是花了比較多的時間,這裡把配置的過程說一下。
方便有需要的朋友,可以參考,少走彎路!
1. django項目部署環境說明
操作系統 : 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已經安裝好,並且Django的項目已經開發好。
以上軟件包都是通過yum包安裝,軟件包都是系統標准目錄結構!
django開發好的項目目錄是 /var/www/html/server,項目目錄結構如下(標准django項目目錄結構)
?
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 `-- view2. 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使用的標准配置,Apache的DocumentRoot 指向的是 /var/www/html 目錄
3. 新建django.wsgi文件
在項目目錄/var/www/html/server下新建一個django.wsgi,文件內容如下:
?
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目錄,確保運行apache的用戶,能夠對此目錄有讀寫權限.
第五,六行 將當前目錄自動加入到python的搜索路徑,如果項目中有自己寫的模塊,方便使用和發布
最後,這個django.wsgi文件名可以隨便取,例如test.wsgi、app.wsgi等等,但是一定要與/etc/httpd/conf.d/wsgi.conf配置文件中配置保持一致。
如果您這裡新建的文件名不是django.wsgi而是test.wsgi,那麼/etc/httpd/conf.d/wsgi.conf中的配置就應該修改為
?
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",)注意: 模板目錄在這裡一定要用絕對路勁,而不能用相對路徑,當然也有方法動態設置模板路勁
PS:關於mod_wsgi
目前mod_wsgi有兩種工作模式:
第一種是嵌入模式,類似於mod_python,直接在apache進程中運行,這樣的好處是不需要另外增加進程,但是壞處也很明顯,所有內存都和apache共享,如果和mod_python一樣造成內存漏洞的話,就會危害整個apache。而且如果apache是用worker mpm,mod_wsgi也就強制進入了線程模式,這樣子對於非線程安全的程序來說就沒法用了。
這種模式下需要在apache的vhost中如下設置:
?
1 <span style="font-family: 'times new roman', times;">WSGIScriptAlias /path /path-to-wsgi</span>即可生效,對於小型腳本的話,直接用這種模式即可。
第二種是後台模式,類似於FastCGI的後台,mod_wsgi會借apache的外殼,另外啟動一個或多個進程,然後通過socket通信和apache的進程聯系。
這種方式只要使用以下配置即可:
?
1 2 3 4 5 6 7 8 9 10 #啟動WSGI後台,site1是後台名字 WSGIDaemonProcess site1 processes=1 threads=15 display-name=%{GROUP} #分配當前上下文應該使用哪個WSGI後台,可以放在Location裡面指定 WSGIProcessGroup site1 #根據當前上下文的ProcessGroup分配到對應的後台 WSGIScriptAlias /path /path-to-wsgi在這種模式下,我們可以通過調節processes和threads的值來設置三種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 Trueworker模式
?
1 2 3 4 WSGIDaemonProcess example processes=2 threads=25 wsgi.multithread True wsgi.multiprocess Truepreforker模式
?
1 2 3 WSGIDaemonProcess example processes=5 threads=1 wsgi.multithread False wsgi.multiprocess True後台模式由於是與apache進程分離了,內存獨立,而且可以獨立重啟,不會影響apache的進程,如果你有多個項目(django),可以選擇建立多個後台或者共同使用一個後台。
比如在同一個VirtualHost裡面,不同的path對應不同的django項目,可以同時使用一個Daemon:
?
1 2 3 4 5 6 7 <span style="font-family: 'times new roman', times;">WSGIDaemonProcess default processes=1 threads=1 display-name=%{GROUP} WSGIProcessGroup default WSGIScriptAlias /project1 “/home/website/project1.wsgi” WSGIScriptAlias /project2 “/home/website/project2.wsgi”</span>這樣子兩個django都使用同一個WSGI後台。
也可以把不同的項目分開,分開使用不同的後台,這樣開銷比較大,但就不會耦合在一起了。
display-name是後台進程的名字,這樣方便重啟對應的進程,而不需要全部殺掉。
?
1 2 3 4 5 6 7 8 9 10 11 12 13 <span style="font-family: 'times new roman', times;">WSGIDaemonProcess site1 processes=1 threads=1 display-name=%{GROUP} WSGIDaemonProcess site2 processes=1 threads=1 display-name=%{GROUP} <Location “/project1″> WSGIProcessGroup site1 </Location> WSGIScriptAlias /project1 “/home/website/project1.wsgi” <Location “/project1″> WSGIProcessGroup site2 </Location> WSGIScriptAlias /project2 “/home/website/project2.wsgi”</span>對於django 1.0以下的版本,由於官方認定不是線程安全的,所以建議使用多進程單線程模式
?
1 processes=n threads=1對於django 1.0以後,就可以放心的使用多進程多線程模式:
?
1 processes=2 threads=64這樣子性能會更好。