在Apache上部署Django项目

发表于 更新于 阅读次数： 阅读次数：

0.概述

Django是一个基于Python的web开发框架，在实际生产环境中部署的时候，还需要用Apache容器来部署。这里记录下如何在Debian系统中用Aapche和mod_wsgi模块来部署Django项目。

1.系统信息

1
2
3
4
5
6
7
8
9
10
11
$ uname -a  
Linux iZ284ov0vfwZ 3.2.0-4-amd64 #1 SMP Debian 3.2.81-1 x86_64 GNU/Linux  
$ lsb_release -a  
No LSB modules are available.  
Distributor ID: Debian  
Description:    Debian GNU/Linux 7.11 (wheezy) 
Release:        7.11  
Codename:       wheezy  
$ sudo apachectl -v  
Server version: Apache/2.2.22 (Debian)  
Server built:   Aug 18 2015 09:49:50

我用的是Debian发行版，Apache的配置与别的发行版有较大不同，这里以Debian为例进行说明，别的发行版需要进行一定的修改。

2. 安装Django和Apache

Django可以通过如下命令安装:

1
sudo pip install Django==1.9.0 #设置版本号为1.9.0

Apache通过不同发行版的包管理命令安装。在debian下，是:

1
sudo apt-get install apache2

3. 安装mod_wsgi模块

mod_wsgi可以通过pip安装，但是需要提前在系统安装apache-dev包，但是在Debian发行版上，这个包名叫apache2-prefork-dev，详情参考这里。通过如下命令安装

1
sudo apt-get install apache2-prefork-dev

此外，还需要安装python-dev包，如果要使用python3,则需要安装python3-dev包：

1
2
3
sudo apt-get install python-dev
# 如果要使用python3，则安装如下包
#sudo apt-get install python3-dev

然后pip 安装mod_wsgi:

1
sudo pip install mod_wsgi

此外也可以自己编译mod_wsgi：首先从这里下载文件包，然后解压，编译。假设版本是4.5.3，全部命令如下:

1
2
3
4
5
6
wget https://github.com/GrahamDumpleton/mod_wsgi/archive/4.5.3.tar.gz  
tar -xvf 4.5.3.tar.gz  
cd mod_wsgi-4.5.3  
./configure  
make  
sudo make install

如果要使用python3,则./configure那条命令改为./configure --with-python=/usr/bin/python3.4。
如果没有报错，那么mod_wsgi就编译好了!
编译好后，会在apache的模块目录/usr/lib/apache2/modules/生成mod_wsgi.so文件。

4.Apache配置文件目录结构

Apache的配置文件目录是/etc/apache2，该目录下的文件结构如下：

1
2
3
4
5
6
7
8
9
10
11
12
.
|-- apache2.conf
|-- conf-available
|-- conf-enabled
|-- envvars
|-- magic
|-- mods-available
|-- mods-enabled
|-- ports.conf
|-- sites-available
`-- sites-enabled

其中apache2.conf是主配置文件，里面包括系统的设置，如Timeout的时长、Log的等级和格式等。ports.conf文件配置了监听的端口号，以及是否启用SSL。envvars和magic里面设置了一些环境变量相关的东西，我没怎么看过。
剩下的6个目录两两一对，availabel文件夹里面是所有的配置，而enabled目录里面则是启用的配置。而conf、mods和sites可以分别通过命令a2enconf、a2enmod、a2ensite来启用，启用后会在enabled目录下生成一个软链接，指向available目录下的同名文件。
在apache2.conf这个文件最后，是一些IncludeOptional 语句，用来将conf-enabled、mods-enabled、sites-enabled目录下的配置文件包含到主配置文件中。这样的好处是每个配置文件配置一个条目，比较清晰明了,易于查错。

5. 启用wsgi模块

我们需要在mods-available目录下新建mod_wsgi的load文件，具体操作如下:

1
2
3
4
cd /etc/apache2/mod-available  
sudo echo " LoadModule wsgi_module /usr/lib/apache2/modules/mod_wsgi.so" >> wsgi.load  
sudo a2enmod wsgi # 启用wgsi配置
sudo service apache2 restart # 重启Apache2服务

6. 托管Django站点

假设Django项目的wsgi.py文件的路径是/home/yunfeng/Dev/git/mysite/mysite/wsgi.py，我们需要下面几步来完成Apache对Django项目的托管：

1. 修改Django项目中的wsgi.py和settings.py文件

修改wsgi.py文件，增加如代码中说明的那几行：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
"""                                                                                                                                                           
WSGI config for travel_record project.                                                                                                                        
                                                                                                                                                              
It exposes the WSGI callable as a module-level variable named ``application``.                                                                                
                                                                                                                                                              
For more information on this file, see                                                                                                                        
https://docs.djangoproject.com/en/1.9/howto/deployment/wsgi/                                                                                                  
"""                                                                                                                                                           

import os                                                                                                                                                     

## 增加下面这几行
import sys                                                                                                                                                    
from os.path import dirname, abspath                                                                                                                    
from django.core.wsgi import get_wsgi_application                                                                                                             
PROJECT_DIR = dirname(dirname(abspath(__file__)))                                                                                                             
sys.path.insert(0, PROJECT_DIR)                                                                                                                               
                                                                                                                                                              
#os.environ.setdefault("DJANGO_SETTINGS_MODULE", "travel_record.settings")                                                                                    
os.environ["DJANGO_SETTINGS_MODULE"] = "travel_record.settings"                                                                                               
## 增加结束
                                                                                                                                                              
application = get_wsgi_application()

增加的这几行代码做了2件事：1.将Django项目的的路径加入到系统路径中，使得Apache服务器可以找到wsgi.py文件；2. 修改os.environ的值，使得多个Django项目同时被Apache托管的时候不会出现串扰的问题。
接下来修改settings.py文件，主要修改的地方有3个：

  1. 将DEBUG=True改为DEBUG=False
  2. 将ALLOWEND_HOSTS里面写上服务器的访问域名或IP地址
  3. 将TEMPALTES中的DIRS改写成指向模板目录的绝对路径
    Django项目里面需要修改的就这2个文件，下面的内容都是在/etc/apache2目录下进行操作。

2. 在/etc/apache2/sites-available目录下增加网站的配置文件

参照该目录下的000-default.conf和Django的教程，写出配置文件mysite.conf如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
  <VirtualHost *:8000>                                                                                                                                         
    ErrorLog ${APACHE_LOG_DIR}/error.log                                                                                                                      
    CustomLog ${APACHE_LOG_DIR}/access.log combined                                                                                                           
                                                                                                                                                              
    WSGIScriptAlias / /home/yunfeng/Dev/git/mysite/mysite/wsgi.py                                                                               

    Alias /static/ /home/yunfeng/Dev/git/mysite/mysite/static/                                                                                  
    Alias /media/ /home/yunfeng/Dev/git/mysite/mysite/media/                                                                                  

    <Directory /home/yunfeng/Dev/git/mysite/mysite>                                                                                             
        <Files wsgi.py>                                                                                                                                       
    		Order deny,allow  
    		Allow from all  
        </Files>                                                                                                                                              
    </Directory>                                                                                                                                              

    <Directory /home/yunfeng/Dev/git/mysite/mysite/static/>                                                                                     
    	Order deny,allow  
    	Allow from all  
    </Directory>                                                                                                                                              
	
    <Directory /home/yunfeng/Dev/git/mysite/mysite/static/>                                                                                     
    	Order deny,allow  
    	Allow from all  
    </Directory>                                                                                                                                              
</VirtualHost>

整个配置文件是包含在VirtualHost的尖括号里面的一些设置，尖括号开始的地方，*:8000表示你希望的项目监听的端口号。
ErrorLog和CustomLog设置错误日志和访问日志的路径和格式。
WSGIScriptAlias设置wsgi文件的路径，Alias语句托管网站的static和media目录。
然后是<Directory>标签，用来设置文件和目录的访问权限。注意对于版本小于2.4的Apache，需要将<Directory>标签中的Order deny,allow和Allow from all改为Require all granted。
修改完后，执行下面的命令启用这个网站:

1
sudo a2ensite mysite.conf

3. 修改/etc/apache2目录下的ports.conf文件

增加针对新建站点的端口号的监听：

1
2
3
Listen 80
#增加下面这条语句
Listen 8000

执行完这3个步骤后，就可以重启Apache服务器，访问站点了：

1
sudo service apache2 restart

访问站点，如果出现错误的话，可以在Django项目的settings.py中启用DEBUG模式，查看输出，进行相应的修改。